Operator Reference
get_insert (Operator)
get_insert
— Get the current display mode.
Warning
get_insert
is obsolete and is only provided for
reasons of backward compatibility.
Signature
get_insert( : : WindowHandle : Mode)
Description
get_insert
returns the display mode of the output
window. It is used by operators like disp_region
,
disp_line
, disp_rectangle1
, etc. The mode is
set with set_insert
. Possible values for Mode
can be queried with the operator query_insert
.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
WindowHandle
(input_control) window →
(handle)
Window handle.
Mode
(output_control) string →
(string)
Display mode.
Result
get_insert
returns 2 (
H_MSG_TRUE)
if the window is valid.
Otherwise an exception is raised.
Possible Predecessors
Possible Successors
See also
set_insert
,
query_insert
,
disp_region
,
disp_line
Module
Foundation