CDC::SelectObject 

CPen * SelectObject ( CPen * pPen );

CBrush * SelectObject ( CBrush * pBrush );

virtual CFont * SelectObject ( CFont * pFont );

CBitmap * SelectObject ( CBitmap * pBitmap );

int SelectObject ( CRgn * pRgn );

Valor de retorno

Um ponteiro para o objeto que está sendo substituído. Este é um ponteiro para um objeto de uma das classes derivadas de CGdiObject, como CPen, dependendo de qual versão da função é usada. O valor de retorno é NULL se ocorrer um erro. Esta função pode retornar um ponteiro para um objeto temporário. Este objeto temporária só é válido durante o processamento de uma mensagem do Windows. Para obter mais informações, consulte CGdiObject::FromHandle.

A versão da função de membro que leva um parâmetro de região executa a mesma tarefa como o SelectClipRgn função membro. O valor de retorno pode ser qualquer um dos seguintes:

• COMPLEXREGIO&Nnbsp;  Novo recorte região tem bordas de sobreposição.
  
  
• Erro   Contexto de dispositivo ou região não é válido.
  
  
• &NULLREGIONnbsp;  Novo recorte região está vazio.
  
  
• SIMPLEREGIO&Nnbsp;  Novo recorte região tem bordas não sobrepostas.

Parâmetros

pPen

Um ponteiro para um objeto CPen para ser selecionado.

pBrush

Um ponteiro para um objeto de CBrush a ser selecionado.

pFont

Um ponteiro para um objeto de CFont a ser selecionado.

pBitmap

Um ponteiro para um objeto de CBitmap a ser selecionado.

pRgn

Um ponteiro para um objeto CRgn para ser selecionado.

Observações

Seleciona um objeto no contexto de dispositivo. Classe CDC fornece cinco versões especializadas para tipos específicos de objetos GDI, incluindo canetas, pincéis, fontes, bitmaps e regiões. O objeto selecionado recentemente substitui o objeto anterior do mesmo tipo. Por exemplo, se pObject da versão geral do SelectObject (SelecionarObjeto) aponta para um objeto de CPen , a função substitui o atual caneta com a caneta especificada pelo pObject.

Um aplicativo pode selecionar um bitmap em contextos dispositivo memória apenas e em contexto dispositivo memória somente um por vez. O formato do bitmap deve ser monocromático ou compatível com o contexto de dispositivo; Se não estiver, SelectObject (SelecionarObjeto) retorna um erro.

Windows 3.1 e posterior, a função SelectObject (SelecionarObjeto) retorna o mesmo valor se ele é usado em um metarquivo ou não. Em versões anteriores do Windows, SelectObject (SelecionarObjeto) retornou um valor diferente de zero para sucesso e 0 para falha quando ele foi usado em um metarquivo.

Visão geral do CDC |  Membros de classe | Gráfico de hierarquia

Consulte tambémnbsp;CGdiObject:: DeleteObject, CGdiObject::FromHandle, CDC::SelectClipRgn, CDC::SelectPalette, :: SelectObject (SelecionarObjeto)