1XmCvtXmStringTableToTextProperty(XlmiCbvrtaXrmyStcrailnlg)TableToTextProperty(library call)
2
3
4

NAME

6       XmCvtXmStringTableToTextProperty   —  A  function  that  converts  from
7       XmStringTable to an XTextProperty Structure
8

SYNOPSIS

10       #include <Xm/Xm.h>
11       int XmCvtXmStringTableToTextProperty (display, string_table, count, style, text_prop_return)
12               Display *display;
13               XmStringTable   string_table;
14               int     count;
15               XmICCEncodingStyle      style;
16               XTextProperty   *text_prop_return;
17       (void)
18

DESCRIPTION

20       XmCvtXmStringTableToTextProperty converts the XmStrings in  the  speci‐
21       fied XmStringTable into an XTextProperty structure.
22
23       The  function  sets  the encoding member of text_prop_return to an Atom
24       for the specified display naming the encoding determined by the  speci‐
25       fied  style,  and  it  converts the first count compound strings in the
26       specified  XmStringTable  to  this  encoding   for   storage   in   the
27       text_prop_return  value  member.  Following  are  the possible encoding
28       styles:
29
30       XmSTYLE_COMPOUND_STRING
31                 The encoding is _MOTIF_COMPOUND_STRING. The function converts
32                 each  specified  XmString to a compound string in Byte Stream
33                 format.
34
35       XmSTYLE_COMPOUND_TEXT
36                 The encoding is COMPOUND_TEXT.  The  function  converts  each
37                 specified XmString to compound text.
38
39       XmSTYLE_LOCALE
40                 The encoding is the encoding of the current locale. The func‐
41                 tion converts each specified XmString to the encoding of  the
42                 current locale.
43
44       XmSTYLE_STRING
45                 The   encoding   is   STRING  (plain  C  strings  encoded  in
46                 ISO8859-1), and the function converts each specified XmString
47                 to STRING.
48
49       XmSTYLE_TEXT
50                 If  all  specified  XmStrings  are  fully  convertible to the
51                 encoding of the current locale, the encoding is the  encoding
52                 of  the current locale, and the function converts each speci‐
53                 fied XmString to the encoding of the current  locale.  Other‐
54                 wise,  the  encoding  is COMPOUND_TEXT, and the function con‐
55                 verts each specified compound string to compound text.
56
57       XmSTYLE_STANDARD_ICC_TEXT
58                 If all specified XmStrings are fully convertible  to  STRING,
59                 the encoding is STRING, and the function converts each speci‐
60                 fied XmString to STRING.  Otherwise,  the  encoding  is  COM‐
61                 POUND_TEXT, and the function converts each specified XmString
62                 to compound text.
63
64       display   Specifies the connection to the X server.
65
66       string_table
67                 Specifies a set of XmStrings.
68
69       count     Specifies  the  number  of  XmStrings  to  be  converted   in
70                 string_table.
71
72       style     Specifies the manner in which the property is encoded.
73
74       text_prop_return
75                 Returns the XTextProperty structure.
76
77       To  free  the  storage  for  the value member of the XTextProperty, use
78       XtFree.
79

RETURN VALUES

81       If conversion depends on the locale and the current locale is not  sup‐
82       ported,  the  function  returns  XLocaleNotSupported.  In both of these
83       cases, the function does not set text_prop_return.
84
85       To determine whether the function is  guaranteed  not  to  return  XLo‐
86       caleNotSupported, use XSupportsLocale.
87
89       XmCvtXmStringToByteStream(3),  XmCvtTextPropertyToXmStringTable(3), and
90       XmStringTable(3).
91
92
93
94                                XmCvtXmStringTableToTextProperty(library call)
Impressum