CDC::SelectObject

Artigo
02/25/2013

Seleciona um objeto no contexto de 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
);

Parâmetros

pPen
Um ponteiro para um objeto de CPen a 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 de CRgn a ser selecionado.
pObject
Um ponteiro para um objeto de CGdiObject a ser selecionado.

Valor de retorno

Um ponteiro para o objeto sendo substituído.Este é um ponteiro para um objeto de uma das classes derivadas de CGdiObject, como CPen, dependendo da versão da função é usada.O valor de retorno é NULO se houver um erro.Essa função pode retornar um ponteiro para um objeto temporário.Este objeto temporário é válido somente durante o processamento de uma mensagem do windows.Para mais informações, consulte CGdiObject::FromHandle.

A versão da função de membro que utiliza um parâmetro de região executa a mesma tarefa que a função de membro de SelectClipRgn .O valor de retorno pode ser um de estes procedimentos:

A nova região de corte deCOMPLEXREGION tem sobrepostos bordas.
O contexto ou região de dispositivo deERRO não é válido.
A nova região de corte deNULLREGION está vazia.
A nova região de corte deSIMPLEREGION não tem nenhuma borda sobrepostos.

Comentários

A classe fornece cinco CDC versões especializadas para determinados tipos de objetos de GDI, incluindo menus, pincéis, fontes, bitmaps, e regiões.O objeto selecionado recentemente substitui o objeto anterior do mesmo tipo.Por exemplo, se pObject de versão geral de pontos de SelectObject a um objeto de CPen , a função substitui a caneta atual com a caneta especificada por pObject.

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

Para Windows 3.1 e posterior, a função de SelectObject retorna o mesmo valor se é usada em meta-arquivo ou não.Em versões anteriores do windows, SelectObject retornou um valor diferente de zero de sucesso e 0 para a falha quando foi usado em meta-arquivo.