Condividi tramite


CDC::SelectClipRgn

Selezionare l'area specificata come area di ridimensionamento corrente del contesto di dispositivo.

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

Parametri

  • pRgn
    Identifica l'area da selezionare.

    • Per la prima versione di questa funzione, se questo valore è NULL, l'intera area client è selezionata e restituite viene ritagliato nella finestra.

    • Per la seconda versione della funzione, questo handle possono essere NULL solo quando la modalità RGN_COPY è specificata.

  • nMode
    Specifica l'azione da eseguire. Deve essere uno dei seguenti valori:

    • RGN_AND la nuova area combina le aree sovrapposizione dell'area corrente e dell'area identificate da pRgn.

    • RGN_COPY la nuova area è una copia dell'area identificata da pRgn. Si tratta di funzionalità è identica alla prima versione SelectClipRgn. Se l'area identificata da pRgn è NULL, la nuova area diventa l'area di ridimensionamento predefinito (un'area null).

    • RGN_DIFF la nuova area combina le aree dell'area corrente con tali aree escluse dall'area identificata da pRgn.

    • RGN_OR la nuova area combinano l'area di visualizzazione corrente e l'area identificate da pRgn.

    • RGN_XOR la nuova area combinano l'area di visualizzazione corrente e l'area identificate da pRgn ma esclude tutte le aree sovrapposti.

Valore restituito

Il tipo di area. Può essere uno dei seguenti valori:

  • La nuova area diCOMPLEXREGION include bordi sovrapposti.

  • Il contesto di dispositivo o l'area diERRORE non è valida.

  • La nuova area diNULLREGION è vuota.

  • La nuova area diSIMPLEREGION non include bordi sovrapposti.

Note

Solo una copia dell'area selezionata viene utilizzata. L'area stessa può essere selezionata per un numero qualsiasi di altri contesti di periferica, o può essere eliminato.

La funzione si presuppone che le coordinate per l'area specificata siano specificate in unità. Un output di testo di supporto dei dispositivi di stampa un valore maggiore di alta risoluzione degli elementi grafici restituiti per mantenere la precisione ha richiesto di indicare la metrica del testo. Tali dispositivi segnalano le unità a più di alta risoluzione, ovvero, in unità di testo. Tali dispositivi si ridimensionano le coordinate per la grafica in modo che il mapping di più unità solo a 1 unità grafica. È sempre necessario chiamare la funzione SelectClipRgn utilizzando le unità di testo.

Le applicazioni che devono eseguire la scala degli oggetti grafici in GDI possibile utilizzare la fuga della stampante GETSCALINGFACTOR per determinare il fattore di scala. Il fattore di scala sull'area di visualizzazione. Se un'area viene utilizzata per rimuovere gli elementi grafici, GDI suddivide le coordinate dal fattore di scala. Se l'area viene utilizzata per tagliare il testo, GDI non passa a regolazione di ridimensionamento. Un fattore di scala pari al 1 delle coordinate a essere diviso per 2; un fattore di scala pari al 2 delle coordinate di dividere per 4; e così via.

Requisiti

Header: afxwin.h

Vedere anche

Riferimenti

Classe CDC

Grafico delle gerarchie

CDC::GetClipBox

CDC::Escape

Classe CRgn

SelectClipRgn