DO FORM-Befehl
Führt kompilierte Formulare oder Formularsätze aus, die mit dem Formular-Designer erstellt wurden.
DO FORM FormName | ? [NAME VarName [LINKED]] [WITH cParameterList]
[TO VarName] [NOREAD] [NOSHOW]
Parameter
FormName
Gibt den Namen des Formulars oder Formularsatzes an, das bzw. der ausgeführt werden soll.?
Ruft das Dialogfeld Ausführen auf, in dem Sie das Formular oder den Formularsatz wählen können, das bzw. der ausgeführt werden soll.NAME VarName [LINKED]
Gibt eine Variable oder ein Arrayelement an, mit der bzw. dem Sie auf das Formular oder den Formularsatz verweisen können. Wenn Sie eine nicht vorhandene Variable angeben, wird diese von Microsoft Visual FoxPro automatisch erstellt. Wenn Sie ein Arrayelement angeben, muss das Array vorhanden sein, bevor Sie DO FORM eingeben. Ist die Variable oder das Arrayelement, die bzw. das Sie angeben, bereits vorhanden, wird ihr bzw. sein Inhalt überschrieben.Wenn Sie die NAME-Klausel nicht angeben, erstellt Visual FoxPro eine Objektvariable mit demselben Namen wie die Formular- oder Formularsatzdatei.
Geben Sie LINKED an, um das Formular mit der zugeordneten Variablen so zu verbinden, dass das Formular freigegeben wird, wenn die Variable nicht mehr im Geltungsbereich liegt. Wenn Sie LINKED nicht angeben, kann ein Formular auch dann noch aktiv sein, wenn ihm keine Objektvariable zugewiesen ist.
WITH cParameterList
Gibt die Parameter an, die an das Formular oder den Formularsatz übergeben werden.Wenn Sie einen Formularsatz ausführen, werden die Parameter an die Init-Methode des Formularsatzes übergeben, sofern die WindowType-Eigenschaft des Formularsatzes auf ModeLess (0) oder Modal (1) gesetzt ist. Wenn die WindowType-Eigenschaft des Formularsatzes auf Read (2) oder ReadModal (3) gesetzt ist, werden die Parameter an die Load-Methode übergeben.
TO VarName
Gibt eine Variable zum Speichern eines Wertes an, der vom Formular zurückgegeben wird. Ist die Variable nicht vorhanden, wird sie von Visual FoxPro automatisch erstellt. Geben Sie den Rückgabewert mit dem RETURN-Befehl in der Unload-Ereignisprozedur des Formulars an. Wenn Sie keinen Rückgabewert angeben, wird der Standardwert Wahr (.T.) zurückgegeben. Sie können TO nur verwenden, wenn die WindowType-Eigenschaft des Formulars auf 1 (Modal) gesetzt ist.NOREAD
Gibt an, dass der Formularsatz erstellt und angezeigt wird, wobei die Steuerelemente aber erst nach Eingabe eines READ-Befehls aktiviert werden. NOREAD wird ignoriert, wenn die WindowType-Eigenschaft des Formularsatzes nicht auf 2 (Read) gesetzt ist.NOSHOW
Legt fest, dass beim Ausführen des Formulars die Show-Methode des Formulars nicht aufgerufen wird. Wenn Sie NOSHOW angeben und das Formular ausführen, wird dieses erst angezeigt, wenn Sie die Visible-Eigenschaft des Formulars auf Wahr (.T.) setzen oder die Show-Methode des Formulars aufrufen.
Hinweise
DO FORM führt die Show-Methode des Formulars oder Formularsatzes aus.
Die Einstellungen Read (2) und ReadModal (3) der WindowType-Eigenschaft sind aus Gründen der Abwärtskompatibilität enthalten und nur für Formulare verfügbar, die aus früheren FoxPro-Versionen konvertiert wurden.
Beispiel
Das folgende Beispiel führt das Beispiel einer Stoppuhr aus (Swatch.SCX).
DO FORM (HOME(2) + 'Solution\Controls\Timer\Swatch.scx')