HALCON 17.12 / HALCON Operator Reference / Graphics / Window
ClassesClasses | | Operators

get_window_extentsget_window_extentsGetWindowExtentsGetWindowExtents (Operator)

Name

get_window_extentsget_window_extentsGetWindowExtentsGetWindowExtents — Information about a window's size and position.

Signature

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

Herror get_window_extents(const Hlong WindowHandle, Hlong* Row, Hlong* Column, Hlong* Width, Hlong* Height)

Herror T_get_window_extents(const Htuple WindowHandle, Htuple* Row, Htuple* Column, Htuple* Width, Htuple* Height)

void GetWindowExtents(const HTuple& WindowHandle, HTuple* Row, HTuple* Column, HTuple* Width, HTuple* Height)

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

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

void HWindow.GetWindowExtents(out int row, out int column, out int width, out int height)

Description

get_window_extentsget_window_extentsGetWindowExtentsGetWindowExtentsGetWindowExtents returns the position of the upper left corner, as well as width and height of the output window.

Attention

Size and position of a window may be modified by the window manager, without explicit instruction in the program. Therefore the values which are returned by get_window_extentsget_window_extentsGetWindowExtentsGetWindowExtentsGetWindowExtents may change cause of side effects.

Execution Information

Parameters

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window → HWindow, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Window handle.

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

Row index of upper left corner of the window.

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

Column index of upper left corner of the window.

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

Window width.

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

Window height.

Example (HDevelop)

open_window(100,100,200,200,'root','visible','',WindowHandle)
fwrite_string(FileHandle, 'Move the window with the mouse!')
fnew_line(FileHandle)
repeat
get_mbutton(WindowHandle,_,_,Button)
get_window_extents(WindowHandle,Row,Column,Width,Height)
fwrite_string(FileHandle, ['(',Row,',',Column,')'])
fnew_line(FileHandle)
until(Button == 4)

Example (C)

open_window(100,100,200,200,"root","visible","",&WindowHandle) ;
fwrite_string(FileHandle,"Move the window with the mouse!") ;
fnew_line(FileHandle) ;
create_tuple(&String,1) ;
do
{
  get_mbutton(WindowHandle,NULL,NULL,&Button) ;
  get_window_extents(WindowHandle,&Row,&Column,&Width,&Height) ;
  sprintf(buf,"Row %d Col %d ",Row,Column) ;
  set_s(String,buf,0) ;
  T_fwrite_string(FileHandle, String) ;
  fnew_line(FileHandle) ;
}
while(Button < 4) ;

Example (HDevelop)

open_window(100,100,200,200,'root','visible','',WindowHandle)
fwrite_string(FileHandle, 'Move the window with the mouse!')
fnew_line(FileHandle)
repeat
get_mbutton(WindowHandle,_,_,Button)
get_window_extents(WindowHandle,Row,Column,Width,Height)
fwrite_string(FileHandle, ['(',Row,',',Column,')'])
fnew_line(FileHandle)
until(Button == 4)

Example (HDevelop)

open_window(100,100,200,200,'root','visible','',WindowHandle)
fwrite_string(FileHandle, 'Move the window with the mouse!')
fnew_line(FileHandle)
repeat
get_mbutton(WindowHandle,_,_,Button)
get_window_extents(WindowHandle,Row,Column,Width,Height)
fwrite_string(FileHandle, ['(',Row,',',Column,')'])
fnew_line(FileHandle)
until(Button == 4)

Example (HDevelop)

open_window(100,100,200,200,'root','visible','',WindowHandle)
fwrite_string(FileHandle, 'Move the window with the mouse!')
fnew_line(FileHandle)
repeat
get_mbutton(WindowHandle,_,_,Button)
get_window_extents(WindowHandle,Row,Column,Width,Height)
fwrite_string(FileHandle, ['(',Row,',',Column,')'])
fnew_line(FileHandle)
until(Button == 4)

Result

If the window is valid get_window_extentsget_window_extentsGetWindowExtentsGetWindowExtentsGetWindowExtents returns 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Predecessors

open_windowopen_windowOpenWindowOpenWindowOpenWindow, set_drawset_drawSetDrawSetDrawSetDraw, set_colorset_colorSetColorSetColorSetColor, set_coloredset_coloredSetColoredSetColoredSetColored, set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidth

See also

set_window_extentsset_window_extentsSetWindowExtentsSetWindowExtentsSetWindowExtents, open_windowopen_windowOpenWindowOpenWindowOpenWindow

Module

Foundation

ClassesClasses | | Operators
HALCON Operator Reference 17.12 Copyright © 1996-2017 MVTec Software GmbH