CDC::SelectClipRgn
Sélectionne la zone donnée comme une zone de découpage actuelle pour le contexte de périphérique.
int SelectClipRgn(
CRgn* pRgn
);
int SelectClipRgn(
CRgn* pRgn,
int nMode
);
Paramètres
pRgn
Identifie la zone à sélectionner.Pour la première version de cette fonction, si cette valeur est NULL, la zone cliente entière est sélectionnée et la sortie est découpé encore dans la fenêtre.
Pour la deuxième version de cette fonction, ce handle peut être NULL uniquement lorsque le mode de RGN_COPY est spécifié.
nMode
Spécifie l'exécution à exécuter. Elle doit avoir l'une des valeurs suivantes :RGN_AND la zone de découpage combine les régions qui se chevauchent de la région de découpage actuelle et de la zone identifiées par pRgn.
RGN_COPY la zone de découpage est une copie de la zone identifiée par pRgn. Il s'agit de fonctionnalité identique à la première version d' SelectClipRgn. Si la zone identifiée par pRgn est NULL, la zone de découpage est la région de découpage par défaut (une zone null).
RGN_DIFF la zone de découpage combine les régions de la région de découpage actuelle avec ces zones exclues de la zone identifiée par pRgn.
RGN_OR la zone de découpage combine la région de découpage actuelle et la zone identifiées par pRgn.
RGN_XOR la zone de découpage combine la région de découpage actuelle et la zone identifiées par pRgn mais exclut tous les domaines qui se chevauchent.
Valeur de retour
Le type de la zone. Il peut s'agir de l'une des valeurs suivantes :
La zone de découpage deCOMPLEXREGION a superposer des zones.
Le contexte ou la zone du périphérique deerreur est pas valide.
La zone de découpage deNULLREGION est vide.
La zone de découpage deSIMPLEREGION n'a aucun superposés zone.
Notes
Une seule copie de la zone sélectionnée est utilisée. La région elle-même peut être sélectionnée pour autant d'autres contextes de périphérique, ou peut être désactivée.
La fonction suppose que les coordonnées de la zone donnée sont spécifiées dans les unités. De la sortie de texte de prise en charge des périphériques d'impression en plus haute résolution que les graphiques sortis pour conserver la précision est nécessaire d'exprimer la métrique de texte. Ces appareils stockent des unités au plus haute résolution, c. autrement dit., en unités de texte. Ces appareils mesurent ensuite des coordonnées pour les graphiques afin que mappage de plusieurs unités à 1 unités graphique. Vous devez toujours appeler la fonction d' SelectClipRgn utilisation d'unités de texte.
Les applications qui doivent prendre la mise à l'échelle des objets graphiques dans GDI peuvent utiliser l'échappement d'imprimante de GETSCALINGFACTOR pour déterminer le facteur d'échelle. Le facteur d'échelle affecte le découpage. Si une zone est utilisée pour couper des graphiques, GDI divise les coordonnées par le facteur d'échelle. Si la zone est utilisée pour couper du texte, GDI ne fait aucun réglage de mise à l'échelle. Un facteur d'échelle de 1 entraîne les coordonnées d'être réparties par 2 ; un facteur d'échelle de 2 entraîne les coordonnées de division par 4 ; et ainsi de suite.
Configuration requise
Header: afxwin.h