CDC::SelectObject 

CPen * SelectObject ( CPen * pPen );

CBrush * SelectObject ( CBrush * pBrush );

Virtual CFont * SelectObject ( CFont * pFont );

CBitmap * SelectObject ( CBitmap * pBitmap );

int SelectObject ( CRgn * pRgn );

Valore restituito

Un puntatore all'oggetto da sostituire. Questo è un puntatore a un oggetto di una delle classi derivate da CGdiObject, come CPen, a seconda di quale versione della funzione viene utilizzata. Il valore restituito è NULL se c'è un errore. Questa funzione può restituire un puntatore a un oggetto temporaneo. Questo oggetto temporaneo è valido solo durante l'elaborazione di un messaggio di Windows. Per ulteriori informazioni, vedere CGdiObject::FromHandle.

La versione della funzione membro che accetta un parametro regione esegue la stessa attività della funzione membro SelectClipRgn . Il valore restituito può essere una delle seguenti:

Parametri

pPen

Puntatore a un oggetto CPen ad essere selezionato.

pBrush

Puntatore a un oggetto CBrush ad essere selezionato.

pFont

Puntatore a un oggetto CFont ad essere selezionato.

pBitmap

Puntatore a un oggetto CBitmap ad essere selezionato.

pRgn

Puntatore a un oggetto CRgn per essere selezionati.

Osservazioni

Seleziona un oggetto nel contesto di periferica. Classe CDC fornisce cinque versioni specializzate per particolari tipi di oggetti GDI, comprese le penne, spazzole, font, immagini bitmap e regioni. L'oggetto selezionato appena sostituisce il precedente oggetto dello stesso tipo. Ad esempio, se pObject della versione generale di SelectObject punta a un oggetto CPen , la funzione sostituisce la penna corrente con la penna specificata da pObject.

Un'applicazione può selezionare una bitmap in contesti di dispositivo di memoria solo e in contesto di periferica di sola memoria alla volta. Il formato dell'immagine bitmap deve essere compatibile con il contesto di periferica o monocromatica Se non è, SelectObject restituisce un errore.

Per Windows 3.1 e, successivamente, la funzione SelezionaOggetto restituisce lo stesso valore se viene utilizzato in un metafile o no. Nell'ambito di precedenti versioni di Windows, SelectObject restituito un valore diverso da zero per il successo e 0 per fallimento quando è stato utilizzato in un metafile.

CDC pa&noramica |nbsp; Membri della classe | Gerarchia Chart

Vedere anchenbsp;CGdiObject::DeleteObject, CGdiObject::FromHandle, CDC::SelectClipRgn, CDC::SelectPalette, :: SelectObject

Index