CDC::SelectClipRgn
Wählt den angegebenen Bereich als aktuelle Clippingbereich für den Gerätekontext aus.
int SelectClipRgn(
CRgn* pRgn
);
int SelectClipRgn(
CRgn* pRgn,
int nMode
);
Parameter
pRgn
Identifiziert den ausgewählt werden, Bereich.Für die erste Version dieser Funktion, wenn dieser Wert NULL ist, wird der gesamte Clientbereich markierten und Ausgabe wird trotzdem im Fenster abgeschnitten.
Für die zweite Version dieser Funktion, kann dieses Handle NULL sein, wenn der RGN_COPY Modus angegeben wird.
nMode
Gibt den auszuführende Operation fest. Er muss einer der folgenden Werte sein:RGN_AND der neue Clippingbereich kombiniert die überlappende Bereiche des aktuellen Clippingbereichs und des Bereichs, die von pRgn identifiziert werden.
RGN_COPY der neue Clippingbereich ist eine Kopie des Bereichs, der von pRgn identifiziert wird. Dies ist Funktionalität ist identisch mit der ersten Version von SelectClipRgn. Wenn der Bereich, der von pRgn identifiziert wird, NULL ist, wird der neue Standard Clippingbereich Clippingbereich ein Bereich (NULL).
RGN_DIFF der neue Clippingbereich kombiniert die Bereiche des aktuellen Clippingbereichs mit diesen Bereichen, die aus dem Bereich ausgeschlossen werden, der von pRgn identifiziert wird.
RGN_OR der neue Clippingbereich kombiniert den aktuellen Clippingbereich und, die von pRgn identifiziert werden.
RGN_XOR der neue Clippingbereich kombiniert den aktuellen Clippingbereich und, die von pRgn jedoch identifiziert werden, schließt alle überlappende Bereiche aus.
Rückgabewert
Der Typ des Bereichs. Er kann einer der folgenden Werte sein:
Neuer Clippingbereich COMPLEXREGION hat überlappende Rahmen.
ERROR Gerätekontext oder -Bereich ist ungültig.
Neuer Clippingbereich NULLREGION ist leer.
Neuer Clippingbereich SIMPLEREGION hat keine überlappenden Rahmen.
Hinweise
Nur eine Kopie des ausgewählten Bereichs wird verwendet. Der Bereich selbst kann für eine beliebige Anzahl anderer Gerätekontexte ausgewählt werden, oder er kann gelöscht werden.
Die Funktion wird davon ausgegangen, dass die Koordinaten für den angegebenen Bereich in den Geräteeinheiten angegeben werden. Einige Druckergeräten-Stütztextausgabe an einer höheren Auflösung als die Grafiken ausgegeben, um die Genauigkeit beizubehalten erforderlich, um Textmetrik auszudrücken. Diese Gerätenberichtsgeräteeinheiten an der höheren Auflösung h. in den Texteinheiten. Diese Geräte skalieren dann Koordinaten für Grafiken damit Zuordnung mehrerer gemeldete Geräteeinheiten zu nur 1 grafischer Einheit. Sie sollten die SelectClipRgn-Funktion mithilfe der Texteinheiten immer aufrufen.
Anwendungen, die annehmen, müssen die Skalierung von Grafiken Objekte im GDI können das GETSCALINGFACTOR Druckerescape verwenden, um den Skalierungsfaktor ein zu bestimmen. Dieser Skalierungsfaktor beeinflusst Clipping. Wenn ein Bereich verwendet wird, um Grafiken abgeschnitten werden, unterteilt GDI die Koordinaten durch den Skalierungsfaktor. Wenn der Bereich verwendet wird, um Text für, nimmt GDI keine Skalierungsanpassung vor. Ein Skalierungsfaktor von 1 wird die Koordinaten, durch 2 geteilt werden; ein Skalierungsfaktor von 2 Ursachen die durch 4 geteilt werden Koordinaten; u. a.
Anforderungen
Header: afxwin.h