[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 1

IMLookupString Subroutine

Purpose

Maps a Key/State (key symbol/state) pair to a string.

Library

Input Method Library (libIM.a)

Syntax


int IMLookupString(Im, Key, State, String, Length)
IMObject  Im;
KeySym  Key;
uint  State, * Length;
caddr_t * String;

Description

The IMLookupString subroutine is used to map a Key/State pair to a localized string. It uses an internal input method keymap (imkeymap) file to map a keysym/modifier to a string. The string returned is encoded in the same code set as the locale of IMObject and IM Front End Processor.

Note
The buffer returned from the IMLookupString subroutine is owned by the input method editor and can not continue between calls.

Parameters

Im Specifies the input method instance.
Key Specifies the key symbol for the event.
State Defines the state for the event. A value of 0 means that the key is not redefined.
String Holds the returned string, if one exists. A null value means that no composed string is ready.
Length Defines the length string on input. If the string is not null, identifies the length returned.

Return Values

IMError Error encountered.
IMReturnNothing No string or keysym was returned.
IMReturnString String returned.

Related Information

Input Methods and National Language Support Overview in AIX 5L Version 5.2 National Language Support Guide and Reference.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]