XSetCommand(XS)   X Version 11 (Release 5) 6 January 1993    XSetCommand(XS)


 Name

    XSetCommand - set or read a window's WM_COMMAND property

 Syntax


    XSetCommand(display, w, argv, argc)
          Display *display;
          Window w;
          char **argv;
          int argc;

    Status XGetCommand(display, w, argv_return, argc_return)
          Display *display;
          Window w;
          char ***argv_return;
          int *argc_return;


 Arguments


    argc         Specifies the number of arguments.

    argcreturn  Returns the number of arguments returned.

    argv         Specifies the application's argument list.

    argvreturn  Returns the application's argument list.

    display      Specifies the connection to the X server.

    w            Specifies the window.

 Description

    The XSetCommand function sets the command and arguments used to invoke
    the application.  (Typically, argv is the argv array of your main pro-
    gram.)  If the strings are not in the Host Portable Character Encoding
    the result is implementation dependent.

    XSetCommand can generate ``BadAlloc'' and ``BadWindow'' errors.

    The XGetCommand function reads the WMCOMMAND property from the specified
    window and returns a string list.  If the WMCOMMAND property exists, it
    is of type STRING and format 8.  If sufficient memory can be allocated to
    contain the string list, XGetCommand fills in the argvreturn and
    argcreturn arguments and returns a nonzero status.  Otherwise, it
    returns a zero status.  If the data returned by the server is in the
    Latin Portable Character Encoding, then the returned strings are in the
    Host Portable Character Encoding.  Otherwise, the result is implementa-
    tion dependent.  To free the memory allocated to the string list, use
    XFreeStringList.

 Properties


    WMCOMMAND     The command and arguments, null-separated, used to invoke
                   the application.

 Diagnostics


    ``BadAlloc''   The server failed to allocate the requested resource or
                   server memory.

    ``BadWindow''  A value for a Window argument does not name a defined Win-
                   dow.

 See also

    XAllocClassHint(XS), XAllocIconSize(XS), XAllocSizeHints(XS),
    XAllocWMHints(XS), XSetTransientForHint(XS), XSetTextProperty(XS),
    XSetWMClientMachine(XS), XSetWMColormapWindows(XS), XSetWMIconName(XS),
    XSetWMName(XS), XSetWMProperties(XS), XSetWMProtocols(XS),
    XStringListToTextProperty(XS)
    Xlib - C Language X Interface