Função GetObjectW (wingdi.h)

A função GetObject recupera informações para o objeto gráfico especificado.

Sintaxe

int GetObjectW(
        HANDLE h,
        int    c,
        LPVOID pv
);

Parâmetros

h

c

pv

Valor de retorno

Se a função for bem-sucedida e lpvObject for um ponteiro válido, o valor retornado será o número de bytes armazenados no buffer.

Se a função for bem-sucedida e lpvObject for NULL, o valor retornado será o número de bytes necessários para armazenar as informações que a função armazenaria no buffer.

Se a função falhar, o valor retornado será zero.

Observações

O buffer apontado pelo parâmetro lpvObject deve ser suficientemente grande para receber as informações sobre o objeto gráfico. Dependendo do objeto gráfico, a função usa um BITMAP, DIBSECTION, EXTLOGPEN, LOGBRUSH, LOGFONT ou estrutura de LOGPEN ou uma contagem de entradas de tabela (para uma paleta lógica).

Se hgdiobj for um identificador para um bitmap criado chamando CreateDIBSection e o buffer especificado for grande o suficiente, a função GetObject retornará uma estrutura DIBSECTION. Além disso, o bmBits membro da estrutura BITMAP contida no DIBSECTION conterá um ponteiro para os valores de bits do bitmap.

Se hgdiobj for um identificador para um bitmap criado por qualquer outro meio, GetObject retornará apenas as informações de formato de largura, altura e cor do bitmap. Você pode obter os valores de bit do bitmap chamando a função GetDIBits ou GetBitmapBits.

Se hgdiobj for um identificador para uma paleta lógica, GetObject recuperará um inteiro de 2 bytes que especifica o número de entradas na paleta. A função não recupera a estrutura LOGPALETTE definindo a paleta. Para recuperar informações sobre entradas de paleta, um aplicativo pode chamar a função GetPaletteEntries.

Se hgdiobj for um identificador para uma fonte, o LOGFONT retornado é o LOGFONT usado para criar a fonte. Se o Windows tiver que fazer alguma interpolação da fonte porque a LOGFONT não pôde ser representada, a interpolação não será refletida noLOGFONT. Por exemplo, se você solicitar uma versão vertical de uma fonte que não dá suporte à pintura vertical, o LOGFONT indicará que a fonte é vertical, mas o Windows a pintará horizontalmente.

Exemplos

Para obter um exemplo, consulte Armazenando uma imagem.

Nota

O cabeçalho wingdi.h define GetObject como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Consulte também

BITMAP

CreateDIBSection

DIBSECTION

Funções de contexto do dispositivo

Visão geral dos contextos do dispositivo

EXTLOGPEN

GetBitmapBits

GetDIBits

GetPaletteEntries

GetRegionData

LOGBRUSH

DO LOGFONT

LOGPALETTE

DO LOGPEN