Freigeben über


SetMapMode-Funktion (wingdi.h)

Die SetMapMode-Funktion legt den Zuordnungsmodus des angegebenen Gerätekontexts fest. Der Zuordnungsmodus definiert die Maßeinheit, die zum Transformieren von Seitenraumeinheiten in Geräteraumeinheiten verwendet wird, und definiert auch die Ausrichtung der x- und y-Achsen des Geräts.

Syntax

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

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] iMode

Der neue Zuordnungsmodus. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
MM_ANISOTROPIC
Logische Einheiten werden beliebigen Einheiten mit beliebig skalierten Achsen zugeordnet. Verwenden Sie die Funktionen SetWindowExtEx und SetViewportExtEx, um die Einheiten, die Ausrichtung und die Skalierung anzugeben.
MM_HIENGLISH
Jede logische Einheit wird 0,001 Zoll zugeordnet. Positives x ist rechts; positives y ist positiv.
MM_HIMETRIC
Jede logische Einheit wird 0,01 Millimetern zugeordnet. Positives x ist rechts; positives y ist positiv.
MM_ISOTROPIC
Logische Einheiten werden beliebigen Einheiten mit gleich skalierten Achsen zugeordnet; Das heißt, eine Einheit entlang der x-Achse ist gleich einer Einheit entlang der y-Achse. Verwenden Sie die Funktionen SetWindowExtEx undSetViewportExtEx, um die Einheiten und die Ausrichtung der Achsen anzugeben. Die Grafikgeräteschnittstelle (Graphics Device Interface, GDI) nimmt bei Bedarf Anpassungen vor, um sicherzustellen, dass die x- und y-Einheiten die gleiche Größe behalten (Wenn die Fensterausdehnung festgelegt ist, wird der Viewport angepasst, um die Einheiten isotrop zu halten).
MM_LOENGLISH
Jede logische Einheit wird 0,01 Zoll zugeordnet. Positives x ist rechts; positives y ist positiv.
MM_LOMETRIC
Jede logische Einheit wird 0,1 Millimetern zugeordnet. Positives x ist rechts; positives y ist positiv.
MM_TEXT
Jede logische Einheit wird einem Gerätepixel zugeordnet. Positives x ist rechts; positives y ist ausgefallen.
MM_TWIPS
Jede logische Einheit wird einem Zwanzigstel des Punkts eines Druckers (1/1440 Zoll, auch als Twip bezeichnet) zugeordnet. Positives x ist rechts; positives y ist positiv.

Rückgabewert

Wenn die Funktion erfolgreich ist, identifiziert der Rückgabewert den vorherigen Zuordnungsmodus.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Der MM_TEXT Modus ermöglicht es Anwendungen, in Gerätepixeln zu arbeiten, deren Größe von Gerät zu Gerät variiert.

Die Modi MM_HIENGLISH, MM_HIMETRIC, MM_LOENGLISH, MM_LOMETRIC und MM_TWIPS sind nützlich für Anwendungen, die physisch aussagekräftige Einheiten (z. B. Zoll oder Millimeter) zeichnen.

Der MM_ISOTROPIC Modus stellt ein Seitenverhältnis von 1:1 sicher.

Der MM_ANISOTROPIC Modus ermöglicht es, die X- und Y-Koordinaten unabhängig voneinander anzupassen.

Beispiele

Ein Beispiel finden Sie unter Verwenden von Koordinatenräumen und Transformationen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wingdi.h (windows.h einschließen)
Bibliothek Gdi32.lib
DLL Gdi32.dll

Weitere Informationen

Koordinatenraum und Transformationsfunktionen

Übersicht über Koordinatenräume und Transformationen

GetMapMode

SetViewportExtExtEx

SetViewportOrgEx

SetWindowExtExt

SetWindowOrgEx