Update of /cvsroot/perl-win32-gui/Win32-GUI
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv2345

Modified Files:
        CHANGELOG DC.xs 
Log Message:
Rename ExtCreateRgn and GetRgnData to ExtCreateRegion and GetRegionData

Index: DC.xs
===================================================================
RCS file: /cvsroot/perl-win32-gui/Win32-GUI/DC.xs,v
retrieving revision 1.14
retrieving revision 1.15
diff -C2 -d -r1.14 -r1.15
*** DC.xs       24 Jun 2006 14:53:13 -0000      1.14
--- DC.xs       26 Jun 2006 18:22:52 -0000      1.15
***************
*** 47,51 ****
      
###########################################################################
      # (@)METHOD:CreateCompatibleBitmap (WIDTH, HEIGHT)
!     # Creates a bitmap compatible with the device that is associated with the 
specified device context. 
  void
  CreateCompatibleBitmap(handle,width,height)
--- 47,52 ----
      
###########################################################################
      # (@)METHOD:CreateCompatibleBitmap (WIDTH, HEIGHT)
!     # Creates a bitmap compatible with the device that is associated with
!     # the specified device context. 
  void
  CreateCompatibleBitmap(handle,width,height)
***************
*** 101,105 ****
      
###########################################################################
      # (@)METHOD:GetCurrentObject(HANDLE,OBJECTTYPE)
!     # Obtains a handle to a device context's currently selected object of a 
specified type.
  HGDIOBJ
  GetCurrentObject(handle, Object)
--- 102,107 ----
      
###########################################################################
      # (@)METHOD:GetCurrentObject(HANDLE,OBJECTTYPE)
!     # Obtains a handle to a device context's currently selected object of a
!     # specified type.
  HGDIOBJ
  GetCurrentObject(handle, Object)
***************
*** 234,239 ****
      
###########################################################################
      # (@)METHOD:Chord(LEFT, TOP, RIGHT, BOTTOM, XF, YF, XS, YS)
!     # Draws a chord (a region bounded by the intersection of an ellipse and a 
line segment, called a "secant"). 
!     # The chord is outlined by using the current pen and filled by using the 
current brush.
  BOOL
  Chord(handle, left, top, right, bottom, xf, yf, xs, ys)
--- 236,242 ----
      
###########################################################################
      # (@)METHOD:Chord(LEFT, TOP, RIGHT, BOTTOM, XF, YF, XS, YS)
!     # Draws a chord (a region bounded by the intersection of an ellipse and
!     # a line segment, called a "secant"). The chord is outlined by using the
!     # current pen and filled by using the current brush.
  BOOL
  Chord(handle, left, top, right, bottom, xf, yf, xs, ys)
***************
*** 255,260 ****
      # (@)METHOD:Ellipse(LEFT, TOP, RIGHT, BOTTOM)
      # Draws an ellipse. 
!     # The center of the ellipse is the center of the specified bounding 
rectangle.
!     # The ellipse is outlined by using the current pen and is filled by using 
the current brush. 
  BOOL
  Ellipse(handle, left, top, right, bottom)
--- 258,264 ----
      # (@)METHOD:Ellipse(LEFT, TOP, RIGHT, BOTTOM)
      # Draws an ellipse. 
!     # The center of the ellipse is the center of the specified bounding
!     # rectangle. The ellipse is outlined by using the current pen and is
!     # filled by using the current brush. 
  BOOL
  Ellipse(handle, left, top, right, bottom)
***************
*** 295,299 ****
      # (@)METHOD:FillRect(LEFT, TOP, RIGHT, BOTTOM, BRUSH)
      # Fills a rectangle by using the specified brush. 
!     # This includes the left and top borders, but excludes the right and 
bottom borders of the rectangle. 
  BOOL
  FillRect(handle, left, top, right, bottom, hbr)
--- 299,304 ----
      # (@)METHOD:FillRect(LEFT, TOP, RIGHT, BOTTOM, BRUSH)
      # Fills a rectangle by using the specified brush. 
!     # This includes the left and top borders, but excludes the right and
!     # bottom borders of the rectangle. 
  BOOL
  FillRect(handle, left, top, right, bottom, hbr)
***************
*** 317,322 ****
      
###########################################################################
      # (@)METHOD:FrameRect(LEFT, TOP, RIGHT, BOTTOM, BRUSH)
!     # Draws a border around the specified rectangle by using the specified 
brush. 
!     # The width and height of the border are always one logical unit. 
  BOOL
  FrameRect(handle, left, top, right, bottom, hbr)
--- 322,327 ----
      
###########################################################################
      # (@)METHOD:FrameRect(LEFT, TOP, RIGHT, BOTTOM, BRUSH)
!     # Draws a border around the specified rectangle by using the specified
!     # brush. The width and height of the border are always one logical unit. 
  BOOL
  FrameRect(handle, left, top, right, bottom, hbr)
***************
*** 340,344 ****
      
###########################################################################
      # (@)METHOD:InvertRect(LEFT, TOP, RIGHT, BOTTOM)
!     # Inverts a rectangle in a window by performing a logical NOT operation 
on the color values for each pixel in the rectangle's interior. 
  BOOL
  InvertRect(handle, left, top, right, bottom)
--- 345,350 ----
      
###########################################################################
      # (@)METHOD:InvertRect(LEFT, TOP, RIGHT, BOTTOM)
!     # Inverts a rectangle in a window by performing a logical NOT operation
!     # on the color values for each pixel in the rectangle's interior. 
  BOOL
  InvertRect(handle, left, top, right, bottom)
***************
*** 361,366 ****
      
###########################################################################
      # (@)METHOD:Pie(LEFT, TOP, RIGHT, BOTTOM, XF, YF, XS, YS)
!     # Draws a pie-shaped wedge bounded by the intersection of an ellipse and 
two radials.
!     # The pie is outlined by using the current pen and filled by using the 
current brush. 
  BOOL
  Pie(handle, left, top, right, bottom, xf, yf, xs, ys)
--- 367,373 ----
      
###########################################################################
      # (@)METHOD:Pie(LEFT, TOP, RIGHT, BOTTOM, XF, YF, XS, YS)
!     # Draws a pie-shaped wedge bounded by the intersection of an ellipse
!     # and two radials. The pie is outlined by using the current pen and
!     # filled by using the current brush. 
  BOOL
  Pie(handle, left, top, right, bottom, xf, yf, xs, ys)
***************
*** 381,385 ****
      
###########################################################################
      # (@)METHOD:Polygon([X,Y]+)
!     # Draws a polygon consisting of two or more vertices connected by 
straight lines.
  BOOL
  Polygon(handle, ...)
--- 388,393 ----
      
###########################################################################
      # (@)METHOD:Polygon([X,Y]+)
!     # Draws a polygon consisting of two or more vertices connected by
!     # straight lines.
  BOOL
  Polygon(handle, ...)
***************
*** 410,414 ****
      # (@)METHOD:Rectangle(LEFT, TOP, RIGHT, BOTTOM)
      # Draws a rectangle. 
!     # The rectangle is outlined by using the current pen and filled by using 
the current brush. 
  BOOL
  Rectangle(handle, left, top, right, bottom)
--- 418,423 ----
      # (@)METHOD:Rectangle(LEFT, TOP, RIGHT, BOTTOM)
      # Draws a rectangle. 
!     # The rectangle is outlined by using the current pen and filled by
!     # using the current brush. 
  BOOL
  Rectangle(handle, left, top, right, bottom)
***************
*** 426,430 ****
      # (@)METHOD:RoundRect(LEFT, TOP, RIGHT, BOTTOM, WIDTH, HEIGHT)
      # Draws a rectangle with rounded corners. 
!     # The rectangle is outlined by using the current pen and filled by using 
the current brush. 
  BOOL
  RoundRect(handle, left, top, right, bottom, width, height)
--- 435,440 ----
      # (@)METHOD:RoundRect(LEFT, TOP, RIGHT, BOTTOM, WIDTH, HEIGHT)
      # Draws a rectangle with rounded corners. 
!     # The rectangle is outlined by using the current pen and filled by using
!     # the current brush. 
  BOOL
  RoundRect(handle, left, top, right, bottom, width, height)
***************
*** 447,451 ****
      
###########################################################################
      # (@)METHOD:DrawText(STRING, LEFT, TOP, RIGHT, BOTTOM, WIDTH, HEIGHT, 
[FORMAT=DT_LEFT|DT_SINGLELINE|DT_TOP])
!     # Draws formatted text in the specified rectangle. It formats the text 
according to the specified method.
  int
  DrawText(handle, string, left, top, right, bottom, 
format=DT_LEFT|DT_SINGLELINE|DT_TOP)
--- 457,462 ----
      
###########################################################################
      # (@)METHOD:DrawText(STRING, LEFT, TOP, RIGHT, BOTTOM, WIDTH, HEIGHT, 
[FORMAT=DT_LEFT|DT_SINGLELINE|DT_TOP])
!     # Draws formatted text in the specified rectangle. It formats the text
!     # according to the specified method.
  int
  DrawText(handle, string, left, top, right, bottom, 
format=DT_LEFT|DT_SINGLELINE|DT_TOP)
***************
*** 539,543 ****
      
###########################################################################
      # (@)METHOD:GetTextFace()
!     # Retrieves the typeface name of the font that is selected into the 
specified device context. 
  void
  GetTextFace(handle)
--- 550,555 ----
      
###########################################################################
      # (@)METHOD:GetTextFace()
!     # Retrieves the typeface name of the font that is selected into the
!     # specified device context. 
  void
  GetTextFace(handle)
***************
*** 553,557 ****
      
###########################################################################
      # (@)METHOD:SetTextJustification(BREAKEXTRA, BREAKCOUNT)
!     # Specifies the amount of space the system should add to the break 
characters in a string of text
  BOOL 
  SetTextJustification(handle, nBreakExtra, nBreakCount)
--- 565,570 ----
      
###########################################################################
      # (@)METHOD:SetTextJustification(BREAKEXTRA, BREAKCOUNT)
!     # Specifies the amount of space the system should add to the break
!     # characters in a string of text
  BOOL 
  SetTextJustification(handle, nBreakExtra, nBreakCount)
***************
*** 586,592 ****
      # (@)METHOD:Arc(X, Y, RADIUS, START, SWEEP)
      # Draws a line segment and an arc. 
!     # The line segment is drawn from the current position to the beginning of 
the arc.
!     # The arc is drawn along the perimeter of a circle with the given radius 
and center.
!     # The length of the arc is defined by the given start and sweep angles.
  BOOL
  Arc(handle, x, y, radius, start, sweep)
--- 599,606 ----
      # (@)METHOD:Arc(X, Y, RADIUS, START, SWEEP)
      # Draws a line segment and an arc. 
!     # The line segment is drawn from the current position to the beginning
!     # of the arc. The arc is drawn along the perimeter of a circle with the
!     # given radius and center. The length of the arc is defined by the given
!     # start and sweep angles.
  BOOL
  Arc(handle, x, y, radius, start, sweep)
***************
*** 604,608 ****
      
###########################################################################
      # (@)METHOD:ArcDirection([DIRECTION])
!     # Gets or sets the drawing direction to be used for arc and rectangle 
functions. 
  int
  ArcDirection(handle, direction = -1)
--- 618,623 ----
      
###########################################################################
      # (@)METHOD:ArcDirection([DIRECTION])
!     # Gets or sets the drawing direction to be used for arc and rectangle
!     # functions. 
  int
  ArcDirection(handle, direction = -1)
***************
*** 684,692 ****
      # (@)METHOD:PolyBezier([X,Y]+)
      # Draws one or more Bézier curves. 
!     # The first curve is drawn from the first point to the fourth point by 
using 
!     # the second and third points as control points. 
      # Each subsequent curve in the sequence needs exactly three more points: 
      # the ending point of the previous curve is used as the starting point, 
the
!     # next two points in the sequence are control points, and the third is 
the ending point. 
  BOOL
  PolyBezier(handle, ...)
--- 699,708 ----
      # (@)METHOD:PolyBezier([X,Y]+)
      # Draws one or more Bézier curves. 
!     # The first curve is drawn from the first point to the fourth point by
!     # using the second and third points as control points. 
      # Each subsequent curve in the sequence needs exactly three more points: 
      # the ending point of the previous curve is used as the starting point, 
the
!     # next two points in the sequence are control points, and the third is
!     # the ending point. 
  BOOL
  PolyBezier(handle, ...)
***************
*** 717,722 ****
      # The first curve is drawn from the current position to the third point by
      # using the first two points as control points. For each subsequent 
curve, 
!     # the function needs exactly three more points, and uses the ending point 
of
!     # the previous curve as the starting point for the next.
  BOOL
  PolyBezierTo (handle, ...)
--- 733,738 ----
      # The first curve is drawn from the current position to the third point by
      # using the first two points as control points. For each subsequent 
curve, 
!     # the function needs exactly three more points, and uses the ending point
!     # of the previous curve as the starting point for the next.
  BOOL
  PolyBezierTo (handle, ...)
***************
*** 828,832 ****
      
###########################################################################
      # (@)METHOD:DrawFocusRect(LEFT, TOP, RIGHT, BOTTOM)
!     # Draws a rectangle in the style used to indicate that the rectangle has 
the focus. 
  BOOL
  DrawFocusRect(handle, left, top, right, bottom)
--- 844,849 ----
      
###########################################################################
      # (@)METHOD:DrawFocusRect(LEFT, TOP, RIGHT, BOTTOM)
!     # Draws a rectangle in the style used to indicate that the rectangle has
!     # the focus. 
  BOOL
  DrawFocusRect(handle, left, top, right, bottom)
***************
*** 908,913 ****
      # (@)METHOD:ROP2([MODE])
      # Gets or sets the foreground mix mode of the specified device context. 
!     # The mix mode specifies how the pen or interior color and the color 
already
!     # on the screen are combined to yield a new color.     
  long
  ROP2(handle, mode=-1)
--- 925,930 ----
      # (@)METHOD:ROP2([MODE])
      # Gets or sets the foreground mix mode of the specified device context. 
!     # The mix mode specifies how the pen or interior color and the color
!     # already on the screen are combined to yield a new color.     
  long
  ROP2(handle, mode=-1)
***************
*** 1106,1110 ****
      
###########################################################################
      # (@)METHOD:PathToRegion()
!     # Creates a region from the path that is selected into the specified 
device context. 
  HRGN
  PathToRegion(handle)
--- 1123,1128 ----
      
###########################################################################
      # (@)METHOD:PathToRegion()
!     # Creates a region from the path that is selected into the specified
!     # device context. 
  HRGN
  PathToRegion(handle)
***************
*** 1153,1157 ****
      # (@)METHOD:WidenPath()
      # Redefines the current path as the area that would be painted if the path
!     # were stroked using the pen currently selected into the given device 
context. 
  BOOL
  WidenPath(handle)
--- 1171,1176 ----
      # (@)METHOD:WidenPath()
      # Redefines the current path as the area that would be painted if the path
!     # were stroked using the pen currently selected into the given device
!     # context. 
  BOOL
  WidenPath(handle)
***************
*** 1271,1275 ****
      
###########################################################################
      # (@)METHOD:DrawIcon(Icon,X, Y)
!     # The DrawIcon method draws an icon or cursor into the specified device 
context.
  int
  DrawIcon(handle, Icon, x, y)
--- 1290,1295 ----
      
###########################################################################
      # (@)METHOD:DrawIcon(Icon,X, Y)
!     # The DrawIcon method draws an icon or cursor into the specified
!     # device context.
  int
  DrawIcon(handle, Icon, x, y)
***************
*** 1285,1290 ****
      
###########################################################################
      # (@)METHOD:SetBrushOrgEx(X, Y)
!     # The SetBrushOrgEx method sets the brush origin that GDI assigns to the 
next 
!     # brush an application selects into the specified device context. 
      # Returns the (x,y) of the previous brush origin. 
  void
--- 1305,1310 ----
      
###########################################################################
      # (@)METHOD:SetBrushOrgEx(X, Y)
!     # The SetBrushOrgEx method sets the brush origin that GDI assigns to
!     # the next brush an application selects into the specified device 
context. 
      # Returns the (x,y) of the previous brush origin. 
  void
***************
*** 1304,1308 ****
      
###########################################################################
      # (@)METHOD:GetBrushOrgEx
!     # The GetBrushOrgEx method retrieves the current brush origin (x,y) for 
the specified device context. 
  void
  GetBrushOrgEx(handle)
--- 1324,1329 ----
      
###########################################################################
      # (@)METHOD:GetBrushOrgEx
!     # The GetBrushOrgEx method retrieves the current brush origin (x,y)
!     # for the specified device context. 
  void
  GetBrushOrgEx(handle)
***************
*** 1404,1408 ****
      
###########################################################################
      # (@)METHOD:PaintRgn (Region)
!     # The PaintRgn function paints the specified region by using the brush 
currently selected into the device context. 
  BOOL
  PaintRgn(handle,hrgn)
--- 1425,1430 ----
      
###########################################################################
      # (@)METHOD:PaintRgn (Region)
!     # The PaintRgn function paints the specified region by using the brush
!     # currently selected into the device context. 
  BOOL
  PaintRgn(handle,hrgn)
***************
*** 1416,1420 ****
      
###########################################################################
      # (@)METHOD:FrameRgn (Region,Brush,Width,Height)
!     # The FrameRgn function draws a border around the specified region by 
using the specified brush.  
      #
      # The Width Specifies the width of vertical brush strokes. 
--- 1438,1443 ----
      
###########################################################################
      # (@)METHOD:FrameRgn (Region,Brush,Width,Height)
!     # The FrameRgn function draws a border around the specified region
!     # by using the specified brush.  
      #
      # The Width Specifies the width of vertical brush strokes. 
***************
*** 1434,1440 ****
      
###########################################################################
      # (@)METHOD:SelectClipRgn (Region)
!     # This method selects a region as the current clipping region for the 
specified device context.
      #
!     # If no region is passed, then this method will remove a device-context's 
clipping region. 
  BOOL
  SelectClipRgn(handle,hrgn=NULL)
--- 1457,1465 ----
      
###########################################################################
      # (@)METHOD:SelectClipRgn (Region)
!     # This method selects a region as the current clipping region for
!     # the specified device context.
      #
!     # If no region is passed, then this method will remove a
!     # device-context's clipping region. 
  BOOL
  SelectClipRgn(handle,hrgn=NULL)
***************
*** 1637,1641 ****
      
###########################################################################
      # (@)METHOD:CreateRectRgn (LEFT, TOP, RIGHT, BOTTOM)
!     # The CreateRectRgn function creates a rectangular region, returning a 
region object.
  void   
  CreateRectRgn(Class="Win32::GUI::Region",left, top, right, bottom)
--- 1662,1667 ----
      
###########################################################################
      # (@)METHOD:CreateRectRgn (LEFT, TOP, RIGHT, BOTTOM)
!     # The CreateRectRgn function creates a rectangular region, returning a
!     # region object.
  void   
  CreateRectRgn(Class="Win32::GUI::Region",left, top, right, bottom)
***************
*** 1655,1663 ****
      
###########################################################################
      # (@)METHOD: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. 
  void 
--- 1681,1691 ----
      
###########################################################################
      # (@)METHOD: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. 
  void 
***************
*** 1677,1683 ****
      
###########################################################################
      # (@)METHOD: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. 
  void 
  CreateRoundRectRgn(Class="Win32::GUI::Region",left, top, right, bottom, 
width, height)
--- 1705,1713 ----
      
###########################################################################
      # (@)METHOD: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. 
  void 
  CreateRoundRectRgn(Class="Win32::GUI::Region",left, top, right, bottom, 
width, height)
***************
*** 1697,1714 ****
  
      
###########################################################################
!     # (@)METHOD:ExtCreateRgn (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 bytes by hand, or more easily by using the 
L<GetRgnData()|GetRgnData>
!     # method.
      #
      #   my $rgn = Win32::GUI::Region->CreateRoundRectRgn(0,0,100,100,50,50);
!     #   my $rgndata = $rgn->GetRgnData();
!     #   my $newrgn = Win32::GUI::Region->ExtCreateRgn($rgndata);
      #
      # Returns a Win32::GUI::Region object on success or undef on failure
  void
! ExtCreateRgn(Class="Win32::GUI::Region", svrgndata)
      char *Class
      SV *svrgndata
--- 1727,1744 ----
  
      
###########################################################################
!     # (@)METHOD: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
!     # L<GetRgnData()|Win32::GUI::Region/GetRegionData> 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
  void
! ExtCreateRegion(Class="Win32::GUI::Region", svrgndata)
      char *Class
      SV *svrgndata
***************
*** 1725,1737 ****
  
      
###########################################################################
!     # (@)METHOD:GetRgnData ()
      #
!     # The GetRgnData functions returns a representation of the region as a 
string
!     # of bytes that can be used to re-create an identical region using the
!     # L<ExtCreateRgn()|ExtCreateRgn> method.
      #
      # Returns a string of bytes on success or undef on failure
  void
! GetRgnData(handle)
      HRGN handle
  PREINIT:
--- 1755,1767 ----
  
      
###########################################################################
!     # (@)METHOD: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 L<ExtCreateRgn()|Win32::GUI::Region/ExtCreateRegion> method.
      #
      # Returns a string of bytes on success or undef on failure
  void
! GetRegionData(handle)
      HRGN handle
  PREINIT:
***************
*** 1756,1775 ****
      
###########################################################################
      # (@)METHOD: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. 
  int CombineRgn(destination,source1,source2,CombineMode)
    HRGN destination
--- 1786,1805 ----
      
###########################################################################
      # (@)METHOD: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. 
  int CombineRgn(destination,source1,source2,CombineMode)
    HRGN destination
***************
*** 1784,1791 ****
      
###########################################################################
      # (@)METHOD: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. 
  BOOL
--- 1814,1821 ----
      
###########################################################################
      # (@)METHOD: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. 
  BOOL
***************
*** 1801,1809 ****
      
###########################################################################
      # (@)METHOD: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.
  BOOL
  RectInRegion(handle,left, top, right, bottom)
--- 1831,1842 ----
      
###########################################################################
      # (@)METHOD: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.
  BOOL
  RectInRegion(handle,left, top, right, bottom)
***************
*** 1826,1830 ****
      
###########################################################################
      # (@)METHOD: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)
--- 1859,1864 ----
      
###########################################################################
      # (@)METHOD: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)
***************
*** 1845,1849 ****
      
###########################################################################
      # (@)METHOD: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.
  BOOL
  EqualRgn(handle,other)
--- 1879,1885 ----
      
###########################################################################
      # (@)METHOD: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.
  BOOL
  EqualRgn(handle,other)
***************
*** 1857,1861 ****
      
###########################################################################
      # (@)METHOD:SetRectRgn (left, top, right, bottom)
!     # The SetRectRgn function converts a region into a rectangular region 
with the specified coordinates. 
      #
  BOOL
--- 1893,1898 ----
      
###########################################################################
      # (@)METHOD:SetRectRgn (left, top, right, bottom)
!     # The SetRectRgn function converts a region into a rectangular region
!     # with the specified coordinates. 
      #
  BOOL
***************
*** 1875,1879 ****
      # 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. 
--- 1912,1917 ----
      # 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. 

Index: CHANGELOG
===================================================================
RCS file: /cvsroot/perl-win32-gui/Win32-GUI/CHANGELOG,v
retrieving revision 1.90
retrieving revision 1.91
diff -C2 -d -r1.90 -r1.91
*** CHANGELOG   24 Jun 2006 14:53:12 -0000      1.90
--- CHANGELOG   26 Jun 2006 18:22:52 -0000      1.91
***************
*** 6,9 ****
--- 6,13 ----
  Win32-GUI ChangeLog
  ===================
+ + [Robert May] : 26 June 2006 - Rename ExtCreateRgn and GetRgnData
+     - DC.xs - rename ExtCreateRgn and GetRgnData to ExtCreateRegion
+       and GetRegionData to match win32 API names
+ 
  + [Robert May] : 24 June 2006 - ExtCreateRgn and GetRgnData
      - DC.xs - added new region construction ExtCreateRgn and


Reply via email to