get_handle_param — Zurückgeben von Informationen über ein Handle.
get_handle_param( : : Handle, GenParamName, Key : GenParamValue)
get_handle_param gibt Informationen über Handle
zurück.
Der Operator bietet einen generischen Mechanismus, um den Inhalt von
Handles aller Typen zu debuggen. Er liefert insbesonderes eine Liste von
Schlüsseln für das Handle zurück, zu denen Werte mittels
get_handle_tuple und get_handle_object abgefragt werden können.
Zu beachten ist, dass get_handle_param 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.
Je nach dem Wert von GenParamName können mit diesem Operator die
folgenden Eigenschaften abgefragt werden:
Gibt in GenParamValue eine Liste von Schlüsseln zurück, die
vom übergebenen Handle unterstützt werden.
Jeder Schlüssel enthält entweder ein ikonisches Objekt oder ein Tupel.
Für diese Abfrage muss der Parameter Key auf ein leeres Tupel
gesetzt werden.
Aufgrund des generischen Mechanismus dieses Operators sind einige der
zurückgegebenen Schlüssel für das übergebene Handle möglicherweise
nicht gültig.
Für solche Schlüssel liefern get_handle_tuple bzw.
get_handle_object einen Fehler zurück.
Gibt den Datentyp des in Key übergebenen Schlüssels zurück.
Der Typ wird in GenParamValue zurückgegeben und ist entweder
'tuple' oder 'object'.
Je nach Typ kann der dem Schlüssel zugewiesene Wert mit
get_handle_tuple oder get_handle_object abgerufen werden.
Handle (input_control) handle → (handle)
Handle, dessen Eigenschaft abgerufen werden soll.
GenParamName (input_control) string → (string)
Abzurufende Eigenschaft.
Defaultwert: 'keys'
Werteliste: 'key_data_type', 'keys'
Key (input_control) string(-array) → (string)
Optionaler Schlüssel, dessen Eigenschaften abgerufen werden.
Defaultwert: []
GenParamValue (output_control) tuple(-array) → (string / integer / real)
Zurückgegebener Wert.
Sind die Parameterwerte korrekt, dann liefert
get_handle_param den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
clear_handle,
get_handle_tuple,
get_handle_object
get_handle_tuple,
get_handle_object
Foundation