Formular

Diese Datei dokumentiert alle Makrofunktionen der Kategorie Formular.

Inhaltsverzeichnis

CloseForm(Form)

Schließt ein Formularfenster.

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

42 Makro Runtime


DataCommand(Form,Result,[DataCmd],[Data])

Führt ein Daten Kommando aus [Kommando=Leer liefert Kommandoliste]

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer
2 Result Name des Ergebnis-Arrays
3 DataCmd Optional: Kommando [Leer=Kommandoliste]
4 Data Optional: Name des Parameter-Arrays

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard


EnterValue(Form,Field,[Value])

Ändert den Wert eines Feldes im Formular, wenn möglich.

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer
2 Field Feldname
3 Value Optional: Inhalt

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

42 Makro Runtime


GetCurrentForm()

Ermittelt die Nummer des aktuellen Formulars

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Formularnummer

Verfügbarkeit

Standard


GetFldData(Form,Field,[PlainText])

Ermittelt den Inhalt des Feldes auf dem Formular

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer
2 Field Feldname
3 PlainText Optional: 1=Plaintext [0=Richtext]

Rückgabewert

Inhalt

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in der Datei 42Feld.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
OnCommand(Form, Cmd)
{
    if(stricmp(Cmd, ”GetFeld”) == 0)
    {
        Erg = GetFldData(Form, ”Artikelnummer”);
        Print(“Inhalt des Feldes Artikelnummer = “+Erg);
    }
    return(0);
}

GetFldName(Wnd)

Ermittelt den Feldnamen einer Fensternummer

Parameter

Nr. Parameter Beschreibung
1 Wnd Fensternummer

Rückgabewert

Feldname

Verfügbarkeit

Standard


GetFldProperty(Form,Control,Property,[Plaintext])

Ermittelt eine Eigenschaft eines Formularfeldes

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer
2 Control Feldname
3 Property Eigenschaft
4 Plaintext Optional: 1=Plaintext [0=Richtext]

Rückgabewert

Text

Verfügbarkeit

Standard


GetFldWnd(Form,Field)

Ermittelt die Fensternummer des Feldes im Formular

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer
2 Field Feldname

Rückgabewert

Fensternummer

Verfügbarkeit

Standard


GetFormDocument(Form)

Ermittelt die Dokumentart zu einem Formular

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer

Rückgabewert

Dokumentart

Verfügbarkeit

Standard


GetFormWindow(Form)

Ermittelt die Fensternummer des Formularfensters

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer

Rückgabewert

Fensternummer

Verfügbarkeit

42 Makro Runtime


GetFrmName(Form)

Ermittelt den Namen der zugehörigen Formulardatei

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer

Rückgabewert

Formularname

Verfügbarkeit

Standard


GetModifiedFlag(Form)

Ermittelt das Modifiedflag eines Formulars

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer

Rückgabewert

Modified 0:Unverändert, 1:Verändert

Verfügbarkeit

42 Makro Runtime


HideMessage(Form,[Text],[Value])

Löscht eine Nachricht in der Meldungsleiste, wenn diese noch angezeigt wird.

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer (wenn leer, dann wird die Meldungsleiste des Hauptfensters verwendet)
2 Text Optional: Zu entfernender Text
3 Value Optional: 0:Übersetzen 1:Babelfish deaktivieren

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard


PressButton(Form,Command)

Sendet ein Kommando an ein geöffnetes Formular

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer
2 Command Kommando (Feldname)

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard


SetFldData(Form,Field,[Value],[Unmask])

Setzt den Inhalt eines Feldes in einem Formular

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer
2 Field Feldname
3 Value Optional: Inhalt
4 Unmask Optional: AutoUnmask: 0=Disabled, [1=Auto]

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard


SetFldFocus(Form,Field)

Setzt den Focus auf ein bestimmtes Feld im angebenen Formular

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer
2 Field Feldname

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard


SetFldProperty(Form,Control,Property,[Value])

Setzt eine Eigenschaft eines Formularfeldes

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer
2 Control Feldname
3 Property Eigenschaft
4 Value Optional: Inhalt

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Eine Beispiel finden Sie im Verzeichnis Makro / Beispiele / Grid Handling
z.B.: Buttontext ändern
.....
SetFldProperty(Form, "[Kommandoname des Buttons]", "Value", "Das ist der neue Buttontext");
.....
Eine Beispiel finden Sie im Verzeichnis Makro / Beispiele / Register setzen
z.B.: Unterregister Vertrieb setzen
....
SetFldProperty(Form, "Kundenselect", "Page", "kundea17.for");
....
Eine Beispiel finden Sie im Verzeichnis Makro / Beispiele / FeldFarben
....
SetFldProperty(Form, "Feld", "Color", "0");
SetFldProperty(Form, "Feld", "BkgColor", "255");
....
Beispiel, Anlagedatei in den Bereich "Anhang" (42 Team) und Register Dokumente (42 ERP) einfügen:
....
File = fmt("{0}\memo.doc", GetDirectory(0));
SetFldProperty(Form, "Anhang", "AddItem", File);
ExecuteMenu("Speichern");
....
Beispiel, Filter im Kunden Auswahl-Register setzen:
.....
FilterSetzen()
{
    SetFldProperty(GetCurrentForm(), "Auswahl", "Filter", "Kunde.Name gleich 'Mustermann' und Kunde.Plz gleich '83026' ");
}
FilterLoeschen()
{
    SetFldProperty(GetCurrentForm(), "Auswahl", "Filter", "");
}
.....
Beispiel, Selektion im Kunden Auswahl-Register setzen:
.....
SelektionSetzen()
{
    SetFldProperty(GetCurrentForm(), "Auswahl", "Sort", "Kunde.Name:1;Kunde.Plz:0");
}
Eine Beispiel finden Sie im Verzeichnis Makro / Beispiele / Spreadsheet
......
SetFldProperty(Form, "SheetA", "Heights", "20, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100"); SetFldProperty(Form, "SheetA", "Widths", "20, 300, 50, 400"); SetFldProperty(Form, "SheetA", "Value;1;1", "Beispiel Funktion ABS()"); SetFldProperty(Form, "SheetA", "Value;3;1", "-100"); SetFldProperty(Form, "SheetA", "Value;2;1", "=ABS(C1)"); SetFldProperty(Form, "SheetA", "Value;1;3", "Beispiel Funktion COS()"); SetFldProperty(Form, "SheetA", "Value;3;3", "60"); SetFldProperty(Form, "SheetA", "Value;2;3", "=COS(C3*PI()/180)");
........
Beispiel für das setzen von Propertys für Buttons:
// Eigenschaft Einfärben
SetFldProperty(Form, "ButtonTest", " ImageColor ", "16711680");
// der Farbwert muß als Integer angegeben werden. Mit der Makro-Funktion RGB() können Sie diesen entsprechend ermitteln
// Eigenschaft Bild
SetFldProperty(Form, "ButtonTest", " Image ", "arrow-dd.svg");
// Eigenschaft Quelle
SetFldProperty(Form, "ButtonTest", " Source ", "Datei");
// Eigenschaft Erscheinung
// 0 = (Text)
// 1 = Bild
// 2 = Text & Bild
SetFldProperty(Form, "ButtonTest", " Appereance ", "2");
// Eigenschaft Beschreibung
SetFldProperty(Form, "ButtonTest", " Description ", "Makrobeschreibung");
// Eigenschaft Bildposition
// 0 = (Links)
// 1 = Rechts
// 2 = Oben
SetFldProperty(Form, "ButtonTest", " ImageLocation ", "1");

SetFormMakro(Form,MacroName)

Setzen das zugehörige Makro zu einem Formular

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer
2 MacroName Name des Makros

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard


SetFormPage(Form,[Page])

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer
2 Page Optional: Seitennummer 0-[Anzahl Register]

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard


SetModifiedFlag(Form,Modified)

Setzt das Modifiedflag eines Formulars

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer
2 Modified 0:Unverändert, 1:Verändert

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

42 Makro Runtime


ShowMessage(Form,[Text],[Value],[Typ],[Event])

Zeigt eine Nachricht in der Meldungsleiste an

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer (wenn leer, dann wird die Meldungsleiste des Hauptfensters verwendet)
2 Text Optional: Anzuzeigender Text
3 Value Optional: 0:Übersetzen 1:Babelfish deaktivieren
4 Typ Optional: [0:Information], 1:Direkt, 2:Warnung, 3:Fehler, 4:Systemfehler
5 Event Optional: Eventparameter für Aktionen wie z.B. Öffnen etc. OnMessageBar()

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard


StartEdit(Form)

Startet den Erfassungsmodus im Formular, wenn möglich.

Parameter

Nr. Parameter Beschreibung
1 Form Formularnummer

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard