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(中文)