CDC::SelectObject

Seleziona un oggetto nel contesto di dispositivo.

CPen* SelectObject(
   CPen* pPen 
);
CBrush* SelectObject(
   CBrush* pBrush 
);
virtual CFont* SelectObject(
   CFont* pFont 
);
CBitmap* SelectObject(
   CBitmap* pBitmap 
);
int SelectObject(
   CRgn* pRgn 
);
CGdiObject* SelectObject(
   CGdiObject* pObject
);

Parametri

  • pPen
    Un puntatore a un oggetto CPen da selezionare.

  • pBrush
    Un puntatore a un oggetto CBrush da selezionare.

  • pFont
    Un puntatore a un oggetto CFont da selezionare.

  • pBitmap
    Un puntatore a un oggetto CBitmap da selezionare.

  • pRgn
    Un puntatore a un oggetto CRgn da selezionare.

  • pObject
    Un puntatore a un oggetto CGdiObject da selezionare.

Valore restituito

Un puntatore all'oggetto che verrà sostituito.Questo è un puntatore a un oggetto di una delle classi derivate da CGdiObject, come CPen, a seconda della versione della funzione viene utilizzata.Il valore restituito è NULL se è presente 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 dell'area esegue la stessa attività della funzione membro SelectClipRgn.Il valore restituito può essere uno dei seguenti elementi:

  • 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

La classe CDC fornisce cinque versioni specifiche a particolari tipi di oggetti GDI, inclusi penne, pennelli, tipi di carattere, bitmap e aree.L'oggetto appena selezionato sostituisce l'oggetto precedente dello stesso tipo.Ad esempio, se pObject della versione generale dei punti SelectObject 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 periferica di memoria solo e solo in un contesto di dispositivo di memoria per volta.Il formato della bitmap dovrà essere monocromatico o compatibile con il contesto di dispositivo, se non è, SelectObject restituisce un errore.

Per Windows 3.1 e versioni successive, la funzione SelectObject restituisce lo stesso valore se utilizzata in un metafile o meno.Nelle versioni precedenti di Windows, SelectObject ha restituito un valore diverso da zero per la riuscita e 0 per errore quando è stato utilizzato in un metafile.

Requisiti

Header: afxwin.h

Vedere anche

Riferimenti

Classe CDC

Grafico della gerarchia

CGdiObject::DeleteObject

CGdiObject::FromHandle

CDC::SelectClipRgn

CDC::SelectPalette

SelectObject