Formular
Diese Datei dokumentiert alle Makrofunktionen der Kategorie Formular.
Inhaltsverzeichnis
- CloseForm(Form)
- DataCommand(Form,Result,[DataCmd],[Data])
- EnterValue(Form,Field,[Value])
- GetCurrentForm()
- GetFldData(Form,Field,[PlainText])
- GetFldName(Wnd)
- GetFldProperty(Form,Control,Property,[Plaintext])
- GetFldWnd(Form,Field)
- GetFormDocument(Form)
- GetFormWindow(Form)
- GetFrmName(Form)
- GetModifiedFlag(Form)
- HideMessage(Form,[Text],[Value])
- PressButton(Form,Command)
- SetFldData(Form,Field,[Value],[Unmask])
- SetFldFocus(Form,Field)
- SetFldProperty(Form,Control,Property,[Value])
- SetFormMakro(Form,MacroName)
- SetFormPage(Form,[Page])
- SetModifiedFlag(Form,Modified)
- ShowMessage(Form,[Text],[Value],[Typ],[Event])
- StartEdit(Form)
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