get_handle_object — Zurückgeben eines über einen Schlüssel referenzierten ikonischen Objekts eines Handles
get_handle_object liefert das ikonische Objekt, das von dem Schlüssel
Key in Handle referenziert wird, in
Object zurück.
Die Liste der von einem Handle unterstützten Schlüssel und ihrer Typen kann
zuvor mit get_handle_param abgerufen werden.
Zu beachten ist, dass get_handle_object 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.
Object (output_object) object(-array) → object
Vom Schlüssel referenziertes ikonisches Objekt.
Handle (input_control) handle → (handle)
Handle, dessen Eigenschaft abgerufen werden soll.
Key (input_control) string → (string / integer)
Abzurufender Schlüssel.
Sind die Parameterwerte korrekt, dann liefert
get_handle_object den Wert 2 (H_MSG_TRUE).
Falls das Handle ungültig ist, den übergebenen Schlüssel nicht
unterstützt oder der Schlüssel ein Tupel referenziert,
wird eine Fehlerbehandlung durchgeführt.
Foundation