函式功能
函式功能:訪函式通過特定的方式把一個特定的區域與當前的剪下區域合併在一起。
函式原型:int ExtSelectClipRgn (HDc hdc, HRGN hrgn, int fnMode);
參數說明
參數:
hdc:設備環境句柄。
hrgn:標識被選擇的區域。當指定RGN_COPY模式時,該句柄只能為NULL。
fnMode:定義執行的運算模式。它必須是下列值之一:
RGN_AND:新的剪下區域與當前剪下區域的重疊部分合併,該區域由hrgn標識。
RGN_COPY:新的剪下區域是由hrgn標識區域的一個拷貝,這和select clipRgn是統一的。如果由hrgn所定義的區域為空。那么新的剪下區域就是預設的剪下區域(預設的剪下區域是個空區域)。
RGN_DIFF:新的剪下區域與由hrgn定義的區域之外的區域合併。
RGN_OR:新的剪下區域與當前的剪下區域合併,並且該區域由hrgn標識。
RGN_XOR:新的剪下區域與當前的剪下區域合併,並且該區域由hrgn指定,但是不包括任何重迭區域。
返回值:返回值表明了新的剪下區域的複雜度,它的值是如下幾種:
NULLREGION:區域為空;
SIMPLEREGION:區域為單個矩形;
COMPLEXREGION:區域為多個矩形;
ERROR:發生了錯誤。
注釋:當該函式調用發生錯誤時,由設備環境定義的以前的前切區域不受影響。ExtselectclipRgn函式假設在設備單元中定義了該特定區域的坐標。使用的僅僅是由hrgn參數定義區域的一個拷貝,而該剪下區域自身還可被再使用,並且它還可被刪除。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:1.0及以上版本;頭檔案:wingdi.h;庫檔案:gdi32.lib。