Makro

Diese Datei dokumentiert alle Makrofunktionen der Kategorie Makro.

Inhaltsverzeichnis

• ActivateApp(String)
• BabelFish(Text)
• BindLib(Zugriffsname,Makroname)
• CheckData(Name,[Kontext])
• CheckWait()
• CloseDatabase()
• CloseWait()
• cls()
• Convert(Text,Ausgabeformat,[Dekonvert])
• CreateDataUrl([Dokumentart],[Id],[Beschreibung],[Feldname],[ParameterName],[Parameterwert])
• CreateGuid([Art])
• CreatePdf(Richtext,PDFFilename,[PDF/A])
• CurrentFile()
• DBDate(Datum)
• DecToHex()
• EnableMask([Enable])
• EnableMsg([Activate])
• EnableRTF([Enable])
• EventLog(Meldung,[Dienstname])
• ExecuteLib(Zugriffsname,Function,[Par1],[Par2],[Par3],[Par4],[Par5],[unmask])
• ExecuteMacro(Name,[Function],[Par1],[Par2],[Par3])
• ExecuteMenu(Item,[Keys],[Button],[Delay])
• ExecuteShell(Application,[Mode],[Params],[Path],[Show])
• GetActiveDocuments()
• GetActiveDocumentValue(Name,[IdFilter])
• GetComputerName()
• GetConverters()
• GetData(Name,[Kontext],[Format])
• GetDataFields(Name,[Kontext])
• GetDirectory(Art)
• GetJsonParameter(Json,Name,[Format])
• GetPrinter()
• GetPrinterList()
• GetProfileString(Dateiname,Sektion,Name,[Standardwert])
• GotoUrl(Url)
• GuidToHex(Guid)
• GVGet(Name)
• GVSet(Name,[Value])
• HexToDec()
• HexToGuid(Guid)
• IsActiveDocumentValue()
• IsConverter(Ausgabeformat)
• LastError()
• LicenseInfo(Name)
• LVGet(Name)
• LVSet(Name,Value)
• MandantInfo(Info,[Mandantname])
• MergeText(Template,[DataUrl])
• MessageBeep([Type])
• MessageBox([Text],[Titel],[Buttons],[Button],[DonsAskAgain],[Prompt Zeilen])
• NewDocument(Dokumentart,[Info],[NeuesFenster])
• OpenDatabase()
• OpenDocument(Dokumentart,Schlüsselwert,[Schlüsselfeld],[NewWindow])
• OpenWait([Text],[Max],[Option],[Delay])
• Perform(Content)
• PerformFile(Name)
• PlaySound(Name)
• print(Text,[Cr],[Color],[Bold],[Delay],[ScrollToEnd])
• RegisterConverter(Name,Makro,Handler)
• RegisterDocMenu(Text)
• RegisterDocType(Name,[UniqueKey],[MltKey],[CanNew],[CanOpen],[CanSave],[MenuEntry])
• RegisterSmartfields(Name,Makro,Handler,SmartFelder,[Feldtyp],[Feldlänge],[Ausgabeformat],[Steuerelement],[Masterfelder])
• RGB(Rot,[Grün],[Blau])
• RouteCommand(Kommando,Funktion,UserValue)
• RtfAppend(Richtext,Richtext)
• RtfReplace(Richtext,Source,[Destination])
• RtfToHTML(Richtext)
• RtfToText(Richtext)
• SetData(Name,Wert,[Kontext],[Format])
• SetDocType(Document)
• SetLocalVars(Text)
• SetPrinter([PrinterName])
• SetProfileString(Dateiname,Sektion,Name,[Wert])
• SetWaitText([Text],[Art])
• Sleep(Seconds,[Milliseconds])
• StartList(Report,Preview,[Printer],[Orientation],[Tray],[Duplex],[Color])
• StartListOpt(Report,Preview,Options)
• StartLocalTimer([Intervall])
• StartMail([Template],[Table])
• StartText([Template])
• StartTimer([Intervall])
• StopLocalTimer()
• StopTimer()
• UrlDecode(Url)
• UrlEncode(Url)

ActivateApp(String)

Aktiviert eine laufende Anwendung

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

BabelFish(Text)

Übersetzt einen Text mit dem aktiven Dictionary

Parameter

Rückgabewert

Übersetzung, wenn möglich - sonst formatierter Text in selber Sprache

Verfügbarkeit

Standard

BindLib(Zugriffsname,Makroname)

Bindet eine Makrobibliothek an das aktuelle Makro. Mit LibExecute können einzelne Funktionen aus dieser Bibliothek aufgerufen werden

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in den Dateien 42Library.42m und 42LibTest.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
Main()
{
    BindLib("42Lib", "42Library");
    Erg = ExecuteLib ("42Lib", "Frage");
}
Makro: 42Library
Main()
{
}
Frage()
{
    return(MessageBox("Wollen Sie speichern?", "Frage", "YESNO", 1));
}

CheckData(Name,[Kontext])

Ermittelt das Vorhandensein eines Felds im aktuellem Datenkontext des Makros (Liste, Dokument, etc.)

Parameter

Rückgabewert

1:Gültiges Feld, 0:Feld nicht definiert

Verfügbarkeit

42 Makro Runtime

CheckWait()

Benutzerabbruch des Wartefensters prüfen

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

0:Benutzerabbruch, 1:Fortsetzen

Verfügbarkeit

Standard

CloseDatabase()

Öffnet die Verbindung zur Datenbank für den aktuellen Mandanten

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

CloseWait()

Schließt das Wartefenster

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Funktionen um eine Statusmeldung auf dem Bildschirm auszugeben. ..... // Öffnen des Wartenfensters OpenWait (); // Schleifenwerte setzen Anzahl = 100; a = 1; // Zählschleife

while (a <= Anzahl)
{
    // Text ausgeben "Aktueller Datensatz = 1"
    SetWaitText ("Aktueller Datensatz = " + a);
    // eine Sekunde warten
    Sleep(1);
    // Zähler erhöhen
    a = a + 1;
}
// Fenster schließen
CloseWait ();
// Piepston ausgeben
MessageBeep (0);
.....
eine weiteres Beispiel finden Sie unter Makro / Beispiele / Wartefenster

cls()

Löscht die Ausgaben auf dem Makromonitor

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Convert(Text,Ausgabeformat,[Dekonvert])

Konvertiert einen Wert in ein bestimmtes Ausgabeformat

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

CreateDataUrl([Dokumentart],[Id],[Beschreibung],[Feldname],[ParameterName],[Parameterwert])

Erstellt eine Daten-Url

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

42 Makro Runtime

CreateGuid([Art])

Erzeugt eine weltweit eindeutige ID

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in der Datei 42Makro.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
Main()
{
    Erg = CreateGuid(0);
    print("internes Format = "+Erg);
    Erg = CreateGuid(1);
    print("Datenbankformat = "+Erg);
}

CreatePdf(Richtext,PDFFilename,[PDF/A])

Erstellt eine PDF-Datei aus einem Richtext

Parameter

Rückgabewert

1:OK, 0:Fehler

Verfügbarkeit

42 Makro Runtime

CurrentFile()

Liefert den Dateinamen der ausführenden Makros

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

DBDate(Datum)

Formatiert ein Datum ins aktuelle Datenbankformat

Parameter

Rückgabewert

Datum im gültigen Format der aktiven Datenbank

Verfügbarkeit

Standard

Beispiel

Main()
{
    erg = DBDate(SysDate());
    print("Ergebnis ="+erg);
}

DecToHex()

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Main()
{
    erg = DecToHex("10");
    print("Ergebnis = "+erg);
}

EnableMask([Enable])

Aktiviert oder Deaktiviert den Maskierungsmodus im aktiven Makro. (Escape-Sequenzen)

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

EnableMsg([Activate])

Aktiviert oder verhindert die Anzeige von Meldungen

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

EnableRTF([Enable])

Aktiviert oder Deaktiviert den Richtextmodus in GetFld(), GetFldData(), GetFldProperty()

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

EventLog(Meldung,[Dienstname])

Hinterlegt eine Systemmeldung im Windows Event-Management

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in der Datei 42EventLog.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
Main()
{
    EventLog("42 Software Event Message", "42 ERP");
}

ExecuteLib(Zugriffsname,Function,[Par1],[Par2],[Par3],[Par4],[Par5],[unmask])

Ruft eine Funktion aus einer gebundenen Makrobibliothek auf

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in den Dateien 42Library.42m und 42LibTest.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
Main()
{
    BindLib ("42Lib", "42Library");
    Erg = ExecuteLib("42Lib", "Frage");
    ExecuteLib("42Lib", "Achtung");
    Erg1 = ExecuteLib("42Lib", "sqldate", SysDate());
    print("Ergebnis = "+Erg1);
    Erg2 = ExecuteLib("42Lib", "WriteTextInFile", "Dies ist ein Beispieltext");
    if(Erg2)
        MessageBox("Der Text wurde erfolgreich in die Datei geschrieben!", "Funktion WriteInFile");
}

ExecuteMacro(Name,[Function],[Par1],[Par2],[Par3])

Startet ein Makro oder eine einzelne Funktion daraus

Parameter

Rückgabewert

Rückgabewert des Makros

Verfügbarkeit

Standard

ExecuteMenu(Item,[Keys],[Button],[Delay])

Führt eine Menüfunktion mit entsprechenden Namen aus. Danach wird eine Tastenfolge realisiert und auf Wunsch ein Abschlußkommando versendet. Es stehen jeweils die gültigen Systembefehle aus der Hauptmenüleiste zur Verfügung

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

ExecuteShell(Application,[Mode],[Params],[Path],[Show])

Starten von Windows-Anwendungen oder Dokumenten

Parameter

Rückgabewert

Ermittelt den Handle auf die geöffnete Applikation > 32, wenn erfolgreich

Verfügbarkeit

Standard

Beispiel

Main()
{
    File = strcat (GetDirectory (14), "\Notiz.txt");
    fnr = OpenFile (File, 2|4096);
    if(fnr)
    {
        CloseFile (fnr);
        AppendFile (File, "Software");
        ExecuteShell("notepad.exe", "open", File, GetDirectory(14), "normal");
    }
}
Main()
{
    // bei registrierten Windows Applikationen ist eine direkte Angabe von Pfad- und Dateiname möglich
    ExecuteShell("C:\42 Software\ERP\ERP.pdf");
}

GetActiveDocuments()

Ermittelt eine Liste der aktiven Dokumente

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Dokumentliste

Verfügbarkeit

42 Makro Runtime

GetActiveDocumentValue(Name,[IdFilter])

Ermittelt einen Feldinhalt eines aktiven Dokuments

Parameter

Rückgabewert

Feldinhalt

Verfügbarkeit

42 Makro Runtime

GetComputerName()

Liefert den Namen des Computers

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Main()
{
    erg = GetComputerName();
    print("Ergebnis = "+erg);
}

GetConverters()

Liefert eine Liste der verfügbaren Konverterfelder

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

42 Makro Runtime

GetData(Name,[Kontext],[Format])

Ermittelt den Wert eines Felds im aktuellem Datenkontext des Makros (Liste, Dokument, etc.)

Parameter

Rückgabewert

Wert

Verfügbarkeit

42 Makro Runtime

GetDataFields(Name,[Kontext])

Ermittelt eine Feldliste in einen gewünchten Datenkontext (Liste, Dokument, etc.)

Parameter

Rückgabewert

Feldliste

Verfügbarkeit

42 Makro Runtime

GetDirectory(Art)

Liefert den entsprechenden Systempfad

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Main()
{
    erg = GetDirectory(0);
    print("Art 0 = "+erg);
    erg = GetDirectory(1);
    print("Art 1 = "+erg);
    erg = GetDirectory(2);
    print("Art 2 = "+erg);
    erg = GetDirectory(3);
    print("Art 3 = "+erg);
    erg = GetDirectory(4);
    print("Art 4 = "+erg);
    erg = GetDirectory(5);
    print("Art 5 = "+erg);
    erg = GetDirectory(6);
    print("Art 6 = "+erg);
    erg = GetDirectory(7);
    print("Art 7 = "+erg);
    erg = GetDirectory(8);
    print("Art 8 = "+erg);
    erg = GetDirectory(9);
    print("Art 9 = "+erg);
    erg = GetDirectory(10);
    print("Art 10 = "+erg);
    erg = GetDirectory(11);
    print("Art 11 = "+erg);
    erg = GetDirectory(12);
    print("Art 12 = "+erg);
    erg = GetDirectory(13);
    print("Art 13 = "+erg);
    erg = GetDirectory(14);
    print("Art 14 = "+erg);
    erg = GetDirectory(15);
    print("Art 15 = "+erg);
}

GetJsonParameter(Json,Name,[Format])

Liest einen Wert aus einem JsonString

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

42 Makro Runtime

GetPrinter()

Liefert den aktuellen Drucker

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

GetPrinterList()

Liefert eine Liste der verfügbaren Drucker

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

42 Makro Runtime

GetProfileString(Dateiname,Sektion,Name,[Standardwert])

Ermittelt einen Eintrag aus einer Profildatei

Parameter

Rückgabewert

Aktueller Wert

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in der Datei 42Profile.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
Main()
{
    SetProfileString ("42Software.ini", "42Sektion", "42Eintrag", "42 Software GmbH");
    Erg = GetProfileString("42Software.ini", "42Sektion", "42Eintrag");
    print("Eintrag aus Profildatei = "+Erg);
}

GotoUrl(Url)

Ruft eine HTML-Seite auf oder verarbeitet diese intern

Parameter

Rückgabewert

:0 Externer Browser, 1:Intern verarbeitet

Verfügbarkeit

Standard

GuidToHex(Guid)

Konvertiert eine Guid von Guid- in Hex-Format

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Main()
{
    erg = GuidToHex(CreateGuid(1));
    print("Ergebnis = "+erg);
}

GVGet(Name)

Ermittelt den einer globalen Variable

Parameter

Rückgabewert

Wert

Verfügbarkeit

Standard

Beispiel

Main()
{
    GVSet ("GlobalVar", "Mein globaler Wert");
    GlobaleVariable();
}
GlobaleVariable()
{
    erg = GVGet("GlobalVar");
    MessageBox (fmt ("Inhalt der globalen Variablen: \"{0}\"", erg), "Globale Variable");
}

GVSet(Name,[Value])

Setzt eine globale Variable

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Main()
{
    GVSet("GlobalVar", "Mein globaler Wert");
    GlobaleVariable();
}
GlobaleVariable()
{
    erg = GVGet ("GlobalVar");
    MessageBox (fmt ("Inhalt der globalen Variablen: \"{0}\"", erg), "Globale Variable");
}

HexToDec()

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

HexToGuid(Guid)

Konvertiert eine Guid von Hex- in Guid-Format

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Main()
{
    erg = HexToGuid(GuidToHex (CreateGuid (1)));
    print("Ergebnis = "+erg);
}

IsActiveDocumentValue()

Ermittelt, ob das Dokument bzw. der Feldinhalt als aktives Dokument verfügbar ist

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

1:OK, 0:Fehler

Verfügbarkeit

42 Makro Runtime

IsConverter(Ausgabeformat)

Prüft das Vorhandensein eines Konverters

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

42 Makro Runtime

LastError()

Liefert den Fehlertext des zuletzt aufgetretenen Fehlers

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Fehlertext

Verfügbarkeit

Standard

LicenseInfo(Name)

Liefert Informationen zur Programmlizenz

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in der Datei 42Makro.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
Main()
{
    Erg = LicenseInfo("Customer");
    print("Lizenzname = "+Erg);
    Erg1 = LicenseInfo("User");
    print("Anzahl Lizenzen = "+Erg1);
    Erg2 = LicenseInfo("Info");
    print("Lizenzinfo = "+Erg2);
    Erg3 = LicenseInfo("majorversion");
    print("major = "+Erg3);
    Erg4 = LicenseInfo("minversion");
    print("minor = "+Erg4);
}
Die komplette Versionsnummer können Sie mit GetData("version", "system"); ermitteln.

LVGet(Name)

Ermittelt den Wert einer lokalen Variable

Parameter

Rückgabewert

Wert

Verfügbarkeit

Standard

Beispiel

Main()
{
    LVSet ("LokalVar", "Mein lokaler Wert");
    erg = LVGet("LokalVar");
    MessageBox (fmt ("Inhalt der lokalen Variablen: \"{0}\"", erg), "Globale Variable");
}

LVSet(Name,Value)

Setzt den Wert einer lokalen Variable

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Main()
{
    LVSet("LokalVar", "Mein lokaler Wert");
    erg = LVGet ("LokalVar");
    MessageBox (fmt ("Inhalt der lokalen Variablen: \"{0}\"", erg), "Globale Variable");
}

MandantInfo(Info,[Mandantname])

Liefert die Systemkonfiguration eines Mandanten wie z.B. den Namen der SQL Datenbank

Parameter

Rückgabewert

Wert

Verfügbarkeit

Standard

Beispiel

Main()
{
    erg = MandantInfo("Name");
    print("Ergebnis = "+erg);
    erg = MandantInfo("PathArchiv");
    print("Ergebnis = "+erg);
    erg = MandantInfo("PathData");
    print("Ergebnis = "+erg);
    erg = MandantInfo("PathDocs");
    print("Ergebnis = "+erg);
    erg = MandantInfo("PathRemoteArchiv");
    print("Ergebnis = "+erg);
    erg = MandantInfo("PathRemoteData");
    print("Ergebnis = "+erg);
    erg = MandantInfo("PathRemoteDocs");
    print("Ergebnis = "+erg);
    erg = MandantInfo("OwnLists");
    print("Ergebnis = "+erg);
    erg = MandantInfo("OwnForms");
    print("Ergebnis = "+erg);
    erg = MandantInfo("SqlDataSource");
    print("Ergebnis = "+erg);
    erg = MandantInfo("SqlDataName");
    print("Ergebnis = "+erg);
    erg = MandantInfo("SqlDbName");
    print("Ergebnis = "+erg);
    erg = MandantInfo("SqlDbPassword");
    print("Ergebnis = "+erg);
    erg = MandantInfo("SqlDbUser");
    print("Ergebnis = "+erg);
    erg = MandantInfo("Exist");
    print("Ergebnis = "+erg);
}

MergeText(Template,[DataUrl])

Erstellt einen Text via Textvorlage und füllt Dokumentfelder aus.

Parameter

Rückgabewert

Richtext

Verfügbarkeit

42 Makro Runtime

MessageBeep([Type])

Standardsignale nach der Windows-Systemeinstellung

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

MessageBox([Text],[Titel],[Buttons],[Button],[DonsAskAgain],[Prompt Zeilen])

Nachrichtenfenster mit und ohne Benutzerabfrage

Parameter

Rückgabewert

OK,YES,NO,CANCEL,RETRY

Verfügbarkeit

Standard

Beispiel

MessageBox("Wollen Sie speichern?","Frage","YESNO",1,0);

NewDocument(Dokumentart,[Info],[NeuesFenster])

Öffnet ein neues Dokument

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Main()
{
    NewDocument("Kunde", "Auswahl", "1");
}

OpenDatabase()

Beendet die Datenbankverbindung des Mandanten

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

OpenDocument(Dokumentart,Schlüsselwert,[Schlüsselfeld],[NewWindow])

Öffnet und lädt ein Dokument mit Selektion

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Main()
{
    // Kundennummer
    OpenDocument(“Kunde“, “000012“, “Kundennummer“);
    // Datensatz-ID
    OpenDocument(“Kunde“, “ AC68DD3B-F6A0-4D4C-A7CD-D3D638B52BF5.KundeWawi“);
}

OpenWait([Text],[Max],[Option],[Delay])

Öffnet das Wartefenster

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Funktionen um eine Statusmeldung auf dem Bildschirm auszugeben. ..... // Öffnen des Wartenfensters OpenWait (); // Schleifenwerte setzen Anzahl = 100; a = 1; // Zählschleife

while (a <= Anzahl)
{
    // Text ausgeben "Aktueller Datensatz = 1"
    SetWaitText ("Aktueller Datensatz = " + a);
    // eine Sekunde warten
    Sleep(1);
    // Zähler erhöhen
    a = a + 1;
}
// Fenster schließen
CloseWait ();
// Piepston ausgeben
MessageBeep (0);
.....
eine weiteres Beispiel finden Sie unter Makro / Beispiele / Wartefenster

Perform(Content)

Führt ein dynamisches Makro aus und liefert den Rückgabewert des Makros

Parameter

Rückgabewert

Rückgabewert des Makros

Verfügbarkeit

Standard

PerformFile(Name)

Führt ein dynamisches Makro einer einer Datei aus und liefert den Rückgabewert des Makros

Parameter

Rückgabewert

Rückgabewert des Makros

Verfügbarkeit

Standard

PlaySound(Name)

Standardsounds nach der Windows-Systemeinstellung

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

print(Text,[Cr],[Color],[Bold],[Delay],[ScrollToEnd])

Gibt einen Text auf dem Makromonitor aus

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Main()
{
    print("Ohne Umbruch", 0);
    print("Teil2");
    print("Mit Umbruch", 1);
    print("Teil2");
    print("Fettdruck", 1, "", 1);
    print("Farbdruck", 1, "255");
    print("fetter Farbdruck", 1, "255", 1);
}

RegisterConverter(Name,Makro,Handler)

Registriert ein neues Ausgabeformat

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

RegisterDocMenu(Text)

Registiert ein Dokumentspezifisches Menü

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

RegisterDocType(Name,[UniqueKey],[MltKey],[CanNew],[CanOpen],[CanSave],[MenuEntry])

Registriert eine benutzerdefinierte Dokumentart

Parameter

Rückgabewert

1:OK, 0:Fehler

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in der Datei 42System.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
OnStartedSession()
{
    // Dokumentart mit Datenbankdefinition registrieren
    // Datenbankdefinition und Formulare finden Sie im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
    RegisterDocType("MakroTest", "XTabKey", "XMltKey", "1", "1", "1", "1");
    // Registierung für ein Dokumentspezifisches Menü
    RegisterDocMenu ("MakroTest");
    // Dokumentart ohne Datenbankdefiniton registrieren (Dokumentname = Formularname)
    // zum Test müssen Sie ein Formular mit dem Dateinamen MeineAuswertung.for" erstellen
    RegisterDocType("MeineAuswertung");
}

RegisterSmartfields(Name,Makro,Handler,SmartFelder,[Feldtyp],[Feldlänge],[Ausgabeformat],[Steuerelement],[Masterfelder])

Registriert Smartfelder mit Hilfe eines eigenen Konverters. Im Vergleich zu Konvertergestützten Feldern sind diese Felder eigenständige neue Datenfelder, die nicht in der Datenbank existieren. Es sind virtuelle Felder, die wie Datenbankfelder in Ansichten, Dokumenten und Listen dem Anwender zur Verfügung stehen und live per Konverter angezogen werden, ohne das sie physisch in der Datenbank existieren.

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

42 Makro Runtime

RGB(Rot,[Grün],[Blau])

Berechnet den RGB-Farbwert

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

RouteCommand(Kommando,Funktion,UserValue)

Registriert ein neues Kommandohandler

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

42 Makro Runtime

RtfAppend(Richtext,Richtext)

Erweitert einen Richtext um einen weiteren Richtext

Parameter

Rückgabewert

Formatierter Text

Verfügbarkeit

42 Makro Runtime

RtfReplace(Richtext,Source,[Destination])

Ersetzt im Richtext eine Zeichenfolge durch eine andere

Parameter

Rückgabewert

Formatierter Text

Verfügbarkeit

42 Makro Runtime

RtfToHTML(Richtext)

Konvertiert Richtext in HTML

Parameter

Rückgabewert

HTML-Code

Verfügbarkeit

Standard

RtfToText(Richtext)

Konvertiert Richtext in Klartext

Parameter

Rückgabewert

Klartext

Verfügbarkeit

Standard

SetData(Name,Wert,[Kontext],[Format])

Setzt einen Wert eines Felds im aktuellem Datenkontext des Makros (Liste, Dokument, etc.)

Parameter

Rückgabewert

1:OK, 0:Fehler

Verfügbarkeit

42 Makro Runtime

SetDocType(Document)

Legt die aktuelle Dokumentart fest

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

siehe auch GotoUrl
Main()
{
    SetDocType("Kunde");
    ExecuteMenu ("Neu");
}

SetLocalVars(Text)

Lokale Variablen aktivieren bzw. deaktivieren

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Main()
{
    SetLocalVars(0)
    LVSet ("LokalVar", "Mein lokaler Wert");
    GlobaleVariable();
}
GlobaleVariable()
{
    erg = LVGet ("LokalVar");
    MessageBox (fmt ("Inhalt der lokalen Variablen: \"{0}\"", erg), "Globale Variable");
}

SetPrinter([PrinterName])

Bestimmt einen Drucker [Standarddrucker] in der Druckerkonfiguration

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

SetProfileString(Dateiname,Sektion,Name,[Wert])

Erzeugt oder aktualisiert einen Eintrag in einer Profildatei

Parameter

Rückgabewert

1:OK, 0:Fehler

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in der Datei 42Profile.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
Main()
{
    SetProfileString("42Software.ini", "42Sektion", "42Eintrag", "42 Software GmbH");
    Erg = GetProfileString ("42Software.ini", "42Sektion", "42Eintrag");
    print("Eintrag aus Profildatei = "+Erg);
}

SetWaitText([Text],[Art])

Setzt den Text im Wartefenster

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Funktionen um eine Statusmeldung auf dem Bildschirm auszugeben. ..... // Öffnen des Wartenfensters OpenWait (); // Schleifenwerte setzen Anzahl = 100; a = 1; // Zählschleife

while (a <= Anzahl)
{
    // Text ausgeben "Aktueller Datensatz = 1"
    SetWaitText ("Aktueller Datensatz = " + a);
    // eine Sekunde warten
    Sleep(1);
    // Zähler erhöhen
    a = a + 1;
}
// Fenster schließen
CloseWait ();
// Piepston ausgeben
MessageBeep (0);
.....
eine weiteres Beispiel finden Sie unter Makro / Beispiele / Wartefenster

Sleep(Seconds,[Milliseconds])

Hält den Prozess für eine bestimmte Dauer an

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Funktionen um eine Statusmeldung auf dem Bildschirm auszugeben. ..... // Öffnen des Wartenfensters OpenWait (); // Schleifenwerte setzen Anzahl = 100; a = 1; // Zählschleife

while (a <= Anzahl)
{
    // Text ausgeben "Aktueller Datensatz = 1"
    SetWaitText ("Aktueller Datensatz = " + a);
    // eine Sekunde warten
    Sleep(1);
    // Zähler erhöhen
    a = a + 1;
}
// Fenster schließen
CloseWait ();
// Piepston ausgeben
MessageBeep (0);
.....
eine weiteres Beispiel finden Sie unter Makro / Beispiele / Wartefenster

StartList(Report,Preview,[Printer],[Orientation],[Tray],[Duplex],[Color])

Startet den Listendruck, die Vorschau oder die PDF-Ausgabe.

StartList() ist weiterhin gültig, bietet jedoch weniger Steuerungsmöglichkeiten als StartListOpt(). Insbesondere kann das Erscheinen des Teilen-Dialogs mit StartList() nicht explizit gesteuert werden.

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Main()
{
}
OnCommand(Form, Cmd)
{
    if(stricmp(Cmd, "&drucken") == 0)
    {
        druck(Form, 0);
        return(1);
    }
    if(stricmp(Cmd, "drucken &vorschau") == 0)
    {
        druck(Form, 1);
        return(1);
    }
    return(0);
}
druck(Form, preview)
{
    StartList("chef.lst", preview);
}

StartListOpt(Report,Preview,Options)

Startet den Listendruck, die Vorschau oder die PDF-Ausgabe mit zusätzlichen Optionen.

Parameter

Die Property-Liste wird mit SetProperty aufgebaut. Die dort unter Propertys für Reports aufgeführten Optionen und Werte können für StartListOpt() verwendet werden.

Mit der Property pdfshowdialog kann das Erscheinen des Teilen-Dialogs für diesen Aufruf explizit gesteuert werden:

• 0 = Standard
• 1 = Anzeigen
• 2 = Verbergen

Die übergebenen Optionen gelten nur für den jeweiligen Aufruf von StartListOpt() und verändern nicht dauerhaft die Benutzereinstellungen für nachfolgende manuelle Druckvorgänge.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

StartLocalTimer([Intervall])

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

42 Makro Runtime

StartMail([Template],[Table])

Startet den Mailerstellung

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

42 Makro Runtime

StartText([Template])

Startet den Texterstellung

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

42 Makro Runtime

StartTimer([Intervall])

Startet den Makro-Timer, OnTimer() nur für Systemmakro möglich

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in der Datei 42System.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
OnStartedSession ()
{
    StartTimer("20");
}

StopLocalTimer()

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

42 Makro Runtime

StopTimer()

Beendet den Makro-Timer, OnTimer() nur für Systemmakro möglich

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in der Datei 42System.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
OnEndSession ()
{
    StopTimer();
}

UrlDecode(Url)

Decodiert Zeichen analog der Url-Regeln

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

42 Makro Runtime

UrlEncode(Url)

Kodiert Zeichen analog der Url-Regeln

Parameter

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Verfügbarkeit

42 Makro Runtime