version 2003
PA_SetTextField (tNum; fNum; text; len)
Parameter | Type | Description | |
tNum | short | Table number of the field to access | |
fNum | short | Field number of the field to access | |
text | char* | Pointer to the text buffer | |
len | long | Length of the text |
Description
The routine PA_SetTextField fills the text field number fNum of the current record of the table number tNum with the text pointed to by the buffer text, of length len.
If the field is not a text field, the routine does nothing and sets an error in PA_GetLastError().
Depending on default settings or on previous calls to PA_UseMacCharacters or PA_UseANSICharacters, newText should contain Macintosh or ANSI characters.
Example
Fill the field content with the content of a text variable (no error checking here).
void TextVariableToTextField( PA_Variable v, short tNum, short fNum ) { char *text; long size; if(PA_GetVariableKind(v) == eVK_Text) { // First get the size of the buffer, then allocate it and recall the routine size = PA_GetTextVariable( v, 0 ); text = malloc( size ); size = PA_GetTextVariable( v, text ); // text is filled -> transfert it to the field PA_SetTextField( tNum, fNum, text, size ); // cleanup free(text); } }
See Also
PA_GetTextField, PA_UseAnsiCharacters, PA_UseMacCharacters.
Error Handling
Use PA_GetLastError to see if an error occurred