GdipGetPageScale()

Resultat.i = GdipGetPageScale(*graphics, @scale.f)

*graphics

[in] Pointeur sur un objet Graphics existant.

scale.f

[out] scale recevra le facteur d'échelle du graphique.

Cette fonction permet de retrouver le facteur de mise à l'échelle pour la transformation de page du graphique. La transformation de page convertit les coordonnées de page en coordonnées device (voir les systèmes de coordonnées).

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.
Retrouve le facteur d'échelle et l'affiche dans la statusbar.

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.