Compartilhar via


Função SelectObject (wingdi.h)

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

Confira também

Combinergn

Createbitmap

Createbitmapindirect

CreateBrushIndirect

Createcompatiblebitmap

CreateDIBPatternBrush

Createdibitmap

CreateEllipticRgn

CreateEllipticRgnIndirect

Createfont

Createfontindirect

Createhatchbrush

Createpatternbrush

Createpen

Createpenindirect

CreatePolygonRgn

Createrectrgn

CreateRectRgnIndirect

Createsolidbrush

Funções de contexto do dispositivo

Visão geral dos contextos do dispositivo

Selectcliprgn

SelectPalette