Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XSetCommand(3)			XLIB FUNCTIONS			XSetCommand(3)

NAME
       XSetCommand, XGetCommand	- set or read a	window's WM_COMMAND property

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

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

ARGUMENTS
       argc	 Specifies the number of arguments.

       argc_return
		 Returns the number of arguments returned.

       argv	 Specifies the application's argument list.

       argv_return
		 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 WM_COMMAND property from the	speci-
       fied window and returns a string	list.  If the WM_COMMAND property  ex-
       ists,  it  is of	type STRING and	format 8.  If sufficient memory	can be
       allocated to contain the	string list, XGetCommand fills in the argv_re-
       turn  and  argc_return  arguments and returns a nonzero status.	Other-
       wise, or	if any other error is encountered, 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 implementation-dependent.  To free
       the memory allocated to the string list,	use XFreeStringList.

PROPERTIES
       WM_COMMAND
		 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 Window.

SEE ALSO
       XAllocClassHint(3),   XAllocIconSize(3),	   XAllocSizeHints(3),	  XAl-
       locWMHints(3),  XSetTransientForHint(3),	 XSetTextProperty(3),  XSetWM-
       ClientMachine(3), XSetWMColormapWindows(3), XSetWMIconName(3),  XSetWM-
       Name(3),	   XSetWMProperties(3),	  XSetWMProtocols(3),	XStringListTo-
       TextProperty(3)
       Xlib - C	Language X Interface

X Version 11			 libX11	1.6.12			XSetCommand(3)

NAME | SYNTAX | ARGUMENTS | DESCRIPTION | PROPERTIES | DIAGNOSTICS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XSetCommand&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help