Fonction SetMapMode (wingdi.h)

Article
03/13/2024

La fonction SetMapMode définit le mode de mappage du contexte d’appareil spécifié. Le mode de mappage définit l’unité de mesure utilisée pour transformer les unités d’espace de page en unités d’espace de l’appareil, et définit également l’orientation des axes x et y de l’appareil.

Syntaxe

int SetMapMode(
  [in] HDC hdc,
  [in] int iMode
);

Paramètres

[in] hdc

Handle dans le contexte de l’appareil.

[in] iMode

Nouveau mode de mappage. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
MM_ANISOTROPIC	Les unités logiques sont mappées à des unités arbitraires avec des axes arbitrairement mis à l’échelle. Utilisez les fonctions SetWindowExtEx et SetViewportExtEx pour spécifier les unités, l’orientation et la mise à l’échelle.
MM_HIENGLISH	Chaque unité logique est mappée à 0,001 pouce. X positif est à droite ; positif y est en hausse.
MM_HIMETRIC	Chaque unité logique est mappée à 0,01 millimètre. X positif est à droite ; positif y est en hausse.
MM_ISOTROPIC	Les unités logiques sont mappées à des unités arbitraires avec des axes identiques ; autrement dit, une unité le long de l’axe des X est égale à une unité le long de l’axe y. Utilisez les fonctions SetWindowExtEx et SetViewportEx pour spécifier les unités et l’orientation des axes. L’interface de périphérique graphique (GDI) effectue les ajustements nécessaires pour s’assurer que les unités x et y restent de la même taille (Lorsque l’étendue de la fenêtre est définie, la fenêtre d’affichage est ajustée pour conserver les unités isotropes).
MM_LOENGLISH	Chaque unité logique est mappée à 0,01 pouce. X positif est à droite ; positif y est en hausse.
MM_LOMETRIC	Chaque unité logique est mappée à 0,1 millimètre. X positif est à droite ; positif y est en hausse.
MM_TEXT	Chaque unité logique est mappée à un pixel d’appareil. X positif est à droite ; positif y est en baisse.
MM_TWIPS	Chaque unité logique est mappée à un vingtième point d’imprimante (1/1440 pouce, également appelé twip). X positif est à droite ; positif y est en hausse.

Valeur retournée

Si la fonction réussit, la valeur de retour identifie le mode de mappage précédent.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

Le mode MM_TEXT permet aux applications de fonctionner en pixels d’appareil, dont la taille varie d’un appareil à l’autre.

Les modes MM_HIENGLISH, MM_HIMETRIC, MM_LOENGLISH, MM_LOMETRIC et MM_TWIPS sont utiles pour les applications qui dessinent des unités physiquement significatives (comme des pouces ou des millimètres).

Le mode MM_ISOTROPIC garantit un rapport d’aspect 1 :1.

Le mode MM_ANISOTROPIC permet d’ajuster indépendamment les coordonnées x et les coordonnées y.

Exemples

Pour obtenir un exemple, consultez Utilisation d’espaces de coordonnées et de transformations.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll