Método ITranscodeImage::TranscodeImage (imagetranscode.h)

Converte uma imagem em formato de imagem JPEG ou BMP (bitmap).

Sintaxe

HRESULT TranscodeImage(
  [in]            IShellItem *pShellItem,
                  UINT       uiMaxWidth,
                  UINT       uiMaxHeight,
                  DWORD      flags,
                  IStream    *pvImage,
  [out, optional] UINT       *puiWidth,
  [out, optional] UINT       *puiHeight
);

Parâmetros

[in] pShellItem

Tipo: IShellItem*

O Item do Shell para a imagem a ser convertida.

uiMaxWidth

Tipo: UINT

A altura solicitada em pixels. Deve ser menor ou igual à altura real da imagem original. Consulte Observações.

uiMaxHeight

Tipo: UINT

A largura solicitada em pixels. Deve ser menor ou igual à largura real da imagem original. Consulte Observações.

flags

Tipo: TI_FLAGS

Um dos sinalizadores a seguir.

TI_BITMAP

Converta a imagem em formato BMP.

TI_JPEG

Converta a imagem no formato JPEG.

pvImage

Tipo: IStream*

Um fluxo para receber a imagem convertida. O fluxo deve ser criado pelo código de chamada antes de chamar TranscodeImage.

[out, optional] puiWidth

Tipo: UINT*

A largura real da imagem convertida.

[out, optional] puiHeight

Tipo: UINT*

A altura real da imagem convertida.

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.

Comentários

A taxa de proporção da imagem original é preservada. A nova imagem é redimensionada para que ela se ajuste a uma caixa de largura uiMaxWidth e altura uiMaxHeight.

O tamanho da imagem não será alterado se a imagem original já se ajustar nessa caixa delimitadora.

Se uiMaxWidth e uiMaxHeight forem zero, a imagem retornada terá o mesmo tamanho do original.

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	imagetranscode.h