SetMapMode-Funktion (wingdi.h)

Artikel
08/27/2023

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 und SetViewportExtEx, 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