?? gdk-properties-and-atoms.html
字號:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"><title>Properties and Atoms</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="GDK Reference Manual"><link rel="up" href="reference.html" title="API Reference"><link rel="prev" href="gdk-Drag-and-Drop.html" title="Drag and Drop"><link rel="next" href="gdk-Threads.html" title="Threads"><meta name="generator" content="GTK-Doc V1.9 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="reference" href="reference.html" title="API Reference"><link rel="index" href="ix01.html" title="Index"><link rel="index" href="ix02.html" title="Index of deprecated symbols"><link rel="index" href="ix03.html" title="Index of new symbols in 2.2"><link rel="index" href="ix04.html" title="Index of new symbols in 2.4"><link rel="index" href="ix05.html" title="Index of new symbols in 2.6"><link rel="index" href="ix06.html" title="Index of new symbols in 2.8"><link rel="index" href="ix07.html" title="Index of new symbols in 2.10"><link rel="index" href="ix08.html" title="Index of new symbols in 2.12"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="gdk-Drag-and-Drop.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="reference.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">GDK Reference Manual</th><td><a accesskey="n" href="gdk-Threads.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr><tr><td colspan="5" class="shortcuts"><nobr><a href="#id3271983" class="shortcut">Top</a>  |  <a href="#id3272854" class="shortcut">Description</a></nobr></td></tr></table><div class="refentry" lang="en"><a name="gdk-Properties-and-Atoms"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><a name="id3271983"></a><span class="refentrytitle">Properties and Atoms</span></h2><p>Properties and Atoms — Functions to manipulate properties on windows</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">#include <gdk/gdk.h> <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a>;#define <a class="link" href="gdk-Properties-and-Atoms.html#GDK-ATOM-TO-POINTER:CAPS">GDK_ATOM_TO_POINTER</a> (atom)#define <a class="link" href="gdk-Properties-and-Atoms.html#GDK-POINTER-TO-ATOM:CAPS">GDK_POINTER_TO_ATOM</a> (ptr)#define <a class="link" href="gdk-Properties-and-Atoms.html#GDK-NONE:CAPS">GDK_NONE</a><ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> <a class="link" href="gdk-Properties-and-Atoms.html#gdk-text-property-to-text-list">gdk_text_property_to_text_list</a> (<a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> encoding, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> format, const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar">guchar</a> *text, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> length, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> ***list);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> <a class="link" href="gdk-Properties-and-Atoms.html#gdk-text-property-to-text-list-for-display">gdk_text_property_to_text_list_for_display</a> (<a class="link" href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display, <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> encoding, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> format, const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar">guchar</a> *text, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> length, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> ***list);void <a class="link" href="gdk-Properties-and-Atoms.html#gdk-free-text-list">gdk_free_text_list</a> (<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> **list);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> <a class="link" href="gdk-Properties-and-Atoms.html#gdk-text-property-to-utf8-list">gdk_text_property_to_utf8_list</a> (<a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> encoding, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> format, const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar">guchar</a> *text, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> length, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> ***list);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> <a class="link" href="gdk-Properties-and-Atoms.html#gdk-text-property-to-utf8-list-for-display">gdk_text_property_to_utf8_list_for_display</a> (<a class="link" href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display, <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> encoding, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> format, const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar">guchar</a> *text, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> length, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> ***list);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> <a class="link" href="gdk-Properties-and-Atoms.html#gdk-string-to-compound-text">gdk_string_to_compound_text</a> (const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *str, <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> *encoding, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *format, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar">guchar</a> **ctext, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *length);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> <a class="link" href="gdk-Properties-and-Atoms.html#gdk-string-to-compound-text-for-display">gdk_string_to_compound_text_for_display</a> (<a class="link" href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display, const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *str, <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> *encoding, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *format, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar">guchar</a> **ctext, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *length);void <a class="link" href="gdk-Properties-and-Atoms.html#gdk-free-compound-text">gdk_free_compound_text</a> (<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar">guchar</a> *ctext);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a>* <a class="link" href="gdk-Properties-and-Atoms.html#gdk-utf8-to-string-target">gdk_utf8_to_string_target</a> (const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *str);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gdk-Properties-and-Atoms.html#gdk-utf8-to-compound-text">gdk_utf8_to_compound_text</a> (const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *str, <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> *encoding, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *format, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar">guchar</a> **ctext, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *length);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gdk-Properties-and-Atoms.html#gdk-utf8-to-compound-text-for-display">gdk_utf8_to_compound_text_for_display</a> (<a class="link" href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display, const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *str, <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> *encoding, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *format, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar">guchar</a> **ctext, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *length);<a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> <a class="link" href="gdk-Properties-and-Atoms.html#gdk-atom-intern">gdk_atom_intern</a> (const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *atom_name, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> only_if_exists);<a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> <a class="link" href="gdk-Properties-and-Atoms.html#gdk-atom-intern-static-string">gdk_atom_intern_static_string</a> (const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *atom_name);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a>* <a class="link" href="gdk-Properties-and-Atoms.html#gdk-atom-name">gdk_atom_name</a> (<a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> atom);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gdk-Properties-and-Atoms.html#gdk-property-get">gdk_property_get</a> (<a class="link" href="gdk-Windows.html#GdkWindow">GdkWindow</a> *window, <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> property, <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> type, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gulong">gulong</a> offset, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gulong">gulong</a> length, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> pdelete, <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> *actual_property_type, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *actual_format, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *actual_length, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar">guchar</a> **data);void <a class="link" href="gdk-Properties-and-Atoms.html#gdk-property-change">gdk_property_change</a> (<a class="link" href="gdk-Windows.html#GdkWindow">GdkWindow</a> *window, <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> property, <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> type, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> format, <a class="link" href="gdk-Properties-and-Atoms.html#GdkPropMode">GdkPropMode</a> mode, const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar">guchar</a> *data, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> nelements);enum <a class="link" href="gdk-Properties-and-Atoms.html#GdkPropMode">GdkPropMode</a>;void <a class="link" href="gdk-Properties-and-Atoms.html#gdk-property-delete">gdk_property_delete</a> (<a class="link" href="gdk-Windows.html#GdkWindow">GdkWindow</a> *window, <a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> property);</pre></div><div class="refsect1" lang="en"><a name="id3272854"></a><h2>Description</h2><p>Each window under X can have any number of associated<em class="firstterm">properties</em> attached to it.Properties are arbitrary chunks of data identified by<em class="firstterm">atom</em>s. (An <em class="firstterm">atom</em>is a numeric index into a string table on the X server. They are usedto transfer strings efficiently between clients withouthaving to transfer the entire string.) A propertyhas an associated type, which is also identifiedusing an atom.</p><p>A property has an associated <em class="firstterm">format</em>,an integer describing how many bits are in each unitof data inside the property. It must be 8, 16, or 32.When data is transferred between the server and client,if they are of different endianesses it will be byteswappedas necessary according to the format of the property.Note that on the client side, properties of format 32will be stored with one unit per <span class="emphasis"><em>long</em></span>,even if a long integer has more than 32 bits on the platform.(This decision was apparently made for Xlib to maintaincompatibility with programs that assumed longs were 32bits, at the expense of programs that knew better.)</p><p>The functions in this section are used to add, remove?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -