Mercurial > sdl-ios-xcode
comparison docs/html/sdlenableunicode.html @ 181:e5bc29de3f0a
Updated from the SDL Documentation Project
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Fri, 14 Sep 2001 02:41:09 +0000 |
parents | 55f1f1b3e27d |
children | 355632dca928 |
comparison
equal
deleted
inserted
replaced
180:578815880307 | 181:e5bc29de3f0a |
---|---|
71 >SDL_EnableUNICODE</A | 71 >SDL_EnableUNICODE</A |
72 ></H1 | 72 ></H1 |
73 ><DIV | 73 ><DIV |
74 CLASS="REFNAMEDIV" | 74 CLASS="REFNAMEDIV" |
75 ><A | 75 ><A |
76 NAME="AEN5262" | 76 NAME="AEN5417" |
77 ></A | 77 ></A |
78 ><H2 | 78 ><H2 |
79 >Name</H2 | 79 >Name</H2 |
80 >SDL_EnableUNICODE -- Enable UNICODE translation</DIV | 80 >SDL_EnableUNICODE -- Enable UNICODE translation</DIV |
81 ><DIV | 81 ><DIV |
82 CLASS="REFSYNOPSISDIV" | 82 CLASS="REFSYNOPSISDIV" |
83 ><A | 83 ><A |
84 NAME="AEN5265" | 84 NAME="AEN5420" |
85 ></A | 85 ></A |
86 ><H2 | 86 ><H2 |
87 >Synopsis</H2 | 87 >Synopsis</H2 |
88 ><DIV | 88 ><DIV |
89 CLASS="FUNCSYNOPSIS" | 89 CLASS="FUNCSYNOPSIS" |
90 ><A | 90 ><A |
91 NAME="AEN5266" | 91 NAME="AEN5421" |
92 ></A | 92 ></A |
93 ><P | 93 ><P |
94 ></P | 94 ></P |
95 ><PRE | 95 ><PRE |
96 CLASS="FUNCSYNOPSISINFO" | 96 CLASS="FUNCSYNOPSISINFO" |
110 ></DIV | 110 ></DIV |
111 ></DIV | 111 ></DIV |
112 ><DIV | 112 ><DIV |
113 CLASS="REFSECT1" | 113 CLASS="REFSECT1" |
114 ><A | 114 ><A |
115 NAME="AEN5272" | 115 NAME="AEN5427" |
116 ></A | 116 ></A |
117 ><H2 | 117 ><H2 |
118 >Description</H2 | 118 >Description</H2 |
119 ><P | 119 ><P |
120 >Enables/Disables UNICODE keyboard translation.</P | 120 >Enables/Disables Unicode keyboard translation.</P |
121 ><P | 121 ><P |
122 >If you wish to translate a keysym to it's printable representation, you need to enable UNICODE translation | 122 >To obtain the character codes corresponding to received keyboard events, |
123 using this function (<TT | 123 Unicode translation must first be turned on using this function. The |
124 translation incurs a slight overhead for each keyboard event and is therefore | |
125 disabled by default. For each subsequently received key down event, the | |
126 <TT | |
127 CLASS="STRUCTFIELD" | |
128 ><I | |
129 >unicode</I | |
130 ></TT | |
131 > member of the | |
132 <A | |
133 HREF="sdlkeysym.html" | |
134 ><SPAN | |
135 CLASS="STRUCTNAME" | |
136 >SDL_keysym</SPAN | |
137 ></A | |
138 > structure | |
139 will then contain the corresponding character code, or zero for keysyms that do | |
140 not correspond to any character code.</P | |
141 ><P | |
142 >A value of 1 for <TT | |
124 CLASS="PARAMETER" | 143 CLASS="PARAMETER" |
125 ><I | 144 ><I |
126 >enable</I | 145 >enable</I |
127 ></TT | 146 ></TT |
128 >=0) and then look in the <TT | 147 > enables Unicode translation; |
129 CLASS="STRUCTFIELD" | 148 0 disables it, and -1 leaves it unchanged (useful for querying the current |
130 ><I | 149 translation mode).</P |
131 >unicode</I | 150 ><P |
132 ></TT | 151 >Note that only key press events will be translated, not release events.</P |
133 > member | |
134 of the <A | |
135 HREF="sdlkeysym.html" | |
136 ><SPAN | |
137 CLASS="STRUCTNAME" | |
138 >SDL_keysym</SPAN | |
139 ></A | |
140 > structure. This value will be zero for keysyms | |
141 that do not have a printable representation. UNICODE translation is disabled by default as the conversion can cause a slight overhead.</P | |
142 ></DIV | 152 ></DIV |
143 ><DIV | 153 ><DIV |
144 CLASS="REFSECT1" | 154 CLASS="REFSECT1" |
145 ><A | 155 ><A |
146 NAME="AEN5280" | 156 NAME="AEN5437" |
147 ></A | 157 ></A |
148 ><H2 | 158 ><H2 |
149 >Return Value</H2 | 159 >Return Value</H2 |
150 ><P | 160 ><P |
151 >Returns the previous translation mode.</P | 161 >Returns the previous translation mode (<SPAN |
162 CLASS="RETURNVALUE" | |
163 >0</SPAN | |
164 > or <SPAN | |
165 CLASS="RETURNVALUE" | |
166 >1</SPAN | |
167 >).</P | |
152 ></DIV | 168 ></DIV |
153 ><DIV | 169 ><DIV |
154 CLASS="REFSECT1" | 170 CLASS="REFSECT1" |
155 ><A | 171 ><A |
156 NAME="AEN5283" | 172 NAME="AEN5442" |
157 ></A | 173 ></A |
158 ><H2 | 174 ><H2 |
159 >See Also</H2 | 175 >See Also</H2 |
160 ><P | 176 ><P |
161 ><A | 177 ><A |