CDC::SelectClipRgn

發行項
02/28/2013

選取特定區域做為目前裁剪區域的裝置內容。

int SelectClipRgn(
   CRgn* pRgn 
);
int SelectClipRgn(
   CRgn* pRgn,
   int nMode 
);

參數

pRgn
識別所要選取的區域。
- 如需此函式的第一個版本，則為，如果這個值是 NULL，整個工作區已經選取，然後輸出仍會裁剪至視窗。
- 對於此函式的第二個版本，只有在 RGN_COPY 模式時，指定，這個控制代碼可以是 NULL 。
nMode
指定要執行的作業。它必須是下列其中一個值:
- RGN_AND 新裁剪區域合併 pRgn和區域之識別的重疊區域目前裁剪區域。
- RGN_COPY 新裁剪區域是 pRgn判斷的本機複本。這是功能與 SelectClipRgn第一版相同。如果 pRgn 判斷的區域是 NULL，新的裁剪區域成為預設裁剪區域 (空區域中)。
- RGN_DIFF 新裁剪區域合併目前裁剪區域的區域與區域排除的區域由 pRgn。
- RGN_OR 新裁剪區域合併 pRgn和區域用於判斷目前的裁剪區域。
- RGN_XOR 新裁剪區域合併 pRgn 和區域用於判斷目前的裁剪區域，但不包括所有重疊區域。

傳回值

區域的型別。它可以是下列其中一個值:

COMPLEXREGION 新裁剪區域有重疊的框線。
錯誤裝置內容或區域無效。
NULLREGION 新裁剪區域是空的。
SIMPLEREGION 新裁剪區域不重疊的框線。

備註

使用選取的區域上使用複本。這個區域可用於任何數目的其他裝置內容已選取，或將其刪除。

函式會假設，特定區域的座標 (以單位指定。某些印表機的輸出的圖形支援文字輸出在高解析度為了不讓必要的精確度和小數表示文字度量資訊。這些裝置報告單位在高解析度，也就是說，在文字單元。這些裝置來縮放圖形的座標，讓數個報告的單位只會對應至 1 個圖形單位。使用文字單位，您應一律呼叫。 SelectClipRgn 函式。

必須採取的應用程式圖表自動縮放比例 GDI 物件可使用 GETSCALINGFACTOR 印表機逸出決定縮放比例。這個縮放比例會影響裁剪。如果區域來裁剪圖形，由 GDI 縮放比例來分割座標。如果區域來裁剪文字， GDI 不進行縮放比例調整。縮放比例為 1 會讓座標除以 2，2 會縮放因數 4 將刪除的座標，等等。