Herror ::drag_region2 (
    Hobject SourceRegion,
    Hobject *DestinationRegion,
    const HTuple &WindowHandle,
    const HTuple &Row,
    const HTuple &Column
)
HRegionArray HRegionArray::DragRegion2 (
    const HTuple &WindowHandle,
    const HTuple &Row,
    const HTuple &Column
) const

Interactive movement of a region with fixpoint specification.

You use ::drag_region2 to move a region on the display by mouse. It corresponds to the procedure ::drag_region1 with the difference, that the position of the mouse cursor can be determined.


Attention

Gray values of the regions are not moved. With moving the input region it is not sure whether the gray values of the output regions are filled reasonable. This may occur if the gray values of the input regions do not comprise the whole image.


Parameters

SourceRegion (input_object)
region-array -> Hobject: HRegionArray
Regions to move.

DestinationRegion (output_object)
region-array -> Hobject * : HRegionArray
Moved regions.

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

Row (input_control)
point.y -> HTuple.long
Row index of the reference point.
Default value: 100
Suggested values: 0, 64, 128, 256, 512
Typical range of values: 0 <= Row <= 1024

Column (input_control)
point.x -> HTuple.long
Column index of the reference point.
Default value: 100
Suggested values: 0, 64, 128, 256, 512
Typical range of values: 0 <= Column <= 1024


Result

::drag_region2 returns H_MSG_TRUE, if a region is entered, the window is valid and the needed drawing mode (see ::set_insert) is available. If necessary, an exception handling is raised. You may determine the behavior after an empty input with ::set_system('no_object_result',<Result>).


Possible Predecessors

::open_window


Possible Successors

::reduce_domain, ::disp_region, ::set_colored, ::set_line_width, ::set_draw, ::set_insert, ::affine_trans_image


Alternatives

::get_mposition, ::move_region, ::drag_region1, ::drag_region3


See also

::set_insert, ::set_draw, ::affine_trans_image


Module

System



Copyright © 1996-2002 MVTec Software GmbH