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 CPen objeto a ser selecionado.pBrush
Um ponteiro para um CBrush objeto a ser selecionado.pFont
Um ponteiro para um CFont objeto a ser selecionado.pBitmap
Um ponteiro para um CBitmap objeto a ser selecionado.pRgn
Um ponteiro para um CRgn objeto a ser selecionado.pObject
Um ponteiro para um CGdiObject objeto a ser selecionado.
Valor de retorno
Um ponteiro para o objeto que está sendo substituído.Isso é um ponteiro para um objeto de um sistema autônomo classes derivadas de CGdiObject, sistema autônomo CPen, dependendo da qual versão da função é usado. O valor retornado é NULO se houver um erro.Esta função pode retornar um ponteiro para um objeto temporário.Este objeto temporário 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 sistema autônomo a SelectClipRgn função de membro. O valor retornado pode ser qualquer um dos seguintes procedimentos:
COMPLEXREGION Nova região de recorte tem sobrepostas bordas.
ERRO Contexto de dispositivo ou a região inválido.
NULLREGION Nova região de recorte está vazio.
SIMPLEREGION Nova região de recorte não possui sobrepostas bordas.
Comentários
De classeCDC fornece cinco versões especializadas para tipos específicos de objetos GDI, incluindo as canetas, pincéis, fontes, bitmaps e regiões. O objeto recém-selecionado substitui o objeto anterior do mesmo tipo.Por exemplo, se pObject a versão geral do SelectObject aponta para um CPen objeto, a função substitui a caneta corrente com a caneta especificada por pObject.
Um aplicativo pode selecionar um bitmap em contextos de dispositivo de memória só e no contexto de dispositivo de memória apenas um por vez.O formato de bitmap deve ser compatível com o contexto de dispositivo; se não, ou monocromáticaSelectObject Retorna um erro.
Para o Windows 3.1 e posterior, o SelectObject função retorna o mesmo valor se ela é usada em um metarquivo ou não. Em versões anteriores do Windows, SelectObject retornado um valor diferente de zero para o sucesso e 0 para falha quando ele foi usado em um metarquivo.
Requisitos
Cabeçalho: afxwin.h