GetObject

9/9/2008

Essa função obtém informações sobre um objeto gráfico especificado. Depending on o objeto gráfico, a função coloca um preenchido- Bitmap, DIBSECTION, LOGBRUSH, LOGFONT, ou LOGPEN estrutura em uma reserva especificada.

Syntax

int GetObject(
  HGDIOBJ hgdiobj, 
  int cbBuffer, 
  LPVOID lpvObject
); 

Parameters

• hgdiobj
  [no] Identificador para o objeto de elementos gráficos de interesse. Isso pode ser um identificador para um do seguinte: Um bitmap lógica, um pincel, uma fonte, uma paleta, uma caneta ou um device-independent bitmap criado pelo chamado de CreateDIBSection função.

• cbBuffer
  [no] Especifica o número de bytes de informações a serem gravados para a reserva.

• lpvObject
  [out] Ponteiro longo para uma reserva que deve receber as informações sobre o objeto gráfico especificado.

  A seguinte tabela mostra o tipo de informações de reserva recebe para cada tipo de objeto gráfico você pode especificar com hgdiobj.

  Tipo de objeto	Dados gravados para *lpvObject
  HBITMAP	Bitmap
  HBITMAP retornado de um chamar para CreateDIBSection	DIBSECTION, se cbBuffer é definido como sizeof(DIBSECTION), ou Bitmap, se cbBuffer é definido como sizeof(Bitmap)
  HPALETTE	A Word contagem do número de entradas na paleta de lógica
  HPEN	LOGPEN
  HBRUSH	LOGBRUSH
  HFONT	LOGFONT

  Se a pasta lpvObject parâmetro é NULL, valor de retorno a função é o número de bytes exigido para armazenar as informações ele grava a reserva para o objeto gráfico especificado.

  Windows CE 1.0 e 1.01:

  • O HPALETTE tipo objeto não é com suporte.
  • GetObject Sempre retorna um Bitmap Quando ele é usado em uma seção bitmap independente de dispositivo (DIB).

Return Value

Se a função for bem-sucedido, e lpvObject é um válido ponteiro, o valor de retorno é o número de bytes armazenados na reserva.

Se a função for bem-sucedido, e lpvObject é NULL, o valor de retorno é o número de bytes exigido armazenar as informações de função seria armazenar na reserva.

Se a função falhar, o valor de retorno é zero.

Para informações de erro estendidas get, chamar GetLastError.

Remarks

A reserva apontado pelo lpvObject parâmetro deve ser suficientemente grande para receber as informações sobre o objeto gráfico.

Se hgdiobj Identifica um bitmap criado por chamado CreateDIBSection, e a reserva especificada é grande o suficiente, o GetObject função retorna um DIBSECTION estrutura. Além disso, o bmBits membro das Bitmap estrutura contida o DIBSECTION estrutura conterá um ponteiro para bit valores do bitmap.

Se hgdiobj Identifica um bitmap criado por outros meios, GetObject Retorna apenas a largura, altura e cor informações formato de bitmap e o ponteiro para bit valores do bitmap irão ser NULL. Você pode acessar somente do o bitmap bits se eles estiverem em um device-independent bitmap.

Se hgdiobj Identifica uma paleta lógica, GetObject Recupera um 2-byte inteiro que especifica o número de entradas na paleta. A função não recuperar os LOGPALETTE estrutura definindo a paleta. Para recuperar informações sobre entradas paleta, um aplicativo pode chamar o GetPaletteEntries função.

Requirements

See Also

Reference

CreateDIBSection
GetPaletteEntries
GetRegionData
BITMAP
DIBSECTION
LOGBRUSH
LOGPALETTE
LOGPEN
GDI Functions

Other Resources

LOGFONT