XmbTextListToTextProperty(XML文本列表到文本属性)
语法
int XmbTextListToTextProperty(int XmbTextListToTextProperty)(显示,列表,计数,风格,文本_处理_返回)显示器*显示;字符**列表;整数计数;XICC编码样式 风格;XText属性*文本_放置_返回;整型XwcTextListToTextProperty(显示,列表,计数,风格,文本_放置_返回)显示器*显示;wchar_t(W)**列表;整数计数;XICC编码样式 风格;XText属性*文本_放置_返回;
参数
显示
| 指定到X服务器的连接。 |
列表
| 指定以null结尾的字符串列表。 |
计数
| 指定指定的字符串数。 |
风格
| 指定属性的编码方式。 |
文本_放置_返回
| 返回XText属性结构。 |
描述
这个XmbTextListToTextProperty()和XwcTextListToTextProperty()函数设置指定的XText属性值设置为表示串联的一组空分隔元素指定的以null结尾的文本字符串列表。最后一个终止null存储在值字段的末尾text_prop_return,但不包含在nitems成员中。函数将text_prop_return的编码字段设置为原子用于指定的显示命名由指定样式确定的编码并将指定的文本列表转换为此编码以存储在textpropreturn值字段。如果样式XString样式或XCompoundTextStyle(X复合文本样式)已指定,此编码分别为“STRING”或“COMPUND_TEXT”。如果样式X文本样式被指定,此编码是当前区域设置的编码。如果样式XStdICC文本样式已指定,如果文本可完全转换为STRING,则此编码为“STRING”,else ``COMPUND_TEXT''。
如果没有足够的存储器可用于新的值串,函数返回XNo内存.如果不支持当前区域设置,函数返回XLocale不受支持.在这两种错误情况下,函数不设置textpropreturn。
确定函数是否保证不返回XLocale不受支持,使用XSupportsLocale(XSupports区域设置).
如果提供的文本不能完全转换为指定的编码,函数返回不可转换的字符数。每个不可转换的字符都转换为实现定义的和编码特定的默认字符串。否则,函数返回成功.请注意,除了XString样式是有保证的。
要释放值字段的存储空间,请使用XFree().
另请参见
XmbTextPropertyToTextList(),XwcTextPropertyToTextList(),XwcFreeStringList(),XDefaultString(),XSetTextProperty(),XStringListToTextProperty(),"转换字符串列表".
克里斯托夫·特朗奇,ch@tronche.com(中文)