GdipSetPageUnit()

Resultat.i = GdipSetPageUnit(*graphics, unit.i)

*graphics

[in] Pointeur sur un objet Graphics existant.

unit.i

[in] Unité de mesure à appliquer au graphique qui est un élément de l'énumération Unit.

Cette fonction permet d'appliquer l'unité de mesure voulue au graphique qui est un élément de l'énumération Unit.

L'exemple est le même que pour la fonction GdipSetPageScale().

Exemple :
Dessine une fenêtre.
Le graphique principal (qui correspond au paramètre *graphics de la fonction) est créé à partir du Hdc de la fenêtre principale.
Création d'une Pen rouge.
Application au graphique d'une translation en x de 4 et y de 1.
Application au graphique de l'unité de mesure en millimètre (fonction GdipSetPageUnit() avec l'unité #UnitMillimeter). L'unité de page appartient à la transformation de page.
Application au graphique du facteur de mise à l'échelle de 10.
On dessine un rectangle avec le pen à x = 0, y = 0 largeur = 3 et hauteur 2 millimètres.

Le résultat est un rectangle avec les coordonnées suivantes :

x a une translation de 4 avec un facteur d'échelle de 10 ce qui donne x = 40 et l'unité est le millimètre.
y a une translation de 1 avec un facteur d'échelle de 10 ce qui donne y = 10 et l'unité est le millimètre.
Largeur : 3 multiplié par le facteur d'échelle soit 30 et l'unité est le millimètre.
Hauteur : 2 multiplié par le facteur d'échelle soit 20 et l'unité est le millimètre.

Si la fonction réussit, elle retourne #Ok qui est une constante de l'énumération status.
Si la fonction échoue, elle retourne une des autres valeurs de l'énumération status.