###User Defined Function###
_GDIPlus_PenCreate

###Description###
Create a pen object

###Syntax###
#include <GDIPlus.au3>
_GDIPlus_PenCreate ( [$iARGB = 0xFF000000 [, $nWidth = 1 [, $iUnit = 2]]] )


###Parameters###
@@ParamTable@@
$iARGB
	[optional] Alpha, Red, Green and Blue components of pen color
$nWidth
	[optional] The width of the pen measured in the units specified in the $iUnit parameter
$iUnit
	[optional] Unit of measurement for the pen size:
		0 - World coordinates, a nonphysical unit
		1 - Display units
		2 - A unit is 1 pixel
		3 - A unit is 1 point or 1/72 inch
		4 - A unit is 1 inch
		5 - A unit is 1/300 inch
		6 - A unit is 1 millimeter
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	a handle to a pen object.
Failure:	0 and sets the @error flag to non-zero, @extended may contain GPSTATUS ($GPID_ERR*).
@@End@@


###Remarks###
When you are done with the pen, call <a href="_GDIPlus_PenDispose.htm">_GDIPlus_PenDispose()</a> to release the resources.


###Related###
_GDIPlus_PenDispose


###See Also###
@@MsdnLink@@ GdipCreatePen1


###Example###
@@IncludeExample@@
