Skip to content

drag_region1drag_region1DragRegion1DragRegion1drag_region1T_drag_region1πŸ”—

Short descriptionπŸ”—

drag_region1drag_region1DragRegion1DragRegion1drag_region1T_drag_region1 β€” Interactive moving of a region.

WarningπŸ”—

This operator does not work in an HDevelop graphics window opened with dev_open_window.

SignatureπŸ”—

drag_region1( region SourceRegion, out region DestinationRegion, window WindowHandle )drag_region1( SourceRegion : DestinationRegion : WindowHandle : )void DragRegion1( const HObject& SourceRegion, HObject* DestinationRegion, const HTuple& WindowHandle )static void HOperatorSet.DragRegion1( HObject sourceRegion, out HObject destinationRegion, HTuple windowHandle )def drag_region1( source_region: HObject, window_handle: HHandle ) -> HObject

Herror T_drag_region1( const Hobject SourceRegion, Hobject* DestinationRegion, const Htuple WindowHandle )

HRegion HRegion::DragRegion1( const HWindow& WindowHandle ) const

HRegion HWindow::DragRegion1( const HRegion& SourceRegion ) const

HRegion HRegion.DragRegion1( HWindow windowHandle )

HRegion HWindow.DragRegion1( HRegion sourceRegion )

DescriptionπŸ”—

drag_region1DragRegion1 is used to move a region on the display by mouse. Calling drag_region1DragRegion1 turns the region visible as soon as the left mouse button is pressed. Therefore the region’s edges are displayed only. As representation mode the mode β€˜not’ (see set_drawSetDraw) is used during procedure’s permanence. During the movement the cursor resides in the region’s barycenter. If you move the mouse with pressed left mouse button, the depicted region follows - delayed - this movement. If you press the right mouse button you terminate drag_region1DragRegion1. The depicted region disappears from the display. Output is a region which corresponds to the last position on the display. You may pass even several regions at once. The operator affine_trans_imageAffineTransImage moves the gray values.

AttentionπŸ”—

Gray values of 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.

Execution informationπŸ”—

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

ParametersπŸ”—

SourceRegionsourceRegionsource_region (input_object) region-array β†’ objectobjectHObjectHRegionHObjectHobject

Regions to move.

DestinationRegiondestinationRegiondestination_region (output_object) region-array β†’ objectobjectHObjectHRegionHObjectHobject *

Moved Regions.

WindowHandlewindowHandlewindow_handle (input_control) window β†’ (handle)(handle)HTuple (HHandle)HWindow, HTuple (IntPtr)HHandleHtuple (handle)

Window handle.

ExampleπŸ”—

(HDevelop)


draw_region(Obj,WindowHandle)
dev_set_color ('green')
drag_region1(Obj,New,WindowHandle)
dev_display(New)
get_region_runs (Obj, Rows1, ColumnBegins1, ColumnEnds1)
get_region_runs (New, Rows2, ColumnBegins2, ColumnEnds2)
Row1 := Rows1[0]
Column1 := ColumnBegins1[0]
Row2 := Rows2[0]
Column2 := ColumnBegins2[0]
dev_set_color ('white')
gen_arrow_contour_xld (Arrow, Row1,Column1,Row2,Column2, 5, 5)
dev_display (Arrow)
(C)
draw_region(&Obj,WindowHandle)\;
drag_region1(Obj,&New,WindowHandle)\;
disp_region(New,WindowHandle)\;

ResultπŸ”—

drag_region1DragRegion1 returns 2 (H_MSG_TRUE) if a region is entered and the window is valid. The clipping according to the global image size is set via the operator set_system('clip_region',<'true'/'false'>). If necessary, an exception is raised. You may determine the behavior after an empty input with set_system(::'no_object_result',<Result>:).

Combinations with other operatorsπŸ”—

Combinations

Possible predecessors

open_windowOpenWindow

Possible successors

reduce_domainReduceDomain, disp_regionDispRegion, set_coloredSetColored, set_line_widthSetLineWidth, set_drawSetDraw

Alternatives

get_mpositionGetMposition, move_regionMoveRegion

See also

set_drawSetDraw, affine_trans_imageAffineTransImage

ModuleπŸ”—

Foundation