Partager via


Fonction SetMapMode (wingdi.h)

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

Voir aussi

Fonctions d’espace de coordonnées et de transformation

Vue d’ensemble des espaces de coordonnées et des transformations

GetMapMode

SetViewportExtEx

SetViewportOrgEx

SetWindowExtEx

SetWindowOrgEx