get_handle_objectT_get_handle_objectGetHandleObjectGetHandleObjectget_handle_object (Operator)
Name
get_handle_objectT_get_handle_objectGetHandleObjectGetHandleObjectget_handle_object — Zurückgeben eines über einen Schlüssel referenzierten ikonischen Objekts eines Handles
Signatur
Herror T_get_handle_object(Hobject* Object, const Htuple Handle, const Htuple Key)
void GetHandleObject(HObject* Object, const HTuple& Handle, const HTuple& Key)
def get_handle_object(handle: HHandle, key: Union[str, int]) -> HObject
Beschreibung
get_handle_objectget_handle_objectGetHandleObjectGetHandleObjectGetHandleObjectget_handle_object liefert das ikonische Objekt, das von dem Schlüssel
KeyKeyKeyKeykeykey in HandleHandleHandleHandlehandlehandle referenziert wird, in
ObjectObjectObjectObjectobjectValobject zurück.
Die Liste der von einem Handle unterstützten Schlüssel und ihrer Typen kann
zuvor mit get_handle_paramget_handle_paramGetHandleParamGetHandleParamGetHandleParamget_handle_param abgerufen werden.
Zu beachten ist, dass get_handle_objectget_handle_objectGetHandleObjectGetHandleObjectGetHandleObjectget_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_paramsget_object_model_3d_paramsGetObjectModel3dParamsGetObjectModel3dParamsGetObjectModel3dParamsget_object_model_3d_params oder get_shape_model_paramsget_shape_model_paramsGetShapeModelParamsGetShapeModelParamsGetShapeModelParamsget_shape_model_params
zu verwenden.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
ObjectObjectObjectObjectobjectValobject (output_object) object(-array) → objectHObjectHObjectHObjectHobject *
Vom Schlüssel referenziertes ikonisches Objekt.
HandleHandleHandleHandlehandlehandle (input_control) handle → HHandle, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle, dessen Eigenschaft abgerufen werden soll.
KeyKeyKeyKeykeykey (input_control) string → HTupleUnion[str, int]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Abzurufender Schlüssel.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
get_handle_objectget_handle_objectGetHandleObjectGetHandleObjectGetHandleObjectget_handle_object den Wert 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.
Alternativen
get_handle_tupleget_handle_tupleGetHandleTupleGetHandleTupleGetHandleTupleget_handle_tuple
Siehe auch
get_handle_paramget_handle_paramGetHandleParamGetHandleParamGetHandleParamget_handle_param
Modul
Foundation