Sdílet prostřednictvím


CDC::SelectClipRgn

Vybere dané oblasti jako aktuální oblast oříznutí pro kontext zařízení.

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

Parametry

  • pRgn
    Určuje oblasti, kterou chcete vybrat.

    • První verze této funkce, pokud je tato hodnota NULL, je vybráno celé oblasti klienta a výstup do okna stále ořízne.

    • Druhá verze této funkce může být tento popisovač NULL pouze tehdy, když RGN_COPY režim je určen.

  • nMode
    Určuje provést operaci.Musí být jedna z následujících hodnot:

    • RGN_AND kombinuje nová oblast oříznutí překrývajících se oblastí aktuální oblast oříznutí a oblasti identifikované pRgn .

    • RGN_COPY novou oblast oříznutí je kopie oblasti identifikované pRgn .Toto je funkce je stejná jako první verzi SelectClipRgn .Pokud oblasti označeny pRgn je NULL, nová oblast oříznutí změní výchozí ořezovou oblast (oblast null).

    • RGN_DIFF kombinuje nová oblast oříznutí oblasti aktuální oblast oříznutí s těchto ploch vyloučeny z oblasti identifikované pRgn .

    • RGN_OR kombinuje nová oblast oříznutí aktuální oblast oříznutí a oblasti identifikované pRgn .

    • RGN_XOR kombinuje nová oblast oříznutí aktuální oblast oříznutí a oblasti identifikované pRgn , ale vylučuje všechny překrývající se oblasti.

Vrácená hodnota

Typ oblasti.Může být některá z následujících hodnot:

  • COMPLEXREGION novou oblast oříznutí má překrývající se okraje.

  • Chyba kontext zařízení nebo oblasti není platný.

  • NULLREGION novou oblast oříznutí je prázdný.

  • SIMPLEREGION novou oblast oříznutí nemá překrývající se okraje.

Poznámky

Používá se pouze kopii vybrané oblasti.Pro libovolný počet jiných kontextech zařízení lze vybrat oblast sám nebo lze odstranit.

Funkce předpokládá, že souřadnice pro danou oblast jsou zadány v jednotkách zařízení.Zařízení některé tiskárny podporují textový výstup s vyšším rozlišením než grafického výstupu pro zachování přesnosti potřeby vyjádřit metriky text.Tato zařízení zprávu jednotek zařízení s vyšším rozlišením, v jednotkách text.Tato zařízení pak měřítko souřadnice pro grafiky tak, aby několik hlášeny pouze 1 jednotka grafické zařízení mapování jednotek.Vždy by měl zavolat SelectClipRgn jednotek textu pomocí funkce.

Pomocí aplikace, které musí brát měřítka grafických objektů rozhraní GDI GETSCALINGFACTOR úniku tiskárnu určit měřítko.Tento faktor změny měřítka ovlivní oříznutí.Pokud je oblast oříznutí grafiky, GDI souřadnice vydělí měřítko.Pokud oblast slouží k oříznutí textu, GDI neposkytuje žádná úprava měřítka.Měřítko 1 způsobí, že souřadnice se vydělí 2; měřítko 2 způsobuje souřadnice se vydělí 4; a tak dále.

Požadavky

Záhlaví: afxwin.h

Viz také

Referenční dokumentace

Třída Nemocnosti

Graf hierarchie

CDC::GetClipBox

CDC::escape

Třída CRgn

SelectClipRgn