Function Reference


_GDIPlus_RegionCreateFromRect

Creates a region that is defined by a rectangle

#include <GDIPlus.au3>
_GDIPlus_RegionCreateFromRect ( $nX, $nY, $nWidth, $nHeight )

Parameters

$nX The X coordinate of the upper left corner of the rectangle
$nY The Y coordinate of the upper left corner of the rectangle
$nWidth The width of the rectangle
$nHeight The height of the rectangle

Return Value

Success: a handle to a new Region object.
Failure: 0 and sets the @error flag to non-zero, @extended may contain GPSTATUS error code ($GPID_ERR*).

Remarks

After you are done with the object, call _GDIPlus_RegionDispose() to release the object resources.

Related

_GDIPlus_RegionDispose

See Also

Search GdipCreateRegionRect in MSDN Library.

Example

#include <GDIPlus.au3>
#include <GUIConstantsEx.au3>

Example()

Func Example()
    Local $hGUI, $hPath, $hFamily, $tLayout, $aSize, $hRegion, $hRGN

    _GDIPlus_Startup()

    $hGUI = GUICreate("GDI+", 620, 100)
    GUISetBkColor(0x80) ;Set window background color to blue
    GUISetState(@SW_SHOW)

    $hPath = _GDIPlus_PathCreate() ;Create new path object

    $hFamily = _GDIPlus_FontFamilyCreate("Arial Black") ;Create font family object
    $tLayout = _GDIPlus_RectFCreate() ;Create string bounding rectangle X=0, Y=0
    _GDIPlus_PathAddString($hPath, "AutoIt rulez!", $tLayout, $hFamily, 0, 85, 0) ;Add the outline of the string to the path

    $aSize = WinGetPos($hGUI) ;Get windowsize

    $hRegion = _GDIPlus_RegionCreateFromRect(0, 0, 110, $aSize[3]) ;Create region from a rectangle
    _GDIPlus_RegionCombineRect($hRegion, $aSize[2] - 110, 0, 110, $aSize[3], 2) ;Combine rectangle_left AND rectangle_right
    _GDIPlus_RegionCombinePath($hRegion, $hPath, 3) ;Combine rectangles XOR string

    $hRGN = _GDIPlus_RegionGetHRgn($hRegion, 0) ;Create GDI region from GDI+ region
    _WinAPI_SetWindowRgn($hGUI, $hRGN) ;Set window region

    ;Loop until user exits
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE

    ;Clean up resources
    _GDIPlus_FontFamilyDispose($hFamily)
    _WinAPI_DeleteObject($hRGN)
    _GDIPlus_RegionDispose($hRegion)
    _GDIPlus_PathDispose($hPath)
    _GDIPlus_Shutdown()
EndFunc   ;==>Example