📄 xsetwmproperties.html
字号:
<HTML><HEAD><TITLE>Xlib Programming Manual: XSetWMProperties</TITLE></HEAD><BODY><H1 ALIGN=center>XSetWMProperties</H1><H2>Syntax</H2><!.IN "XSetWMProperties" "" "@DEF@"><CODE><PRE>void XSetWMProperties(<B>display</B>, <B>w</B>, <B>window_name</B>, <B>icon_name</B>, <B>argv</B>, <B>argc</B>, <B>normal_hints</B>, <B>wm_hints</B>, <B>class_hints</B>) <A HREF="../../display/opening.html#Display">Display</A> *<B>display</B>; Window <B>w</B>; <A HREF="converting-string-lists.html">XTextProperty</A> *<B>window_name</B>; <A HREF="converting-string-lists.html">XTextProperty</A> *<B>icon_name</B>; char **<B>argv</B>; int <B>argc</B>; <A HREF="wm-normal-hints.html#XSizeHints">XSizeHints</A> *<B>normal_hints</B>; <B><A HREF="wm-hints.html#XWMHints">XWMHints</A></B> *<B>wm_hints</B>; <A HREF="wm-class.html#XClassHint">XClassHint</A> *<B>class_hints</B>;</PRE></CODE><H2>Arguments</H2><TABLE><TR><TD> <B>display</B><TD> Specifies the connection to the X server.<TR><TD> <B>w</B><TD> Specifies the window.<TR><TD> <B>window_name</B><TD> Specifies the window name,which should be a null-terminated string.<TR><TD> <B>icon_name</B><TD> Specifies the icon name,which should be a null-terminated string.<TR><TD> <B>argv</B><TD> Specifies the application's argument list.<TR><TD> <B>argc</B><TD> Specifies the number of arguments.<TR><TD> <B>normal_hints</B><TD> Specifies the size hints for the window in its normal state.<TR><TD> <B>wm_hints</B><TD> Specifies the<B><A HREF="wm-hints.html#XWMHints">XWMHints</A></B>structure to be used.<TR><TD> <B>class_hints</B><TD> Specifies the<A HREF="wm-class.html#XClassHint">XClassHint</A>structure to be used.</TABLE><H2>Description</H2>The <B>XSetWMProperties()</B>convenience function provides a single programming interface for setting those essential window properties that are used for communicating with other clients (particularly window and sessionmanagers).<P>If the window_name argument is non-NULL, <B>XSetWMProperties()</B>calls<B><A HREF="XSetWMName.html">XSetWMName()</A></B>,which in turn, sets the WM_NAME property (see "<A HREF="wm-name.html">Setting and Reading the WM_NAME Property</A>").If the icon_name argument is non-NULL,<B>XSetWMProperties()</B>calls<B><A HREF="XSetWMIconName.html">XSetWMIconName()</A></B>,which sets the <A HREF="/gui/x/icccm/sec-4.html#WM_ICON_NAME">WM_ICON_NAME</A> property (see "<A HREF="wm-icon-name.html">Setting and Reading the WM_ICON_NAME Property</A>").If the argv argument is non-NULL, <B>XSetWMProperties()</B>calls<B><A HREF="../client-to-session-manager/XSetCommand.html">XSetCommand()</A></B>,which sets the <A HREF="/gui/x/icccm/sec-C.html#s-C.1.1">WM_COMMAND</A> property(see "<A HREF="../client-to-session-manager/wm-command.html">Setting and Reading the WM_COMMAND Property</A>").Note that an argc of zero is allowed to indicate a zero-length command.Note also that the hostname of this machine is stored using<B><A HREF="../client-to-session-manager/XSetWMClientMachine.html">XSetWMClientMachine()</A></B>(see "<A HREF="../client-to-session-manager/wm-client-machine.html">Setting and Reading the WM_CLIENT_MACHINE Property</A>").<P>If the normal_hints argument is non-NULL, <B>XSetWMProperties()</B>calls<B><A HREF="XSetWMNormalHints.html">XSetWMNormalHints()</A></B>,which sets the <A HREF="/gui/x/icccm/sec-4.html#WM_NORMAL_HINTS">WM_NORMAL_HINTS</A> property (see "<A HREF="wm-normal-hints.html">Setting and Reading the WM_NORMAL_HINTS Property</A>").If the wm_hints argument is non-NULL, <B>XSetWMProperties()</B>calls<B><A HREF="XSetWMHints.html">XSetWMHints()</A></B>,which sets the <A HREF="/gui/x/icccm/sec-4.html#WM_HINTS">WM_HINTS</A> property (see "<A HREF="wm-hints.html">Setting and Reading the WM_HINTS Property</A>").<P>If the class_hints argument is non-NULL, <B>XSetWMProperties()</B>calls<B><A HREF="XSetClassHint.html">XSetClassHint()</A></B>,which sets the <A HREF="/gui/x/icccm/sec-4.html#WM_CLASS">WM_CLASS</A> property (see "<A HREF="wm-class.html">Setting and Reading the WM_CLASS Property</A>").If the res_name member in the<A HREF="wm-class.html#XClassHint">XClassHint</A>structure is set to the NULL pointer and the RESOURCE_NAME environment variable is set, then the value of the environment variable is substituted for res_name.If the res_name member is NULL, the environment variable is not set, and argv and argv[0] are set, then the value of argv[0], stripped ofany directory prefixes, is substituted for res_name.<P><B>XSetWMProperties()</B>can generate<B>BadAlloc</B>and<B>BadWindow</B>errors.<H2>Diagnostics</H2><TABLE><TR><TD><B>BadAlloc</B><TD> The server failed to allocate the requested source or server memory.<TR><TD><B>BadWindow</B><TD>A value for a Window argument does not name a defined Window.</TABLE><H2>See also</H2><B><A HREF="XAllocClassHint.html">XAllocClassHint()</A></B>,<B><A HREF="XAllocIconSize.html">XAllocIconSize()</A></B>,<B><A HREF="XAllocSizeHints.html">XAllocSizeHints()</A></B>,<B><A HREF="XAllocWMHints.html">XAllocWMHints()</A></B>,<B><A HREF="XmbSetWMProperties.html">XmbSetWMProperties()</A></B>,<B><A HREF="../../utilities/XParseGeometry.html">XParseGeometry()</A></B>,<B><A HREF="../client-to-session-manager/XSetCommand.html">XSetCommand()</A></B>,<B><A HREF="XSetTransientForHint.html">XSetTransientForHint()</A></B>,<B><A HREF="XSetTextProperty.html">XSetTextProperty()</A></B>,<B><A HREF="../client-to-session-manager/XSetWMClientMachine.html">XSetWMClientMachine()</A></B>,<B><A HREF="XSetWMColormapWindows.html">XSetWMColormapWindows()</A></B>,<B><A HREF="XSetWMIconName.html">XSetWMIconName()</A></B>,<B><A HREF="XSetWMName.html">XSetWMName()</A></B>,<B><A HREF="XSetWMProtocols.html">XSetWMProtocols()</A></B>,<B><A HREF="XStringListToTextProperty.html">XStringListToTextProperty()</A></B>,<B><A HREF="XTextPropertyToStringList.html">XTextPropertyToStringList()</A></B>,"<A HREF="using-convenience-functions.html">Using Window Manager Convenience Functions</A>".<HR><ADDRESS><A HREF="http://tronche.com/">Christophe Tronche</A>, <A HREF="mailto:ch.tronche@computer.org">ch.tronche@computer.org</A></ADDRESS></BODY></HTML>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -