CDC::SelectClipRgn

Artykuł
02/27/2013

Wybiera danego regionu jako bieżący region przycinania kontekstu urządzenia.

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

Parametry

pRgn
Identyfikuje regionu, które mają być wybrane.
- Dla pierwszej wersji funkcji, jeśli ta wartość jest NULL, całego obszaru klienta jest zaznaczone i wyjściowy jest nadal przycięty do okna.
- Druga wersja tej funkcji, ten uchwyt może być NULL tylko wtedy, gdy RGN_COPY określono tryb.
nMode
Określa wykonywanej operacji.Musi być jedną z następujących wartości:
- RGN_AND nowy region przycinania łączy nakładające się obszary bieżący region przycinania i regionu określonego przez pRgn.
- RGN_COPY nowy region przycinania jest kopią regionu określonego przez pRgn.Jest to funkcja jest identyczne z pierwszej wersji SelectClipRgn.Jeśli region identyfikowane przez pRgn jest NULL, nowy region przycinania staje się domyślną odcinania region (null region).
- RGN_DIFF nowy region przycinania łączy obszary bieżącego obszaru przycinania z tych obszarów wyłączone z regionu określonego przez pRgn.
- RGN_OR nowy region przycinania łączy bieżącego obszaru przycinania i regionu określonego przez pRgn.
- RGN_XOR nowy region przycinania łączy bieżącego obszaru przycinania i regionu określonego przez pRgn , ale nie obejmuje wszystkie nakładające się obszary.

Wartość zwracana

Typ regionu.Może być dowolną z następujących wartości:

COMPLEXREGION nowy region odcinania ma nakładających się obramowanie.
Błąd kontekstu urządzenia lub region jest nieprawidłowy.
NULLREGION nowy region przycinania jest pusty.
SIMPLEREGION nowy region przycinania nie ma nakładających się obramowania.

Uwagi

Kopię wybranego regionu jest używany.Dla dowolnej liczby innych kontekstach urządzenia można wybrać samego regionu lub mogą być usunięte.

Funkcja zakłada, że współrzędne dla danego regionu są określone w jednostkach urządzenia.Niektóre urządzenia drukarki obsługują tekst wyjściowy w wyższej rozdzielczości niż grafiki, aby zachować dokładność potrzebne do express metryki tekstu.Te urządzenia, to raport urządzenia jednostek w wyższej rozdzielczości, w jednostkach tekstu.Urządzenia te następnie skali współrzędnych dla grafiki, dzięki czemu kilku zgłoszonych do tylko 1 jednostka grafiki mapy jednostek urządzenia.Zawsze powinien wywołać SelectClipRgn działać przy użyciu jednostek tekstu.

Można używać aplikacji, które muszą podjąć skalowanie grafiki obiekty interfejsu GDI GETSCALINGFACTOR escape drukarki, aby określić współczynnik skalowania.Ten współczynnik skalowania dotyczy przycinania.Jeśli region jest używany do grafiki clip art, współrzędne GDI dzieli się przez współczynnik skalowania.Jeśli region jest używany do klipu tekstu, GDI sprawia, że żadne dostosowanie skalowania.Współczynnik skalowania 1 powoduje, że współrzędne podzielona przez 2; współczynnik skalowania 2 powoduje, że współrzędne podzielona przez 4; i tak dalej.