Compartir a través de

GETCP( ) (Función)

  • Artículo

Solicita una página de códigos mostrando el cuadro de diálogo Página de códigos y a continuación devuelve el número de la página de códigos elegida.

GETCP([nCodePage] [, cText] [, cDialogTitle])

Valores devueltos

Numeric

Parámetros

  • nCodePage
    Especifica el número de la página de códigos que se selecciona inicialmente cuando aparece el cuadro de diálogo Página de códigos. Si nCodePage es 0 o si omite nCodePage, no se selecciona ninguna página de códigos cuando aparece el cuadro de diálogo Página de códigos.
  • cText
    Especifica el rótulo que aparece en el cuadro de diálogo Página de códigos. Si omite cText, Visual FoxPro muestra el rótulo siguiente: "Seleccione una página de códigos para compartir datos entre plataformas."
  • cDialogTitle
    Especifica el título que aparece en la barra de título del cuadro de diálogo Página de códigos. Si omite cDialogTitle, aparecerá el título "Página de códigos".

Observaciones

GETCP( ) devuelve 0 si sale del cuadro de diálogo Página de códigos presionando la tecla ESC, eligiendo el botón Cancelar o eligiendo Cerrar en el menú Control.

Las páginas de códigos que aparecen en el cuadro de diálogo Páginas de códigos están determinadas por FOXPRO.INT, el archivo de soporte para la página de códigos Internacional de Visual FoxPro.

GETCP( ) puede incluirse en comandos como MODIFY COMMAND, APPEND FROM y COPY TO que admiten la cláusula AS nCodePage. En este caso aparecerá el cuadro de diálogo Página de códigos, que permite especificar la página de códigos del archivo abierto, agregado o creado. Puesto que no existe ninguna página de códigos cuyo número es 0, deberá interceptar el valor 0 por si acaso el usuario elige ESC, el botón Cancelar o Cerrar en el menú Control.

Ejemplo

En el siguiente ejemplo, se muestra el cuadro de diálogo Página de códigos con la página de códigos 1252 (Windows ANSI) seleccionada. Aparece "Seleccione una página de códigos" como título del cuadro de diálogo Página de códigos y "Selección de página de códigos" en la barra de título del cuadro de diálogo Página de códigos.

? GETCP(1252, "Select a Code Page", "Code Page Selection")

Vea también

APPEND FROM | COPY TO | EXPORT | IMPORT | MODIFY COMMAND | MODIFY FILE | MODIFY QUERY