set_window_extentsT_set_window_extentsSetWindowExtentsSetWindowExtents (Operator)

Name

set_window_extentsT_set_window_extentsSetWindowExtentsSetWindowExtents — Modify position and size of a window.

Signature

set_window_extents( : : WindowHandle, Row, Column, Width, Height : )

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

void SetWindowExtents(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

static void HOperatorSet.SetWindowExtents(HTuple windowHandle, HTuple row, HTuple column, HTuple width, HTuple height)

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

Description

set_window_extentsset_window_extentsSetWindowExtentsSetWindowExtentsSetWindowExtents positions the upper left corner of the output window at (RowRowRowRowrow,ColumnColumnColumnColumncolumn) and changes the size of the window to WidthWidthWidthWidthwidth and HeightHeightHeightHeightheight at the same time. Negative values for WidthWidthWidthWidthwidth and HeightHeightHeightHeightheight 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

Parameters

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window HWindow, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Window handle.

RowRowRowRowrow (input_control)  rectangle.origin.y HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Row index of upper left corner in target position.

Default value: 0

Typical range of values: Row Row Row Row row (lin)

Minimum increment: 1

Recommended increment: 1

ColumnColumnColumnColumncolumn (input_control)  rectangle.origin.x HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column index of upper left corner in target position.

Default value: 0

Typical range of values: Column Column Column Column column (lin)

Minimum increment: 1

Recommended increment: 1

WidthWidthWidthWidthwidth (input_control)  rectangle.extent.x HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Width of the window.

Default value: 512

Typical range of values: Width Width Width Width width (lin)

Minimum increment: 1

Recommended increment: 1

HeightHeightHeightHeightheight (input_control)  rectangle.extent.y HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Height of the window.

Default value: 512

Typical range of values: Height Height Height Height height (lin)

Minimum increment: 1

Recommended increment: 1

Result

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

Possible Predecessors

open_windowopen_windowOpenWindowOpenWindowOpenWindow

See also

get_window_extentsget_window_extentsGetWindowExtentsGetWindowExtentsGetWindowExtents, open_windowopen_windowOpenWindowOpenWindowOpenWindow

Module

Foundation