setMetaRgn 函式 (wingdi.h)

SetMetaRgn 函式會與目前中繼區域交集指定裝置內容的目前裁剪區域,並將合併的區域儲存為指定裝置內容的新中繼區域。 裁剪區域會重設為 Null 區域。

語法

int SetMetaRgn(
  [in] HDC hdc
);

參數

[in] hdc

裝置內容的句柄。

傳回值

傳回值會指定新裁剪區域的複雜度,而且可以是下列其中一個值。

傳回碼 Description
NULLREGION
區域是空的。
SIMPLEREGION
區域是單一矩形。
COMPLEXREGION
區域是一個以上的矩形。
ERROR
發生錯誤。 (前一個裁剪區域不受影響。)

備註

裝置內容的目前裁剪區域是由其裁剪區域及其中繼區域交集所定義。

只有在呼叫 SaveDC 函式來儲存應用程式的原始裝置內容之後,才應該呼叫 SetMetaRgn 函式。

規格需求

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

另請參閱

裁剪函式

裁剪概觀

GetMetaRgn

SaveDC