📄 xinternatoms.html
字号:
<HTML><HEAD><TITLE>Xlib Programming Manual: XInternAtoms</TITLE></HEAD><BODY><H1 ALIGN=center>XInternAtoms</H1><H2>Syntax</H2><!.IN "Atom" "interning"><!.IN "XInternAtoms" "" "@DEF@"><CODE><PRE>Status XInternAtoms(<B>display</B>, <B>names</B>, <B>count</B>, <B>only_if_exists</B>, <B>atoms_return</B>) <A HREF="../display/opening.html#Display">Display</A> *<B>display</B>; char **<B>names</B>; int <B>count</B>; Bool <B>only_if_exists</B>; <A HREF="../glossary/#atom">Atom</A> *<B>atoms_return</B>;</PRE></CODE><H2>Arguments</H2><TABLE><TR><TD> <B>display</B><TD> Specifies the connection to the X server.<TR><TD> <B>names</B><TD> Specifies the array of atom names.<TR><TD> <B>count</B><TD> Specifies the number of atom names in the array.<TR><TD> <B>only_if_exists</B><TD> Specifies a Boolean value that indicates whether the atom must be created.<TR><TD> <B>atoms_return</B><TD> Returns the atoms.</TABLE><H2>Description</H2>The<B>XInternAtoms()</B>function returns the atom identifiers associated with the specified names.The atoms are stored in the atoms_return array supplied by the caller.Calling this function is equivalent to calling<B><A HREF="XInternAtom.html">XInternAtom()</A></B>for each of the names in turn with the specified value of only_if_exists,but this function minimizes the number of round trip protocol exchangesbetween the client and the X server.<P>This function returns a nonzero status if atoms are returned forall of the names;otherwise, it returns zero.<P><B>XInternAtoms()</B>can generate<B>BadAlloc</B>and<B>BadValue</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>BadValue</B><TD> 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.</TABLE><H2>See also</H2><B><A HREF="../display/XFree.html">XFree()</A></B>,<B><A HREF="XGetAtomName.html">XGetAtomName()</A></B>,<B><A HREF="XGetWindowProperty.html">XGetWindowProperty()</A></B>,<B><A HREF="XInternAtom.html">XInternAtom()</A></B>,"<A HREF="properties-and-atoms.html">Properties and Atoms</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 + -