###User Defined Function###
_WinAPI_AddIconTransparency

###Description###
Adds a transparency to the specified 32 bits-per-pixel icon.

###Syntax###
#include <WinAPIRes.au3>
_WinAPI_AddIconTransparency ( $hIcon [, $iPercent = 50 [, $fDelete = 0]] )


###Parameters###
@@ParamTable@@
$hIcon
	Handle to the icon.
$iPercent
	[optional] A value (in percent) that specifies how much to decrease the values of the alpha channel for the
	specified icon. If this parameter is 0, the function returns a fully transparent icon. Default is 80.
$fDelete
	[optional] Specifies whether to delete the icon after the function is successful, valid values:
	True     - Icon will be deleted if the function succeeds.
	False    - Do not delete, you must release the icon when you are finished using it (Default).
@@End@@

###ReturnValue###
@@ReturnTable@@
Success 	Handle to the newly created icon.
Failure 	0 and sets the @error flag to non-zero.
@@End@@


###Remarks###
This function only works with 32 bits-per-pixel with alpha chanel (RGB + Alpha) icons.
If the source icon has no alpha chanel, the resulting icon will be the same as the source icon. If the source icon is non 32 bits-per-pixel, the function fails.

When you are finished using the icon, destroy it using the <a href="_WinAPI_DestroyIcon.htm">_WinAPI_DestroyIcon()</a> function.


###Related###
_WinAPI_DestroyIcon


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