Função SelectObject (wingdi.h)

Artigo
08/27/2023

A função SelectObject seleciona um objeto no DC (contexto de dispositivo) especificado. O novo objeto substitui o objeto anterior do mesmo tipo.

Sintaxe

HGDIOBJ SelectObject(
  [in] HDC     hdc,
  [in] HGDIOBJ h
);

Parâmetros

[in] hdc

Um identificador para o DC.

[in] h

Um identificador para o objeto a ser selecionado. O objeto especificado deve ter sido criado usando uma das funções a seguir.

Objeto	Funções
Bitmap	CreateBitmap, CreateBitmapIndirect, CreateCompatibleBitmap, CreateDIBitmap, CreateDIBSection Bitmaps só podem ser selecionados em DC de memória. Um único bitmap não pode ser selecionado em mais de um DC ao mesmo tempo.
Pincel	CreateBrushIndirect, CreateDIBPatternBrush, CreateDIBPatternBrushPt, CreateHatchBrush, CreatePatternBrush, CreateSolidBrush
Fonte	CreateFont, CreateFontIndirect
Caneta	CreatePen, CreatePenIndirect
Região	CombineRgn, CreateEllipticRgn, CreateEllipticRgnIndirect, CreatePolygonRgn, CreateRectRgn, CreateRectRgnIndirect

Retornar valor

Se o objeto selecionado não for uma região e a função for bem-sucedida, o valor retornado será um identificador para o objeto que está sendo substituído. Se o objeto selecionado for uma região e a função for bem-sucedida, o valor retornado será um dos valores a seguir.

Valor	Significado
SIMPLEREGION	A região consiste em um único retângulo.
COMPLEXREGION	A região consiste em mais de um retângulo.
NULLREGION	A região está vazia.

Se ocorrer um erro e o objeto selecionado não for uma região, o valor retornado será NULL. Caso contrário, será HGDI_ERROR.

Comentários

Essa função retorna o objeto selecionado anteriormente do tipo especificado. Um aplicativo sempre deve substituir um novo objeto pelo objeto original padrão depois de terminar de desenhar com o novo objeto.

Um aplicativo não pode selecionar um único bitmap em mais de um DC por vez.

ICM: Se o objeto que está sendo selecionado for um pincel ou uma caneta, o gerenciamento de cores será executado.

Exemplos

Para obter um exemplo, consulte Configurando a caneta ou a cor do pincel.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll