Name
write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString — Print text in a window.
write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString prints StringStringStringStringStringstringVal in the output
window starting at the current cursor position. The output text has to fit
within the right window boundary (the width of the string can be queried
by get_string_extentsget_string_extentsGetStringExtentsget_string_extentsGetStringExtentsGetStringExtents).
The font currently assigned to the window will used. The text cursor is
positioned at the end of the text.
write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString can output all three types of data used in HALCON .
The conversion to a string is guided by the following rules:
-
strings are not converted.
-
integer numbers are converted without any spaces before or
after the number.
-
floating numbers are printed (if possible) with a floating point
and without an exponent.
-
the resulting strings are concatenated without spaces.
For buffering of texts see set_systemset_systemSetSystemset_systemSetSystemSetSystem with the flag
'flush_graphic'.
If clipping at the window boundary is desired, exceptions can be switched
off by set_check('~text').
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: local (may only be called from the same thread in which the window, model, or tool instance was created).
- Processed without parallelization.
StringStringStringStringStringstringVal (input_control) string(-array) → HTupleHTupleHTupleVARIANTHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double) (BSTR / Hlong / double) (char* / Hlong / double)
Tuple of output values (all types).
Default value:
'hello'
"hello"
"hello"
"hello"
"hello"
"hello"
write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString returns 2 (H_MSG_TRUE) if the window is valid and the
output text fits within the current line (see set_checkset_checkSetCheckset_checkSetCheckSetCheck).
Otherwise an exception is raised.
open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow,
open_textwindowopen_textwindowOpenTextwindowopen_textwindowOpenTextwindowOpenTextwindow,
set_fontset_fontSetFontset_fontSetFontSetFont,
get_string_extentsget_string_extentsGetStringExtentsget_string_extentsGetStringExtentsGetStringExtents
fwrite_stringfwrite_stringFwriteStringfwrite_stringFwriteStringFwriteString
set_tpositionset_tpositionSetTpositionset_tpositionSetTpositionSetTposition,
get_string_extentsget_string_extentsGetStringExtentsget_string_extentsGetStringExtentsGetStringExtents,
open_textwindowopen_textwindowOpenTextwindowopen_textwindowOpenTextwindowOpenTextwindow,
set_fontset_fontSetFontset_fontSetFontSetFont,
set_systemset_systemSetSystemset_systemSetSystemSetSystem,
set_checkset_checkSetCheckset_checkSetCheckSetCheck
Foundation