Método IThumbnailProvider::GetThumbnail (thumbcache.h)

Artigo
08/26/2023

Obtém uma imagem em miniatura e um tipo alfa.

Sintaxe

HRESULT GetThumbnail(
  [in]  UINT          cx,
  [out] HBITMAP       *phbmp,
  [out] WTS_ALPHATYPE *pdwAlpha
);

Parâmetros

[in] cx

Tipo: UINT

O tamanho máximo da miniatura, em pixels. O Shell desenha o bitmap retornado nesse tamanho ou menor. O bitmap retornado deve caber em um quadrado de largura e altura cx, embora não precise ser uma imagem quadrada. O Shell dimensiona o bitmap para renderizar em tamanhos inferiores. Por exemplo, se a imagem tiver uma taxa de proporção de 6:4, o bitmap retornado também deverá ter uma taxa de proporção de 6:4.

[out] phbmp

Tipo: HBITMAP*

Quando esse método retorna, contém um ponteiro para o identificador de imagem em miniatura. A imagem deve ser uma seção DIB e 32 bits por pixel. O Shell reduzirá verticalmente o bitmap se sua largura ou altura for maior do que o tamanho especificado por cx. O Shell sempre respeita a taxa de proporção e nunca dimensiona um bitmap maior que seu tamanho original.

[out] pdwAlpha

Tipo: WTS_ALPHATYPE*

Quando esse método retorna, contém um ponteiro para um dos seguintes valores da enumeração WTS_ALPHATYPE:

WTSAT_UNKNOWN (0x0)

0x0. O bitmap é um formato desconhecido. No entanto, o Shell tenta detectar se a imagem tem um canal alfa.

WTSAT_RGB (0x1)

0x1. O bitmap é uma imagem RGB sem alfa. O canal alfa é inválido e o Shell o ignora.

WTSAT_ARGB (0x2)

0x2. O bitmap é uma imagem ARGB com um canal alfa válido.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos


Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	thumbcache.h

Compartilhar via