Operator Reference

set_tshapeT_set_tshapeSetTshapeSetTshapeset_tshape (Operator)

set_tshapeT_set_tshapeSetTshapeSetTshapeset_tshape — Set the shape of the text cursor.

Warning

set_tshapeset_tshapeSetTshapeSetTshapeset_tshape is obsolete and is only provided for reasons of backward compatibility.

Signature

set_tshape( : : WindowHandle, TextCursor : )

Herror T_set_tshape(const Htuple WindowHandle, const Htuple TextCursor)

void SetTshape(const HTuple& WindowHandle, const HTuple& TextCursor)

void HWindow::SetTshape(const HString& TextCursor) const

void HWindow::SetTshape(const char* TextCursor) const

void HWindow::SetTshape(const wchar_t* TextCursor) const   ( Windows only)

static void HOperatorSet.SetTshape(HTuple windowHandle, HTuple textCursor)

void HWindow.SetTshape(string textCursor)

def set_tshape(window_handle: HHandle, text_cursor: str) -> None

Description

set_tshapeset_tshapeSetTshapeSetTshapeset_tshape sets the shape and the display mode of the text cursor of the output window.

A text cursor marks the current position for text output. It is different from the mouse cursor (although both will be called 'cursor', if the context makes misconceptions impossible). The available shapes for the text cursor can be queried with query_tshapequery_tshapeQueryTshapeQueryTshapequery_tshape.

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

WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control)  window HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Window handle.

TextCursorTextCursorTextCursortextCursortext_cursor (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Name of cursor shape.

Default: 'invisible' "invisible" "invisible" "invisible" "invisible"

Result

set_tshapeset_tshapeSetTshapeSetTshapeset_tshape returns 2 ( H_MSG_TRUE) if the window is valid and the given cursor shape is defined for this window. Otherwise an exception is raised.

Possible Predecessors

open_windowopen_windowOpenWindowOpenWindowopen_window, query_tshapequery_tshapeQueryTshapeQueryTshapequery_tshape, get_tshapeget_tshapeGetTshapeGetTshapeget_tshape

Possible Successors

write_stringwrite_stringWriteStringWriteStringwrite_string, read_stringread_stringReadStringReadStringread_string

See also

get_tshapeget_tshapeGetTshapeGetTshapeget_tshape, query_tshapequery_tshapeQueryTshapeQueryTshapequery_tshape, write_stringwrite_stringWriteStringWriteStringwrite_string, read_stringread_stringReadStringReadStringread_string

Module

Foundation