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