Funzione SetMapMode (wingdi.h)

Articolo
03/13/2024

La funzione SetMapMode imposta la modalità di mapping del contesto del dispositivo specificato. La modalità di mapping definisce l'unità di misura usata per trasformare le unità di spazio pagina in unità spaziali del dispositivo e definisce anche l'orientamento degli assi x e y del dispositivo.

Sintassi

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

Parametri

[in] hdc

Handle nel contesto del dispositivo.

[in] iMode

Nuova modalità di mapping. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
MM_ANISOTROPIC	Le unità logiche vengono mappate a unità arbitrarie con assi a scalabilità arbitraria. Usare le funzioni SetWindowExtEx e SetViewportExtEx per specificare le unità, l'orientamento e il ridimensionamento.
MM_HIENGLISH	Ogni unità logica viene mappata a 0,001 pollici. Positivo x è a destra; positivo y è in alto.
MM_HIMETRIC	Ogni unità logica viene mappata a 0,01 millimetri. Positivo x è a destra; positivo y è in alto.
MM_ISOTROPIC	Le unità logiche vengono mappate a unità arbitrarie con assi con scalabilità uguale; ovvero, un'unità lungo l'asse x è uguale a un'unità lungo l'asse y. Usare le funzioni SetWindowExtEx e SetViewportExtEx per specificare le unità e l'orientamento degli assi. L'interfaccia del dispositivo grafico (GDI) apporta le modifiche necessarie per garantire che le unità x e y rimangano invariate (quando l'estensione della finestra è impostata, il riquadro di visualizzazione verrà modificato per mantenere le unità isotropiche).
MM_LOENGLISH	Ogni unità logica viene mappata a 0,01 pollici. Positivo x è a destra; positivo y è in alto.
MM_LOMETRIC	Ogni unità logica viene mappata a 0,1 millimetri. Positivo x è a destra; positivo y è in alto.
MM_TEXT	Ogni unità logica viene mappata a un pixel del dispositivo. Positivo x è a destra; positivo y è giù.
MM_TWIPS	Ogni unità logica viene mappata a un ventesimo punto di una stampante (1/1440 pollici, chiamato anche twip). Positivo x è a destra; positivo y è in alto.

Valore restituito

Se la funzione ha esito positivo, il valore restituito identifica la modalità di mapping precedente.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

La modalità MM_TEXT consente alle applicazioni di funzionare in pixel del dispositivo, le cui dimensioni variano da dispositivo a dispositivo.

Le modalità MM_HIENGLISH, MM_HIMETRIC, MM_LOENGLISH, MM_LOMETRIC e MM_TWIPS sono utili per le applicazioni che disegnano in unità fisicamente significative (ad esempio pollici o millimetri).

La modalità MM_ISOTROPIC garantisce un rapporto di aspetto 1:1.

La modalità MM_ANISOTROPIC consente di regolare in modo indipendente le coordinate x e le coordinate y.

Esempio

Per un esempio, vedere Uso di spazi di coordinate e trasformazioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll