DialogChoiceMessageBox   

Beschreibung:

Zeigt einen Dialog zur Auswahl von übergebenen Einträgen an.

      

Hinweis: Weitere Informationen zu den zu verwendenden Konstanten und Rückgabewerten finden sich im Kapitel Script-Konstanten.

Parameter:

Parametername

Typ

Beschreibung

sMessage

String

Nachricht des Dialogs.

sTitle

String

Titel des Dialogs.

sChoices

String

Bestimmt die zur Verfügung stehenden Einträge, getrennt durch das TAB-Zeichen ("vbTab" in VBScript bzw. "\t" in C#-Script). Eine oder mehrere weitere Zeilen pro Eintrag sowie deren Aussehen können bestimmt werden, getrennt durch Umbruchskonstanten.

 

Umbruchskonstanten:

- Neue Zeile mit kleinerer Schriftgröße und zusätzlicher Leerzeile am Anfang: "vbCrLf" in VBScript bzw. "\r\n" in C#-Script

- Neue Zeile mit gleicher Schriftgröße: "vbCr" in VBScript bzw. "\r" in C#-Script

- Neue Zeile mit kleinerer Schriftgröße: "vbLf" in VBScript bzw. "\n" in C#-Script

 

Hinweis: Die Verwendung unterschiedlicher Umbruchskonstanten innerhalb ein und desselben Eintrags wird nicht empfohlen, unterschiedliche für verschiedene Einträge sind jedoch möglich.

nIcon

Long

Bestimmt das neben der Auswahl dargestellte Symbol:

1: Information

2: Warnung

3: Fehler

4: Schild

5: Frage

bEnableCancel

Bool

Bestimmt, ob eine "Abbrechen"-Schaltfläche angezeigt werden soll.

nParentHandle

Long

Optional. Handle eines Fensters, das als Parent-Fenster für den Dialog verwendet werden soll. Voreinstellung: das combit CRM-Hauptfenster, sofern es nicht unsichtbar ist, ansonsten das in dem Augenblick gerade aktive Vordergrundfenster.

Rückgabewert:

Long bzw. uint (der Rückgabewert entspricht den Konstanten einer MsgBox unter VBScript). Wenn der Nutzer eine Auswahl getroffen hat, dann wird ein OffSet von 100 einberechnet, d. h. bei Klick der zweiten Auswahl ist der Rückgabewert 102.

Beispiel VBScript:

Dim nResult : nResult = cRM.DialogChoiceMessageBox("Welcher Mitarbeiter soll als Verantwortlicher eingetragen werden?", "Auswahl Verantwortlicher", "Thomas Held" & vbLf & "Management" & vbTab & "Laura Frisch" & vbLf & "Marketing" & vbTab & "Lisa Nett" & vbLf & "Sales", 5, True)

Beispiel C#-Script:

long result = cRM.DialogChoiceMessageBox("Welche:r Mitarbeiter:in soll als Verantwortliche:r eingetragen werden?", "Auswahl Verantwortliche:r", "Thomas Held" + "\n" + "Management" + "\t" + "Laura Frisch" + "\n" + "Marketing" + "\t" + "Lisa Nett" + "\n" + "Sales", 5, true);

Hinweis: In TypeScript steht eine Überladung dieser Methode für den Parameter "sChoices" als String-Array "String[]" zur Verfügung. Statt

cRM.DialogChoiceMessageBox("sMessage", "STitle", "Thomas Held" + "\n" + "Management" + "\t" + "Laura Frisch" + "\n" + "Marketing" + "\t" + "Lisa Nett" + "\n" + "Sales", 5, true);

kann also alternativ

var sChoices:string[] = new Array("Thomas Held" + "\n" + "Management","Laura Frisch" + "\n" + "Marketing","Lisa Nett" + "\n" + "Sales")

cRM.DialogChoiceMessageBox("sMessage", "sTitle", sChoices, 5, true);

verwendet werden. Vergleichen Sie hierzu die Beschreibung des Parameters 'sChoices'.