Xmb文本属性到文本列表

语法

int XmbTextPropertyToTextList(显示,文本_放置,列表_返回,计数_返回)显示器*显示;XText属性*文本_放置;字符***列表_返回;整数*计数_返回;整型XwcTextPropertyToTextList(显示,文本_放置,列表_返回,计数_返回)显示器*显示;XText属性*文本_放置;wchar_t型***列表_返回;整数*计数_返回;

论据

描述

属性的多个元素（例如，不相交的字符串文本选择）由空字节分隔。财产的内容无需终止；textprop.nitems中不应包含任何终止null。

如果列表及其元素的可用内存不足，XmbTextPropertyToTextList（）和XwcTextPropertyToTextList（）返回XNo内存.如果不支持当前区域设置，函数返回XLocale不受支持.否则，如果text_prop的编码字段不可转换到当前语言环境的编码，函数返回找不到X转换器.对于支持的区域设置，存在来自COMPUND_TEXT、STRING的转换器或保证当前区域设置的编码，如果XSupportsLocale（XSupports区域设置）收益真的用于当前区域设置（但实际文本可能包含不可转换的字符）。其他编码的转换取决于实现。在所有这些错误情况下，这些函数不设置任何返回值。

否则，XmbTextPropertyToTextList（）和XwcTextPropertyToTextList（）将以null结尾的文本字符串列表返回到list_return以及countreturn的文本字符串数。

如果text_prop的值字段不能完全转换为当前区域设置，函数返回不可转换的字符数。每个不可转换的字符都转换为特定于当前区域设置的当前区域设置。要获取此字符串的值，使用XDefaultString（）.否则，XmbTextPropertyToTextList（）和XwcTextPropertyToTextList（）返回成功.

释放列表及其返回内容的存储空间XmbTextPropertyToTextList（）,使用XFreeStringList（）.释放列表及其返回内容的存储空间XwcTextPropertyToTextList（）,使用XwcFreeStringList（）.

另请参阅