get_handle_tuple
— Zurückgeben eines über einen Schlüssel referenzierten Tupels eines Handles.
get_handle_tuple
liefert das Tupel, das von dem Schlüssel
Key
in Handle
referenziert wird, in
Tuple
zurück.
Die Liste der von einem Handle unterstützten Schlüssel kann
zuvor mit get_handle_param
abgerufen werden.
Zu beachten ist, dass get_handle_tuple
nur für die Implementierung
generischer Inspektions- und Debugmechanismen gedacht ist.
Die für ein Handle zurückgegebenen Schlüssel können sich auch ohne weitere
Ankündigung ändern.
Weiterhin werden manche Handletypen und Handleeigenschaften von diesem
Mechanismus eventuell nicht unterstützt.
Dieser Mechanismus ist nicht auf Performanz optimiert.
Um die Eigenschaften von Handles zuverlässig abzufragen, etwa zum
Steuern des weiteren Programmablaufs, wird empfohlen, die jeweils
auf einen Handletyp spezialisierten Operatoren wie
get_object_model_3d_params
oder get_shape_model_params
zu verwenden.
Handle
(input_control) handle →
(handle)
Handle, dessen Eigenschaft abgerufen werden soll.
Key
(input_control) string →
(string / integer)
Abzurufender Schlüssel.
Parameteranzahl: Key == 1
Restriktion: length(Key) > 0
Tuple
(output_control) tuple(-array) →
(string / integer / real)
Vom Schlüssel referenzierte Tupeldaten.
Sind die Parameterwerte korrekt, dann liefert
get_handle_tuple
den Wert 2 (H_MSG_TRUE).
Falls das Handle ungültig ist, den übergebenen Schlüssel nicht
unterstützt oder der Schlüssel ein ikonisches Objekt referenziert,
wird eine Fehlerbehandlung durchgeführt.
get_handle_param
,
get_handle_object
Foundation