Share via


setMapMode 函式 (wingdi.h)

SetMapMode 函式會設定指定裝置內容的對應模式。 對應模式會定義用來將頁面空間單位轉換成裝置空間單位的測量單位,也會定義裝置 x 和 y 軸的方向。

語法

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

參數

[in] hdc

裝置內容的句柄。

[in] iMode

新的對應模式。 此參數可以是下列其中一個值。

意義
MM_ANISOTROPIC
邏輯單元會對應至任意縮放軸的任意單位。 使用 SetWindowExtExSetViewportExtEx 函式來指定單位、方向和縮放比例。
MM_HIENGLISH
每個邏輯單元都會對應至0.001英吋。 正 x 向右;正 y 向上。
MM_HIMETRIC
每個邏輯單元都會對應至0.01公厘。 正 x 向右;正 y 向上。
MM_ISOTROPIC
邏輯單元會對應至具有相同縮放軸的任意單位;也就是說,沿著 x 軸的一個單位等於沿著 Y 軸的一個單位。 使用 SetWindowExtExSetViewportExtEx 函式來指定座標軸的單位和方向。 圖形裝置介面 (GDI) 視需要進行調整,以確保 x 和 y 單位維持相同的大小 (設定視窗範圍時,檢視區會調整為保留單位等向) 。
MM_LOENGLISH
每個邏輯單元都會對應至0.01英吋。 正 x 向右;正 y 向上。
MM_LOMETRIC
每個邏輯單元都會對應至0.1公厘。 正 x 向右;正 y 向上。
MM_TEXT
每個邏輯單元都會對應至一個裝置圖元。 正 x 向右;正 y 已關閉。
MM_TWIPS
每個邏輯單元都會對應到印表機點 (1/1440 英吋的一倍,也稱為 twip) 。 正 x 向右;正 y 向上。

傳回值

如果函式成功,傳回值會識別先前的對應模式。

如果此函式失敗,則傳回值為零。

備註

MM_TEXT模式可讓應用程式以裝置圖元運作,其大小會因裝置而異。

MM_HIENGLISH、MM_HIMETRIC、MM_LOENGLISH、MM_LOMETRIC和MM_TWIPS模式適用於以實體有意義的單位繪製應用程式 (,例如英吋或公厘) 。

MM_ISOTROPIC模式可確保 1:1 的外觀比例。

MM_ANISOTROPIC模式可讓 x 座標和 y 座標獨立調整。

範例

如需範例,請參閱 使用座標空間和轉換

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 wingdi.h (包含 Windows.h)
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱

座標空間和轉換函式

座標空間和轉換概觀

GetMapMode

SetViewportExtEx

SetViewportOrgEx

SetWindowExtEx

SetWindowOrgEx