Xlib − C Language X Interface

Xlib − C LibraryX11, Release 6.7 DRAFTXIMCaretDirection. The factor member of XIMStringConversionCallbackStruct specifiesthe number of XIMCaretDirection positions to be applied. For example, if the direction specifiesXIMLineEnd and factor is 1, then all characters from the starting position to the end of thecurrent display line are returned. If the direction specifies XIMForwardChar or XIMBackwardChar,then the factor specifies a relative position, indicated in characters, from the startingposition.XIMStringConversionOperation specifies whether the string to be converted should be deleted(substitution) or copied (retrieval) from the client’s buffer. When the XIMStringConversionOperationis XIMStringConversionSubstitution, the client must delete the string to be convertedfrom its own buffer. When the XIMStringConversionOperation is XIMStringConversionRetrieval,the client must not delete the string to be converted from its buffer. The substitute operationis typically used for reconversion and transliteration conversion, while the retrieval operationis typically used for context-sensitive conversion.13.5.7.4. Preedit State CallbacksWhen the input method turns preediting on or off, a PreeditStartCallback or PreeditDoneCallbackcallback is triggered to let the toolkit do the setup or the cleanup for the preedit region.int PreeditStartCallback(ic, client_data, call_data)XIC ic;XPointer client_data;XPointer call_data;icclient_datacall_dataSpecifies the input context.Specifies the additional client data.Not used for this callback and always passed as NULL.When preedit starts on the specified input context, the callback is called with a NULL call_dataargument. PreeditStartCallback will return the maximum size of the preedit string. Apositivenumber indicates the maximum number of bytes allowed in the preedit string, and a value of −1indicates there is no limit.void PreeditDoneCallback(ic, client_data, call_data)XIC ic;XPointer client_data;XPointer call_data;icclient_datacall_dataSpecifies the input context.Specifies the additional client data.Not used for this callback and always passed as NULL.When preedit stops on the specified input context, the callback is called with a NULL call_dataargument. The client can release the data allocated by PreeditStartCallback.PreeditStartCallback should initialize appropriate data needed for displaying preedit informationand for handling further PreeditDrawCallback calls. Once PreeditStartCallback iscalled, it will not be called again before PreeditDoneCallback has been called.333