create_drawing_object_textT_create_drawing_object_textCreateDrawingObjectTextCreateDrawingObjectTextcreate_drawing_object_text (Operator)
Name
create_drawing_object_textT_create_drawing_object_textCreateDrawingObjectTextCreateDrawingObjectTextcreate_drawing_object_text — Erzeugen eines Text-Zeichenobjekts, das interaktiv in einem HALCON-Fenster
verschoben werden kann.
Signatur
Herror T_create_drawing_object_text(const Htuple Row, const Htuple Column, const Htuple String, Htuple* DrawID)
def create_drawing_object_text(row: int, column: int, string: str) -> HHandle
Beschreibung
create_drawing_object_textcreate_drawing_object_textCreateDrawingObjectTextCreateDrawingObjectTextCreateDrawingObjectTextcreate_drawing_object_text erstellt ein Text-Zeichenobjekt, das interaktiv
vom Benutzer in einem HALCON-Fenster verschoben werden kann.
Die Position des Textes ist durch die Parameter RowRowRowRowrowrow und
ColumnColumnColumnColumncolumncolumn definiert.
Diese Parameter können mit dem Operator get_drawing_object_paramsget_drawing_object_paramsGetDrawingObjectParamsGetDrawingObjectParamsGetDrawingObjectParamsget_drawing_object_params
abgerufen werden.
Um das Text-Zeichenobjekt interaktiv verschieben zu können, muss es zunächst
mit attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindowattach_drawing_object_to_window an ein existierendes
Fenster angehängt werden. Nähere Informationen sind in der Dokumentation
zu attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindowattach_drawing_object_to_window zu finden.
Der Text wird mit den aktuellen Einstellungen des HALCON-Fensters
dargestellt. Die Einstellungen zur Schrift können jedoch auch mit
dem Operator set_drawing_object_paramsset_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParamsSetDrawingObjectParamsset_drawing_object_params angepasst werden.
Sobald das Text-Zeichenobjekt einem Fenster zugewiesen ist, kann es
interaktiv mit der Maus in dem Fenster verschoben werden.
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.
Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.
Parameter
RowRowRowRowrowrow (input_control) point.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Zeilenkoordinate der Textposition.
Defaultwert: 12
ColumnColumnColumnColumncolumncolumn (input_control) point.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Spaltenkoordinate der Textposition.
Defaultwert: 12
StringStringStringStringstringValstring (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Zeichenkette.
Defaultwert:
'Text'
"Text"
"Text"
"Text"
"Text"
"Text"
DrawIDDrawIDDrawIDDrawIDdrawIDdraw_id (output_control) drawing_object → HDrawingObject, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Text-Zeichenobjekts.
Ergebnis
Sind die Parameterwerte korrekt, liefert create_drawing_object_textcreate_drawing_object_textCreateDrawingObjectTextCreateDrawingObjectTextCreateDrawingObjectTextcreate_drawing_object_text
den Wert 2 (H_MSG_TRUE) zurück. Andernfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window
Nachfolger
attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindowattach_drawing_object_to_window,
get_drawing_object_paramsget_drawing_object_paramsGetDrawingObjectParamsGetDrawingObjectParamsGetDrawingObjectParamsget_drawing_object_params,
set_drawing_object_paramsset_drawing_object_paramsSetDrawingObjectParamsSetDrawingObjectParamsSetDrawingObjectParamsset_drawing_object_params
Alternativen
write_stringwrite_stringWriteStringWriteStringWriteStringwrite_string
Siehe auch
write_stringwrite_stringWriteStringWriteStringWriteStringwrite_string,
attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindowattach_drawing_object_to_window
Modul
Foundation