Function Reference


_GDIPlus_ImageGetPropertyItem

Gets a specified property item (piece of meta data) from an Image object

#include <GDIPlus.au3>
_GDIPlus_ImageGetPropertyItem ( $hImage, $iPropID )

Parameters

$hImage A pointer to an image object.
$iPropID An identifier of the property item to be retrieved.

Return Value

Success: Array containing the values of the property item:
            [0] - number of values
            [1] - value 1
            [2] - value 2
            [n] - value n
Failure: Sets the @error flag to non-zero, @extended may contain GPSTATUS error code ($GPIP_ERR* see GPIPlusConstants.au3).

Related

_GDIPlus_ImageGetPropertyIdList

See Also

Search GdipGetPropertyItem in MSDN Library.

Example

#include <Array.au3>
#include <GDIPlus.au3>

Example()

Func Example()
        _GDIPlus_Startup()

        ; X64 running support
        Local $sWow64 = ""
        If @AutoItX64 Then $sWow64 = "\Wow6432Node"

        Local $hImage = _GDIPlus_ImageLoadFromFile(RegRead("HKLM\SOFTWARE" & $sWow64 & "\AutoIt v3\AutoIt", "InstallDir") & "\Examples\GUI\Torus.png")
        If @error Then
                _GDIPlus_Shutdown()
                MsgBox(16, "", "An error has occured - unable to load image!", 30)
                Return False
        EndIf

        Local $aPropID = _GDIPlus_ImageGetPropertyIdList($hImage)
        _ArrayDisplay($aPropID)

        Local $aValues
        For $i = 1 To $aPropID[0][0]
                $aValues = _GDIPlus_ImageGetPropertyItem($hImage, $aPropID[$i][0])
                _ArrayDisplay($aValues, $aPropID[$i][1])
        Next

        _GDIPlus_ImageDispose($hImage)
        _GDIPlus_Shutdown()
EndFunc   ;==>Example