GdiplusStartup()

Resultat.i = GdiplusStartup(@*token, @input.GdiplusStartupInput, @output.GdiplusStartupOutput)

*token

[out] *token recevra une valeur indiquant que l'initialisation a réussie.
Si la fonction réussie, *token doit être passée à la commande GdiplusShutdown() lorsque l'on a terminé d'utiliser GDI+. Voir la page initialisation pour plus d'informations.

input

[in] Paramètre de type GdiplusStartupInput.
Les éléments de la structure contiendront la version de GDI+, un pointeur sur une fonction callback de débogage, une valeur booléenne indiquant comment supprimer le thread de fond GDI+ et une valeur booléenne indiquant comment GDI+ peut supprimer les codecs d'image externes. GDI+ version 1.0 ne supporte pas les codecs externes d'image, ce paramètre est donc ignoré.

output.GdiplusStartupOutput

[in] Paramètre de type GdiplusStartupOutput.
Si ce paramètre est non utilisé, il faut le mettre à #Null.
Les éléments de la structure contiendront un pointeur sur une fonction hook et un pointeur sur une fonction unhook.
Si le membre SuppressBackgroundThread de la structure GdiplusStartupInput (paramètre input) a la valeur #False, alors ce paramètre peut valoir #Null.

La fonction initialise GDI+. Il est obligatoire de l'utiliser avant toute création d'objets GDI+. La fonction GdiplusShutdown() devra être appelée lorsque l'utilisation de GDI+ est terminée. Le wrapper PureBasic pour PB 4.00 permet d'utiliser pour une grande partie des cas (cas courants), la fonction Gdiplus_New() avec la syntaxe simplifiée suivante :

*token = Gdiplus_New()

Gdiplus_New() utilise la fonction GdiplusStartup() avec les paramètres par défaut et retourne la valeur indiquant ou non si l'initialisation a réussie, valeur à utiliser avec GdiplusShutdown()  pour terminer.

A chaque appel de GdiplusStartup() doit correspondre un appel à GdiplusShutdown().

Voici plus d'informations sur l'initialisation de GDI+ : Initialisation

Si la fonction réussit, elle retourne #Ok qui est une constante de l'énumération status  et le paramètre token recevra une valeur qui sera utilisée par la fonction GdiplusShutdown().
Si la fonction échoue, elle retourne une des autres valeurs de l'énumération status.

PureBasic v4.30 bêta 4 (Windows - x86)
Testé avec Windows Vista édition familiale Premium

Tous les exemples utilisent obligatoirement cette fonction, soit directement, soit par l'intermédiaire de la fonction Gdiplus_New() du wrapper PureBasic. Il n'y a pas d'exemple spécifique pour cette fonction.