
=head1 NAME

Win32::GUI::Region - A Win32::GUI package

=head1 DESCRIPTION

[TBD]

=for comment $Id: per_package_method_section.tpl,v 1.1 2005/06/26 16:41:00 robertemay Exp $

=head1 METHODS

L<Common methods|Win32::GUI::Reference::Methods> apply to most windows, controls and resources.

=for comment $Id: per_package_method.tpl,v 1.1 2005/06/26 16:41:00 robertemay Exp $

=head2 CombineRgn

B<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 No (0) region is created.

=for comment $Id: per_package_method.tpl,v 1.1 2005/06/26 16:41:00 robertemay Exp $

=head2 CreateEllipticRgn

B<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.

=for comment $Id: per_package_method.tpl,v 1.1 2005/06/26 16:41:00 robertemay Exp $

=head2 CreateRectRgn

B<CreateRectRgn(LEFT, TOP, RIGHT, BOTTOM)>

The CreateRectRgn function creates a rectangular region, returning a region object.

=for comment $Id: per_package_method.tpl,v 1.1 2005/06/26 16:41:00 robertemay Exp $

=head2 CreateRoundRectRgn

B<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.

=for comment $Id: per_package_method.tpl,v 1.1 2005/06/26 16:41:00 robertemay Exp $

=head2 EqualRgn

B<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.

=for comment $Id: per_package_method.tpl,v 1.1 2005/06/26 16:41:00 robertemay Exp $

=head2 GetRgnBox

B<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)

=for comment $Id: per_package_method.tpl,v 1.1 2005/06/26 16:41:00 robertemay Exp $

=head2 OffsetRgn

B<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.

=for comment $Id: per_package_method.tpl,v 1.1 2005/06/26 16:41:00 robertemay Exp $

=head2 PtInRegion

B<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.

=for comment $Id: per_package_method.tpl,v 1.1 2005/06/26 16:41:00 robertemay Exp $

=head2 RectInRegion

B<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.

=for comment $Id: per_package_method.tpl,v 1.1 2005/06/26 16:41:00 robertemay Exp $

=head2 SetRectRgn

B<SetRectRgn(left, top, right, bottom)>

The SetRectRgn function converts a region into a rectangular region with the specified coordinates.




=for comment $Id: per_package_event_section.tpl,v 1.1 2005/06/26 16:41:00 robertemay Exp $

=head1 EVENTS

L<Common events|Win32::GUI::Reference::Events> apply to most windows and controls.





=for comment $Id: pod_postamble.tpl,v 1.2 2005/08/03 21:45:59 robertemay Exp $

=head1 VERSION

Documentation for Win32::GUI v1.03 created 08 Feb 2008

This document is autogenerated by the build process. Edits made here will be lost.
Edit F<docs/per_package.tpl> instead.

=head1 SUPPORT

Homepage: L<http://perl-win32-gui.sourceforge.net/>.

For further support join the users mailing list(C<perl-win32-gui-users@lists.sourceforge.net>) from the website
at L<http://lists.sourceforge.net/lists/listinfo/perl-win32-gui-users>.  There is a searchable list archive at L<http://sourceforge.net/mail/?group_id=16572>.

=head1 COPYRIGHT and LICENCE

Copyright (c) 1997..2008 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.


