XGetTextProperty(XGetText属性)
语法
状态XGetTextProperty(XGetText属性)(显示,w个,文本_放置_返回,财产)显示器*显示;窗口w个;XText属性*文本_放置_返回;原子财产;
论据
显示
| 指定到X服务器的连接。 |
w个
| 指定窗口。 |
文本_处理_返回
| 返回XText属性结构。 |
财产
| 指定属性名称。 |
描述
这个XGetTextProperty()函数从窗口读取指定的属性并将数据存储在返回的XText属性结构。它将数据存储在值字段中,编码字段中的数据类型,格式字段中数据的格式,以及nitems字段中数据项的数量。包含null的额外字节(不包括在nitems成员中)存储在text_prop_return的值字段的末尾。属性编码的特定解释数据作为文本留给调用应用程序。如果窗口上不存在指定的属性,XGetTextProperty()将值字段设置为NULL,编码字段到无, 格式字段设置为零,nitems字段为零。如果它能够在XText属性结构,XGetTextProperty()返回非零状态;否则,它返回零状态。
XGetTextProperty()可以生成BadAtom公司和坏窗口错误。
诊断
BadAtom公司
| Atom参数的值没有命名定义了Atom。 |
坏窗口
| Window参数的值没有命名定义的Window。 |
另请参见
XAllocClassHint(),XAllocIconSize(),XAllocSizeHints(),XAllocWMHints(),XSet命令(),XSetTextProperty(),XSetTransientForHint(),XSetWMClientMachine(),XSetWMColormapWindows(),XSetWMIconName(),XSetWMName(),XSetWMProperties(),XSetWM协议(),XStringListToTextProperty(),"设置和读取文本属性".
克里斯托弗·特隆奇,ch@tronche.com(中文)