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

FreeBSD Manual Pages


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

       XSetTextProperty, XGetTextProperty - set	and read text properties

       void XSetTextProperty(Display *display, Window w, XTextProperty
	      *text_prop, Atom property);

       Status XGetTextProperty(Display *display, Window	w, XTextProperty
	      *text_prop_return, Atom property);

       display	 Specifies the connection to the X server.

       property	 Specifies the property	name.

       text_prop Specifies the XTextProperty structure to be used.

		 Returns the XTextProperty structure.

       The XSetTextProperty function replaces the existing specified property
       for the named window with the data, type, format, and number of items
       determined by the value field, the encoding field, the format field,
       and the nitems field, respectively, of the specified XTextProperty
       structure.  If the property does	not already exist, XSetTextProperty
       sets it for the specified window.

       XSetTextProperty	can generate BadAlloc, BadAtom,	BadValue, and BadWin-
       dow errors.

       The XGetTextProperty function reads the specified property from the
       window and stores the data in the returned XTextProperty	structure.  It
       stores the data in the value field, the type of the data	in the encod-
       ing field, the format of	the data in the	format field, and the number
       of items	of data	in the nitems field.  An extra byte containing null
       (which is not included in the nitems member) is stored at the end of
       the value field of text_prop_return.  The particular interpretation of
       the property's encoding and data	as text	is left	to the calling appli-
       cation.	If the specified property does not exist on the	window,	XGet-
       TextProperty sets the value field to NULL, the encoding field to	None,
       the format field	to zero, and the nitems	field to zero.

       If it was able to read and store	the data in the	XTextProperty struc-
       ture, XGetTextProperty returns a	nonzero	status;	otherwise, it returns
       a zero status.

       XGetTextProperty	can generate BadAtom and BadWindow errors.

		 The string name of the	machine	on which the client applica-
		 tion is running.

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

		 The name to be	used in	an icon.

       WM_NAME	 The name of the application.

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

       BadAtom	 A value for an	Atom argument does not name a defined Atom.

       BadValue	 Some numeric value falls outside the range of values accepted
		 by the	request.  Unless a specific range is specified for an
		 argument, the full range defined by the argument's type is
		 accepted.  Any	argument defined as a set of alternatives can
		 generate this error.

       BadWindow A value for a Window argument does not	name a defined Window.

       XAllocClassHint(3), XAllocIconSize(3), XAllocSizeHints(3), XAl-
       locWMHints(3), XSetCommand(3), XSetTransientForHint(3), XSetWMClientMa-
       chine(3), XSetWMColormapWindows(3), XSetWMIconName(3), XSetWMName(3),
       XSetWMProperties(3), XSetWMProtocols(3),	XStringListToTextProperty(3)
       Xlib - C	Language X Interface

X Version 11			 libX11	1.6.5		   XSetTextProperty(3)


Want to link to this manual page? Use this URL:

home | help