GetCP()

The GetCP() function calls up a dialog that allows the operator to pick a code page.

Usage

nCodePage = GETCP( [ nInitialCP [, cPrompt [, cTitle ] ] ] )

Parameter	Value	Meaning
nInitialCP	Integer	Displays the specified code page as selected in the list box. You must pass some value (even though it doesn't need to be a valid code page) if you pass a value for cPrompt or cTitle.
nInitialCP	Omitted	No code page is highlighted.
cPrompt	Character	The prompt to appear within the dialog box. Practically limited to around 200 characters, but more are accepted.
cPrompt	Empty string or omitted	Prompt is "Please select a code page for cross-platform data sharing." Note that you must pass the empty string, and not just omit the parameter, if you pass the cTitle parameter.
cTitle	Character	The title to display in the dialog box title bar. If the title exceeds the space allowed, it is truncated with an ellipsis.
cTitle	Empty string or omitted	Dialog title is displayed as "Code Page."
nCodePage	0	User selected Cancel, Close from the control menu or pressed Escape.
nCodePage	Integer	The code page selected by the user.

Use this dialog to allow your users to chose a code page for tagging a file, translating, or perhaps selecting which code page to use for generation. There appears to be no way to preset the option group on the left-hand side of the dialog to show anything but "All platforms." Check out the CpZero.PRG supplied with Visual FoxPro to modify the code page of an existing DBF.

Example

? GETCP( 1250, "Convert file to which code page?", ;
               "Code Page Conversion" )