ClassesClassesClassesClasses | | | | Operators

drag_region3drag_region3DragRegion3drag_region3DragRegion3DragRegion3 (Operator)

Name

drag_region3drag_region3DragRegion3drag_region3DragRegion3DragRegion3 — Interactive movement of a region with restriction of positions.

Signature

drag_region3(SourceRegion, MaskRegion : DestinationRegion : WindowHandle, Row, Column : )

Herror drag_region3(const Hobject SourceRegion, const Hobject MaskRegion, Hobject* DestinationRegion, const Hlong WindowHandle, const Hlong Row, const Hlong Column)

Herror T_drag_region3(const Hobject SourceRegion, const Hobject MaskRegion, Hobject* DestinationRegion, const Htuple WindowHandle, const Htuple Row, const Htuple Column)

Herror drag_region3(Hobject SourceRegion, Hobject MaskRegion, Hobject* DestinationRegion, const HTuple& WindowHandle, const HTuple& Row, const HTuple& Column)

HRegionArray HRegionArray::DragRegion3(const HRegionArray& MaskRegion, const HTuple& WindowHandle, const HTuple& Row, const HTuple& Column) const

void DragRegion3(const HObject& SourceRegion, const HObject& MaskRegion, HObject* DestinationRegion, const HTuple& WindowHandle, const HTuple& Row, const HTuple& Column)

HRegion HRegion::DragRegion3(const HRegion& MaskRegion, const HWindow& WindowHandle, Hlong Row, Hlong Column) const

HRegion HWindow::DragRegion3(const HRegion& SourceRegion, const HRegion& MaskRegion, Hlong Row, Hlong Column) const

void HOperatorSetX.DragRegion3(
[in] IHUntypedObjectX* SourceRegion, [in] IHUntypedObjectX* MaskRegion, [out] IHUntypedObjectX*DestinationRegion, [in] VARIANT WindowHandle, [in] VARIANT Row, [in] VARIANT Column)

IHRegionX* HRegionX.DragRegion3(
[in] IHRegionX* MaskRegion, [in] IHWindowX* WindowHandle, [in] Hlong Row, [in] Hlong Column)

IHRegionX* HWindowX.DragRegion3(
[in] IHRegionX* SourceRegion, [in] IHRegionX* MaskRegion, [in] Hlong Row, [in] Hlong Column)

static void HOperatorSet.DragRegion3(HObject sourceRegion, HObject maskRegion, out HObject destinationRegion, HTuple windowHandle, HTuple row, HTuple column)

HRegion HRegion.DragRegion3(HRegion maskRegion, HWindow windowHandle, int row, int column)

HRegion HWindow.DragRegion3(HRegion sourceRegion, HRegion maskRegion, int row, int column)

Description

You use drag_region3drag_region3DragRegion3drag_region3DragRegion3DragRegion3 to move a region on the display by mouse. It corresponds to the operator drag_region2drag_region2DragRegion2drag_region2DragRegion2DragRegion2 with the enhancement, that all points are specified which can be entered by mouse. If you move the mouse outside of this area (MaskRegionMaskRegionMaskRegionMaskRegionMaskRegionmaskRegion), the region on the point with the smallest distance inside MaskRegionMaskRegionMaskRegionMaskRegionMaskRegionmaskRegion will be displayed.

Attention

The region's gray values 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.

Parallelization

Parameters

SourceRegionSourceRegionSourceRegionSourceRegionSourceRegionsourceRegion (input_object)  region-array objectHRegionHRegionHRegionArrayHRegionXHobject

Regions to move.

MaskRegionMaskRegionMaskRegionMaskRegionMaskRegionmaskRegion (input_object)  region-array objectHRegionHRegionHRegionArrayHRegionXHobject

Points on which it is allowed for a region to move.

DestinationRegionDestinationRegionDestinationRegionDestinationRegionDestinationRegiondestinationRegion (output_object)  region-array objectHRegionHRegionHRegionArrayHRegionXHobject *

Moved regions.

WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window HWindow, HTupleHTupleHTupleHWindowX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Window identifier.

RowRowRowRowRowrow (input_control)  point.y HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Row index of the reference point.

Default value: 100

Suggested values: 0, 64, 128, 256, 512

Typical range of values: 0 ≤ Row Row Row Row Row row ≤ 1024

ColumnColumnColumnColumnColumncolumn (input_control)  point.x HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Column index of the reference point.

Default value: 100

Suggested values: 0, 64, 128, 256, 512

Typical range of values: 0 ≤ Column Column Column Column Column column ≤ 1024

Result

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

Possible Predecessors

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow, get_mpositionget_mpositionGetMpositionget_mpositionGetMpositionGetMposition

Possible Successors

reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, set_coloredset_coloredSetColoredset_coloredSetColoredSetColored, set_line_widthset_line_widthSetLineWidthset_line_widthSetLineWidthSetLineWidth, set_drawset_drawSetDrawset_drawSetDrawSetDraw, set_insertset_insertSetInsertset_insertSetInsertSetInsert, affine_trans_imageaffine_trans_imageAffineTransImageaffine_trans_imageAffineTransImageAffineTransImage

Alternatives

get_mpositionget_mpositionGetMpositionget_mpositionGetMpositionGetMposition, move_regionmove_regionMoveRegionmove_regionMoveRegionMoveRegion, drag_region1drag_region1DragRegion1drag_region1DragRegion1DragRegion1, drag_region2drag_region2DragRegion2drag_region2DragRegion2DragRegion2

See also

set_insertset_insertSetInsertset_insertSetInsertSetInsert, set_drawset_drawSetDrawset_drawSetDrawSetDraw, affine_trans_imageaffine_trans_imageAffineTransImageaffine_trans_imageAffineTransImageAffineTransImage

Module

Foundation


ClassesClassesClassesClasses | | | | Operators