GETCP( )-Funktion

  • Artikel

Fordert zur Eingabe einer Codepage auf, indem das Dialogfeld Codepage angezeigt wird, und gibt anschließend die Nummer der ausgewählten Codepage zurück.

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

Rückgabewerte

Numerisch

Parameter

  • nCodePage
    Gibt die Nummer der Codepage an, die anfangs ausgewählt ist, wenn das Dialogfeld Codepage angezeigt wird. Wenn nCodePage gleich 0 ist oder Sie nCodePage nicht angeben, ist keine Codepage ausgewählt, wenn das Dialogfeld Codepage angezeigt wird.
  • cText
    Gibt den im Dialogfeld Codepage angezeigten Text an. Wenn Sie cText nicht angeben, gibt Visual FoxPro den folgenden Text aus: Bitte wählen Sie eine Codepage für den Datenaustausch zwischen verschiedenen Plattformen aus.
  • cDialogTitle
    Gibt den Titel an, der in der Titelleiste des Dialogfeldes Codepage angezeigt wird. Wenn Sie cDialogTitle nicht angeben, wird der Titel Codepage angezeigt.

Hinweise

GETCP( ) gibt 0 zurück, wenn Sie das Dialogfeld Codepage verlassen, indem Sie ESC drücken, die Schaltfläche Abbrechen wählen oder aus dem Systemmenü den Befehl Schließen wählen.

Welche Codepages im Dialogfeld Codepage aufgelistet werden, hängt von FOXPRO.INT ab, der Visual FoxPro-Datei für die Unterstützung länderspezifischer Codepages.

Sie können GETCP( ) in Befehlen wie z. B. MODIFY COMMAND, APPEND FROM und COPY TO angeben, welche die Klausel AS nCodePage unterstützen. Das Dialogfeld Codepage wird angezeigt und ermöglicht Ihnen, die Codepage der Datei anzugeben, die geöffnet, angefügt oder erstellt wird. Da es keine Codepage 0 gibt, müssen Sie 0 für den Fall abfangen, dass der/die Benutzer/in ESC drückt, die Schaltfläche Abbrechen wählt oder aus dem Systemmenü den Befehl Schließen wählt.

Beispiel

Im folgenden Beispiel wird das Dialogfeld Codepage angezeigt, wobei die Codepage 1252 (Windows ANSI) ausgewählt ist. Als Beschriftung des Dialogfeldes Codepage wird Select a Code Page angezeigt. In der Titelleiste des Dialogfeldes wird Code Page Selection angezeigt.

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

Siehe auch

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