C
TEXTENTRY * TeCreate( WORD ID, SHORT left, SHORT top, SHORT right, SHORT bottom, WORD state, SHORT horizontalKeys, SHORT verticalKeys, XCHAR * pText[], void * pBuffer, WORD bufferLength, void * pDisplayFont, GOL_SCHEME * pScheme );
Overview
This function creates a TEXTENTRY object with the parameters given. It automatically attaches the new object into a global linked list of objects and returns the address of the object.
Input Parameters
|
Input Parameters |
Description |
|
WORD ID |
Unique user defined ID for the object instance |
|
SHORT left |
Left most position of the object. |
|
SHORT top |
Top most position of the object. |
|
SHORT right |
Right most position of the object. |
|
SHORT bottom |
Bottom most position of the object. |
|
WORD state |
state of the widget. |
|
SHORT horizontalKeys |
Number of horizontal keys |
|
SHORT verticalKeys |
Number of vertical keys |
|
XCHAR * pText[] |
array of pointer to the custom "text" assigned by the user. |
|
void * pBuffer |
pointer to the buffer that holds the text to be displayed. |
|
WORD bufferLength |
length of the buffer assigned by the user. |
|
void * pDisplayFont |
pointer to the font image to be used on the editbox |
|
GOL_SCHEME * pScheme |
Pointer to the style scheme used. Output Returns the pointer to the object created. |
Preconditions
If the object will use customized keys, the structure CUSTOMEKEYS must be populated before calling this function.
Side Effects
none.