TimeControl (Zeitangabe)

Das TimeControl ist ein spezielles Kombinationsfeld, das zur Darstellung der Reaktionszeit und der Lösungszeit verwendet wird.

Um die Zeitpunkte zu berechnen, verwendet helpLine einen internen Kalender, auf den das TimeControl automatisch zugreift.

Abbildung 1. Beispiel für ein TimeControl:


Tipp: Zum Darstellen einer Zeitangabe, die nicht auf dem internen Kalender basiert, verwenden Sie stattdessen den DateTimePicker oder das TimeCallControl für die Anrufzeit. Diese Controls greifen nicht auf den internen Kalender zu.

Der Benutzer kann im TimeControl beliebige Zeiträume eingeben. Die Angaben müssen lediglich einem gängigen Format entsprechen.

Um einen Zeitraum von 5 Stunden einzutragen, kann der Agent einen der folgenden Werte eingeben:

5 Stunden

5 Std

Eigenschaften

Neben den Standard-Eigenschaften hat dieses Control die folgenden Eigenschaften:

Text

Diese Eigenschaft gibt den im Control eingegebenen Wert an. Sie wird im Rahmen des Scriptings verwendet, um den Zeitpunkt im Control aus einem Skript heraus zu setzen bzw. um den in einem Control gesetzten Zeitpunkt in einem Skript zu verwenden.

Typ Ganze Zahl
Werte Zahl: mitgezählter Zeitraum in Sekunden

Sie können zu Testzwecken während des Designs des Dialogs ein Datum in das Control eingeben. Der Wert wird jedoch nicht gespeichert.

Methoden

AddItem

Diese Methode fügt einen Eintrag als Text am Ende der Dropdownliste ein.

Syntax AddItem(Item)
Parameter Item: Text, der in der Dropdownliste als neuer Eintrag eingefügt werden soll.
Rückgabewert Zahl: Index des eingefügten Eintrags.

Die Indizes der Einträge sind dabei nullbasiert, d. h. der erste Eintrag hat den Index 0, der zweite den Index 1, etc.

InsertItem

Diese Methode fügt einen Texteintrag an der angegebenen Position der Dropdownliste ein.

Syntax InsertItem(Index,Item)
Parameter Index: Index der Position, an der der neue Eintrag (Item) eingefügt werden soll.

Item: Text, der in der Dropdownliste an der angegebenen Position (Index) als neuer Eintrag eingefügt werden soll.
Rückgabewert Zahl: Index des hinzugefügten Eintrags, im Fehlerfall „-1“.

Die Indizes der Einträge sind dabei nullbasiert, d. h. der erste Eintrag hat den Index 0, der zweite den Index 1, etc.
Anmerkung: Wenn der Index die Anzahl der Einträge in der Dropdownliste übersteigt, wird kein neuer Eintrag eingefügt.

DeleteItem

Diese Methode löscht den angegebenen Eintrag aus der Dropdownliste.

Syntax DeleteItem(Index)
Parameter IndexIndex der Position des Eintrags, der gelöscht werden soll. Die Indizes der Einträge sind nullbasiert, d. h. der erste Eintrag hat den Index 0, der zweite den Index 1 usw.
Beispiel 1 Im TimeControl „timecontrol1“ soll der erste Eintrag gelöscht werden:

timecontrol1.DeleteItem(0)
Beispiel 2 Im TimeControl „timecontrol1“ soll der letzte Eintrag gelöscht werden:

count = timecontrol1.GetItemsCount() (=Anzahl der Einträge, siehe Kapitel GetItemsCount)

timecontrol1.DeleteItem (count -1)
Anmerkung: Nach dem Löschen des Eintrags werden alle folgenden Einträge um eine Position nach vorne verschoben, so dass die Lücke in den Indizes aufgefüllt wird.

SelectItem

Diese Methode wählt den angegebenen Eintrag aus der Dropdownliste aus.

Syntax SelectItem(Typ,Wert)
Parameter Typ:Zahl (0 oder 1), die angibt, welche Bedeutung der Parameter „Wert“ hat.

0 = Der Parameter „Wert“ gibt den Index des Eintrags an, der ausgewählt werden soll.

1 = Der Parameter „Wert“ gibt die ID des Eintrags an, der ausgewählt werden soll.

Wert: Index oder ID des Eintrags, der aus der Dropdownliste ausgewählt werden soll.

Die Indizes der Einträge sind dabei nullbasiert, d. h. der erste Eintrag hat den Index 0, der zweite den Index 1, etc.

GetItemsCount

Diese Methode ermittelt die Anzahl der Einträge in der Dropdownliste.

Syntax GetItemsCount
Rückgabewert Zahl: Anzahl der Einträge in der Dropdownliste.

Tastenkombinationen

Für dieses Control stehen keine Tastenkombinationen zur Verfügung.