Skip to content

set_window_extentsSetWindowExtentsSetWindowExtentsset_window_extentsT_set_window_extents🔗

Short description🔗

set_window_extentsSetWindowExtentsSetWindowExtentsset_window_extentsT_set_window_extents — Modify position and size of a window.

Signature🔗

set_window_extents( window WindowHandle, rectangle.origin.y Row, rectangle.origin.x Column, rectangle.extent.x Width, rectangle.extent.y Height )void SetWindowExtents( const HTuple& WindowHandle, const HTuple& Row, const HTuple& Column, const HTuple& Width, const HTuple& Height )static void HOperatorSet.SetWindowExtents( HTuple windowHandle, HTuple row, HTuple column, HTuple width, HTuple height )def set_window_extents( window_handle: HHandle, row: int, column: int, width: int, height: int ) -> None

Herror T_set_window_extents( const Htuple WindowHandle, const Htuple Row, const Htuple Column, const Htuple Width, const Htuple Height )

void HWindow::SetWindowExtents( Hlong Row, Hlong Column, Hlong Width, Hlong Height ) const

void HWindow.SetWindowExtents( int row, int column, int width, int height )

Description🔗

set_window_extentsSetWindowExtents positions the upper left corner of the output window at (Rowrowrow,Columncolumncolumn) and changes the size of the window to Widthwidthwidth and Heightheightheight at the same time. Negative values for Widthwidthwidth and Heightheightheight are ignored.

Adapting the size of the window to the size of the image part to be displayed will prevent slowing down the display due to necessary interpolations. Thus, the window preferably has the same size as the image part to be displayed, or otherwise half its size, quarter its size, etc.

Attention🔗

Modifying the size of the window does not automatically redraw the window contents. This has to be done by the program by redisplaying the desired data.

Execution information🔗

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🔗

WindowHandlewindowHandlewindow_handle (input_control) window → (handle)HTuple (HHandle)HWindow, HTuple (IntPtr)HHandleHtuple (handle)

Window handle.

Rowrowrow (input_control) rectangle.origin.y → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Row index of upper left corner in target position.

Default: 00
Value range: Row (lin)
Minimum increment: 1
Recommended increment: 1

Columncolumncolumn (input_control) rectangle.origin.x → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Column index of upper left corner in target position.

Default: 00
Value range: Column (lin)
Minimum increment: 1
Recommended increment: 1

Widthwidthwidth (input_control) rectangle.extent.x → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Width of the window.

Default: 512512
Value range: Width (lin)
Minimum increment: 1
Recommended increment: 1

Heightheightheight (input_control) rectangle.extent.y → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Height of the window.

Default: 512512
Value range: Height (lin)
Minimum increment: 1
Recommended increment: 1

Result🔗

If the window is valid and the parameters are correct set_window_extentsSetWindowExtents returns 2 (H_MSG_TRUE). If necessary an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

open_windowOpenWindow

See also

get_window_extentsGetWindowExtents, open_windowOpenWindow

Module🔗

Foundation