NAME
Win32::GUI::Region - A Win32::GUI package
DESCRIPTION
[TBD]
METHODS
Common methods apply to most windows, controls and resources.
CombineRgn
CombineRgn(source1,source2,CombineMode)
The CombineRgn method combines two regions. The two regions are combined according to the specified mode.
CombineMode:
RGN_AND (1) Creates the intersection of the two combined regions.
RGN_COPY (5) Creates a copy of the region identified by source1.
RGN_DIFF (4) Combines the parts of source1 that are not part of source2.
RGN_OR (2) Creates the union of two combined regions.
RGN_XOR (3) Creates the union of two combined regions except for any
overlapping areas.Return Values:
NULLREGION (1) The region is empty.
SIMPLEREGION (2) The region is a single rectangle.
COMPLEXREGION (3) The region is more than a single rectangle.
ERROR (0) No region is created.CreateEllipticRgn
CreateEllipticRgn(LEFT, TOP, RIGHT, BOTTOM)
The CreateEllipticRgn function creates an elliptical region, returning a region object.
The bounding rectangle defines the size, shape, and orientation of the region: The long sides of the rectangle define the length of the ellipse's major axis; the short sides define the length of the ellipse's minor axis; and the center of the rectangle defines the intersection of the major and minor axes.
CreateRectRgn
CreateRectRgn(LEFT, TOP, RIGHT, BOTTOM)
The CreateRectRgn function creates a rectangular region, returning a region object.
CreateRoundRectRgn
CreateRoundRectRgn(LEFT, TOP, RIGHT, BOTTOM , WIDTH, HEIGHT)
The CreateRoundRectRgn function creates a rectangular region with rounded corners, returning a region object.
The width and height is of the ellipse used to create the rounded corners.
EqualRgn
EqualRgn(Region)
The EqualRgn function checks the two specified regions to determine whether they are identical. The method considers two regions identical if they are equal in size and shape.
ExtCreateRegion
ExtCreateRegion(RGNDATA)
The ExtCreateRgn function creates a region from data held in memory. The data is a win32 RGNDATA structure (See MSDN) that can be created by packing the appropriate structure, or more easily by using the GetRgnData() method.
my $rgn = Win32::GUI::Region->CreateRoundRectRgn(0,0,100,100,50,50);
my $rgndata = $rgn->GetRegionData();
my $newrgn = Win32::GUI::Region->ExtCreateRegion($rgndata);Returns a Win32::GUI::Region object on success or undef on failure
GetRegionData
GetRegionData()
The GetRegionData functions returns a representation of the region as a string of bytes that can be used to re-create an identical region using the ExtCreateRgn() method.
Returns a string of bytes on success or undef on failure
GetRgnBox
GetRgnBox()
The GetRgnBox function retrieves the bounding rectangle of the specified region. Returns the rectangle (as a four-element array containing left, top, right, bottom coordinates)
OffsetRgn
OffsetRgn(X,Y)
The OffsetRgn function moves a region by the specified offsets.
The return value specifies the new region's complexity. It can be one of the following values.
1 (NULLREGION) Region is empty. 2 (SIMPLEREGION) Region is a single rectangle. 3 (COMPLEXREGION) Region is more than one rectangle. 0 (ERROR) An error occurred; region is unaffected.
PtInRegion
PtInRegion(X,Y)
The PtInRegion method determines whether the specified point is inside the specified region.
If the specified point is in the region, the return value is nonzero. If the specified point is not in the region, the return value is zero.
RectInRegion
RectInRegion(left, top, right, bottom)
The RectInRegion method determines whether any part of the specified rectangle is within the boundaries of a region.
If any part of the specified rectangle lies within the boundaries of the region, the return value is nonzero.
If no part of the specified rectangle lies within the boundaries of the region, the return value is zero.
SetRectRgn
SetRectRgn(left, top, right, bottom)
The SetRectRgn function converts a region into a rectangular region with the specified coordinates.
EVENTS
Common events apply to most windows and controls.
VERSION
Documentation for Win32::GUI v1.14 created 01 Jun 2017
This document is autogenerated by the build process. Edits made here will be lost. Edit docs/per_package.tpl instead.
SUPPORT
Homepage: http://perl-win32-gui.sourceforge.net/.
For further support join the users mailing list from the website at http://lists.sourceforge.net/lists/listinfo/perl-win32-gui-users. There is a searchable list archive at http://sourceforge.net/p/perl-win32-gui/mailman/perl-win32-gui-users/.
COPYRIGHT and LICENCE
Copyright (c) 1997..2017 Aldo Calpini. All rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.