Zum Hauptinhalt springen

handle

handle Deskriptor

Der Begriff handle hat im CONZEPT 16- Editor die folgenden Bedeutungen:

Datentyp​

Der Datentyp handle ist ein spezieller Datentyp für Deskriptoren. Variablen vom Typ handle sind vollständig kompatibel zum Datentyp int. Alle entsprechenden Spezifikationen zum Datentyp handle können der Dokumentation unter int entnommen werden.

Durch die Verwendung des eigenen Datentyps für Deskriptoren ist es möglich, eigene sub-Funktionen, die einen Deskriptor als ersten Parameter erwarten, mit dem Pfeiloperator aufzurufen. Aufrufe in Form von

Function(tHandle, tA, tB)

können also auch im folgenden Format angegeben werden:

tHandle->Function(tA, tB)

Typumwandlung bei COM-Aufrufen​

Mit dem Schlüsselwort handle wird bei der Übergabe von Parametern an Methoden oder Eigenschaften von COM-Objekten ein Deskriptor gekennzeichnet.

Beispiel:

tCellStart # tComWorksheet->cphCell(1, 1);
tCellEnd   # tComWorkSheet->cphCell(10, 2);
tComRange  # tComWorksheet->cphRange(handle tCellStart, handle tCellEnd);

In diesem Beispiel wird ein Bereich markiert, der anschließend mit Werten gefüllt oder ausgelesen werden kann. Wird in diesem Fall handle weggelassen, würde der Deskriptor falsch interpretiert werden.