XSetWMName
NAMESYNTAX
ARGUMENTS
DESCRIPTION
PROPERTIES
DIAGNOSTICS
SEE ALSO
NAME
XSetWMName, XGetWMName, XStoreName, XFetchName − set or read a window’s WM_NAME property
SYNTAX
|
void XSetWMName(Display *display, Window w, XTextProperty *text_prop); | |
|
Status XGetWMName(Display *display, Window w, XTextProperty *text_prop_return); | |
|
int XStoreName(Display *display, Window w, char *window_name); | |
|
Status XFetchName(Display *display, Window w, char **window_name_return); |
ARGUMENTS
|
display |
Specifies the connection to the X server. | ||
|
text_prop |
Specifies the XTextProperty structure to be used. |
text_prop_return
Returns the XTextProperty structure.
|
w |
Specifies the window. |
window_name
Specifies the window name, which should be a null-terminated string.
window_name_return
Returns the window name, which is a null-terminated string.
DESCRIPTION
The XSetWMName convenience function calls XSetTextProperty to set the WM_NAME property.
The XGetWMName convenience function calls XGetTextProperty to obtain the WM_NAME property. It returns a nonzero status on success; otherwise, it returns a zero status.
The XStoreName function assigns the name passed to window_name to the specified window. A window manager can display the window name in some prominent place, such as the title bar, to allow users to identify windows easily. Some window managers may display a window’s name in the window’s icon, although they are encouraged to use the window’s icon name if one is provided by the application. If the string is not in the Host Portable Character Encoding, the result is implementation-dependent.
XStoreName can generate BadAlloc and BadWindow errors.
The XFetchName function returns the name of the specified window. If it succeeds, it returns a nonzero status; otherwise, no name has been set for the window, and it returns zero. If the WM_NAME property has not been set for this window, XFetchName sets window_name_return to NULL. If the data returned by the server is in the Latin Portable Character Encoding, then the returned string is in the Host Portable Character Encoding. Otherwise, the result is implementation-dependent. When finished with it, a client must free the window name string using XFree.
XFetchName can generate a BadWindow error.
PROPERTIES
|
WM_NAME |
The name of 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), XAllocWMHints(3),
XFree(3), XSetCommand(3), XSetTransientForHint(3),
XSetTextProperty(3), XSetWMClientMachine(3),
XSetWMColormapWindows(3), XSetWMIconName(3),
XSetWMProperties(3), XSetWMProtocols(3),
XStringListToTextProperty(3)
Xlib − C Language X Interface
More Linux Commands
manpages/smoltGui.1.html
smoltGui(1) - GUI for Smolt hardware profile submission.....
smoltGui is a graphical user interface that can be used to submit Smolt hardware profiles to a Smoon server. Smolt is a cross-desktop hardware reporting tool fo
manpages/XTranslateCoordinates.3.html
XTranslateCoordinates(3) - translate window coordinates.....
If XTranslateCoordinates returns True, it takes the src_x and src_y coordinates relative to the source windows origin and returns these coordinates to dest_x_re
manpages/glRasterPos4s.3gl.html
glRasterPos4s(3gl) - specify the raster position for pixel o
The GL maintains a 3D position in window coordinates. This position, called the raster position, is used to position pixel and bitmap write operations. It is ma
manpages/Tk_SetWindowVisual.3.html
Tk_SetWindowVisual(3) - change visual characteristics of win
When Tk creates a new window it assigns it the default visual characteristics (visual, depth, and colormap) for its screen. Tk_SetWindowVisual may be called to
manpages/Tcl_JoinPath.3.html
Tcl_JoinPath(3) - manipulate platform-dependent file paths
These procedures have been superceded by the objectified procedures in the FileSystem man page, which are more efficient. These procedures may be used to disass
manpages/cdrecord.1.html
cdrecord(1) - write data to optical disk media (Man Page)...
wodim is used to record data or audio Compact Discs on an Orange Book CD-Recorder or to write DVD media on a DVD-Recorder. The device is the device file or labe
manpages/XmbTextExtents.3.html
XmbTextExtents(3) - compute text extents - Linux man page...
The XmbTextExtents, XwcTextExtents and Xutf8TextExtents functions set the components of the specified overall_ink_return and overall_logical_return arguments to
manpages/plipconfig.8.html
plipconfig(8) - fine tune PLIP device parameters (Man Page)
Plipconfig is used to (hopefully) improve PLIP performance by changing the default timing parameters used by the PLIP protocol. Results are dependent on the par
manpages/glutKeyboardUpFunc.3.html
glutKeyboardUpFunc(3) - sets the keyboard up (key release) c
glutKeyboardFunc sets the keyboard up (key release) callback for the current window. When a user types into the window, each key release matching an ASCII chara
manpages/systemd-machined.service.8.html
systemd-machined.service(8) Virtual machine and container re
systemd-machined is a system service that keeps track of virtual machines and containers, and processes belonging to them. See systemd-nspawn(1) for some exampl
manpages/ntfscp.8.html
ntfscp(8) - copy file to an NTFS volume. - Linux man page...
ntfscp will copy file to an NTFS volume. destination can be either file or directory. In case if destination is directory specified by name then source_file is
manpages/git-whatchanged.1.html
git-whatchanged(1) - Show logs with difference each commit i
Shows commit logs and diff output each commit introduces. New users are encouraged to use git-log(1) instead. The whatchanged command is essentially the same as
