L_DlgGetString

#include "l_bitmap.h"

L_LTDLG_API L_INT L_DlgGetString(uString, pszString, sizeInWords)

L_UINT32 uString;

/* index of a string */

L_TCHAR * pszString;

/* pointer to the variable to be updated */

L_SIZE_T sizeInWords;

/* size of the pszString string buffer */

Gets the current string for the specified index.

Parameter

Description

uString

Index into a list of strings. For a list of the strings, refer to Dialog Strings.

pszString

Pointer to the buffer to be updated with the current string.

sizeInWords

Size of the pszString string buffer in words.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Before calling this function, call L_DlgGetStringLen to get the length of the text you want to retrieve.

Before calling this function, you must declare a variable as a pointer to a character string. You must allocate enough memory to hold the character string. Then, pass the variable in the pszString parameter. This function will update the variable with the character string at the given index.

Required DLLs and Libraries

LTDLGKRN
LTKRN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

See Also

Functions:

L_DlgGetStringLen, L_DlgSetString, L_DlgSetFont

Topics:

Dialogs: Maintenance and General Use

 

Using Imaging Common Dialog

Example

For an example, refer to L_DlgSetFont.