DtSetAppId(3Dt)                                      DtSetAppId(3Dt)


       NAME
             DtSetAppId - establish an ID for an application

       SYNOPSIS
             #include <Dt/Desktop.h>
             Window DtSetAppId(Display *dpy, Window owner, char *id);

       DESCRIPTION
             The DtSetAppId function establishes and ID for an application,
             where

                   dpy   is the Display pointer

                   owner is the intended owner of the ID, and

                   id    is the named ID.

             DtSetAppId first checks if an owner already exists for the
             named ID.  Note that the check and ownership assertion is
             performed as one atomic operation.

             Once an ownership is asserted, other clients can communicate
             with the owner by performing a Selection conversion on the ID
             [see XtGetSelectionValue(Xt)] or send a simulated drop message
             [see DtNewDnDTransaction(3Dt)].

       RETURN VALUES
             DtSetAppId returns the window ID of the current owner if an
             owner already exists for the named ID, or ``None'' and
             ownership of the named ID is ensured.

       REFERENCES
             DtGetAppId(3Dt), DtNewDnDTransaction(3Dt)















                           Copyright 1994 Novell, Inc.               Page 1