get_handle_tupleT_get_handle_tupleGetHandleTupleGetHandleTupleget_handle_tuple (Operator)
Name
get_handle_tupleT_get_handle_tupleGetHandleTupleGetHandleTupleget_handle_tuple — Zurückgeben eines über einen Schlüssel referenzierten Tupels eines Handles.
Signatur
Herror T_get_handle_tuple(const Htuple Handle, const Htuple Key, Htuple* Tuple)
void GetHandleTuple(const HTuple& Handle, const HTuple& Key, HTuple* Tuple)
def get_handle_tuple(handle: HHandle, key: Union[str, int]) -> Sequence[Union[int, float, str]]
def get_handle_tuple_s(handle: HHandle, key: Union[str, int]) -> Union[int, float, str]
Beschreibung
get_handle_tupleget_handle_tupleGetHandleTupleGetHandleTupleGetHandleTupleget_handle_tuple liefert das Tupel, das von dem Schlüssel
KeyKeyKeyKeykeykey in HandleHandleHandleHandlehandlehandle referenziert wird, in
TupleTupleTupleTupletupletuple zurück.
Die Liste der von einem Handle unterstützten Schlüssel kann
zuvor mit get_handle_paramget_handle_paramGetHandleParamGetHandleParamGetHandleParamget_handle_param abgerufen werden.
Zu beachten ist, dass get_handle_tupleget_handle_tupleGetHandleTupleGetHandleTupleGetHandleTupleget_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_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
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.
Parameteranzahl: Key == 1
Restriktion: length(Key) > 0
TupleTupleTupleTupletupletuple (output_control) tuple(-array) → HTupleSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Vom Schlüssel referenzierte Tupeldaten.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
get_handle_tupleget_handle_tupleGetHandleTupleGetHandleTupleGetHandleTupleget_handle_tuple den Wert 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.
Vorgänger
get_handle_paramget_handle_paramGetHandleParamGetHandleParamGetHandleParamget_handle_param
Alternativen
get_handle_objectget_handle_objectGetHandleObjectGetHandleObjectGetHandleObjectget_handle_object
Siehe auch
get_handle_paramget_handle_paramGetHandleParamGetHandleParamGetHandleParamget_handle_param,
get_handle_objectget_handle_objectGetHandleObjectGetHandleObjectGetHandleObjectget_handle_object
Modul
Foundation