get_icon

Herror ::get_icon ( Hobject *Icon, const HTuple &WindowHandle ) HRegion HRegion::GetIcon ( const HTuple &WindowHandle )

Query the icon for region output

::get_icon queries the icon that was set with ::set_icon.

Parameters

`Icon` (output_object)	region `->` Hobject : HRegion*
Icon for the regions center of gravity.

`WindowHandle` (input_control)	window `->` HTuple.long
Window_id.

Example

/* draw a region and an icon.  */
/* set it and get it again. */
draw_region(&Region,WindowHandle) ;
draw_region(&Icon,WindowHandle) ;
set_icon(Icon) ;
set_shape(WindowHandle,"icon") ;
disp_region(Region,WindowHandle) ;
get_icon(&OldIcon) ;
disp_region(OldIcon,WindowHandle) ;

Result

::get_icon always returns H_MSG_TRUE.

Possible Predecessors

::set_icon

Possible Successors

::disp_region

Module

System