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

Technical Reference: Base Operating System and Extensions, Volume 1


IMCreate Subroutine

Purpose

Creates one instance of an IMObject object for a particular input method.

Library

Input Method Library (libIM.a)

Syntax


IMObject IMCreate( IMfep IMCallback UData)
IMFep IMfep;
IMCallback *IMCallback;
caddr_t UData;

Description

The IMCreate subroutine creates one instance of a particular input method. Several input method instances can be created under one input method.

Parameters


IMfep Specifies the input method.
IMCallback Specifies a pointer to the caller-supplied IMCallback structure.
UData Optionally specifies an application's own information to the callback functions. With this information, the application can avoid external references from the callback functions. The input method does not change this parameter, but merely passes it to the callback functions. The UData parameter is usually a pointer to the application data structure, which contains the information about location, font ID, and so forth.

Return Values

The IMCreate subroutine returns a pointer to the created input method instance of type IMObject. If the subroutine is unsuccessful, a null value is returned and the imerrno global variable is set to indicate the error.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The IMDestroy (IMDestroy Subroutine) subroutine, IMFilter (IMFilter Subroutine) subroutine, IMLookupString (IMLookupString Subroutine) subroutine, IMProcess (IMProcess Subroutine) subroutine.

Input Method Overview and National Language Support Overview for Programming in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.


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