CDC::SelectObject
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.
Requisitos
Cabeçalho: afxwin.h