Freigeben über

Übergeben von Parametern an Visual FoxPro-API-Funktionen

  • Artikel

Vielfach verlangen die Visual FoxPro-API-Routinen Parameter einer bestimmten Visual FoxPro-Datenstruktur. Die folgenden Abschnitte enthalten eine Liste von Visual FoxPro-Datentypen und zusätzlichen Datenstrukturen. Die tatsächlichen Typ- und Strukturdefinitionen finden Sie in der Datei Pro_ext.h.

Visual FoxPro-API-Datentypen

Die folgenden Datentypen werden in Visual FoxPro-API-Routinen verwendet.

Datentyp Beschreibung 
EDLINE
 Die Nummer, die eine Zeile einer geöffneten Datei im jeweiligen Bearbeitungsfenster hat. Die erste Zeile hat die Nummer 1. 
EDPOS
 Die Versatzposition, die ein Zeichen einer geöffneten Datei im jeweiligen Bearbeitungsfenster einnimmt. Die Versatzposition des ersten Zeichens einer Datei oder eines Memofeldes ist 0. 
FCHAN
 Dateikanal (file channel). Jeder Datei, die von Visual FoxPro oder über die API mit _FCreate( ) bzw. _FOpen( ) geöffnet wird, wird ein FCHAN zugeordnet. 
FPFI
 Ein 32-Bit-Zeiger auf eine Funktion, die eine ganze Zahl zurückgibt. 
ITEMID
 Eine eindeutige Kennung, die einem Befehl eines Menüs zugeordnet ist. 
MENUID
 Eine eindeutige Kennung, die einem Menü zugeordnet ist. 
MHANDLE
 Eine eindeutige Kennung, die jedem Arbeitsspeicherblock zugeordnet ist, der entweder von Visual FoxPro oder mit _AllocHand( ) über die API reserviert wurde. Diese Kennung kann mit _HandToPtr( ) auf ihren Zeiger zurückgeführt werden. 
NTI
 Namenstabellenindex. Für jede Variable sowie jeden Namen eines Tabellenfeldes gibt es einen Eintrag in dieser Tabelle. 
WHANDLE
 Fenster-Handle. Eine eindeutige Kennung, die jedem Fenster zugeordnet ist, das entweder von Visual FoxPro oder mit _WOpen( ) über die API geöffnet wurde.

Anmerkung   Da FAR-Zeiger für 32-Bit-Compiler ungeeignet sind, gibt es in Pro_ext.h#define-Anweisungen, die FAR, _far und __far als Null-Werte definieren.

Visual FoxPro-API-Datenstrukturen

In der folgenden Tabelle sind die wichtigsten der Datenstrukturen aufgeführt, die in der Visual FoxPro-API-Bibliothek verwendet werden.

Struktur Beschreibung 
EventRec
 Eine Struktur, mit der beschrieben wird, was das System zu einem bestimmten Zeitpunkt ausführt. 
FoxInfo
 Wird in FLL-Bibliotheken verwendet, um Daten zwischen Visual FoxPro und Ihrem Programm auszutauschen; wird nicht in OCX-Dateien verwendet. 
FoxTable
 Wird in FLL-Bibliotheken verwendet, um Daten zwischen Visual FoxPro und Ihrem Programm auszutauschen; wird nicht in OCX-Dateien verwendet. 
Locator
 Eine Struktur, mit der auf Parameterwerte (FLL) oder Visual FoxPro-Variablen bzw. -Felder (FLL und OCX) zugegriffen wird. 
ParamBlk
 Wird in FLL-Bibliotheken verwendet, um Daten zwischen Visual FoxPro und Ihrem Programm auszutauschen; wird nicht in OCX-Dateien verwendet. 
Parameter
 Wird in FLL-Bibliotheken verwendet, um Daten zwischen Visual FoxPro und Ihrem Programm auszutauschen; wird nicht in OCX-Dateien verwendet. 
Point
 Eine Struktur, die die horizontale und die vertikale Koordinate eines Bildschirmpunktes definiert. Koordinaten werden in Zeilen und Spalten angegeben. 
Rect
 Eine Struktur, die die Koordinaten eines auf dem Bildschirm befindlichen Rechtecks definiert. Die obere linke Ecke ist durch (top,left) definiert, und die untere rechte Ecke ist durch (bottom-1,right-1) definiert. Koordinaten werden in Zeilen und Spalten angegeben. 
Value
 Eine Struktur, mit der auf Parameterwerte (FLL) oder Visual FoxPro-Variablen bzw. -Felder (FLL und OCX) zugegriffen wird.

Siehe auch

Rückgabe eines Wertes an Visual FoxPro | Zugriff auf Visual FoxPro-Variablen und -Felder | Zugreifen auf die Visual FoxPro-API | Erweitern von Visual FoxPro mit externen Bibliotheken | Verwalten des Arbeitsspeichers | Erstellung der API-Bibliothek