Compartilhar via


Função GetThemeStream (uxtheme.h)

Recupera um fluxo de dados correspondente a um tema especificado, começando de uma parte, estado e propriedade especificados.

Sintaxe

HRESULT GetThemeStream(
  [in]  HTHEME    hTheme,
  [in]  int       iPartId,
  [in]  int       iStateId,
  [in]  int       iPropId,
  [out] VOID      **ppvStream,
  [out] DWORD     *pcbStream,
  [in]  HINSTANCE hInst
);

Parâmetros

[in] hTheme

Tipo: HTHEME

Manipule para o tema do qual o fluxo será recuperado.

[in] iPartId

Tipo: int

Especifica a parte da qual recuperar um fluxo. Consulte Partes e Estados.

[in] iStateId

Tipo: int

Especifica o estado da parte.

[in] iPropId

Tipo: int

Especifica a propriedade a ser recuperada.

[out] ppvStream

Tipo: VOID**

Endereço de um ponteiro que recebe o fluxo.

[out] pcbStream

Tipo: DWORD*

Ponteiro que recebe o comprimento, em bytes, do fluxo recebido por ppvStream.

[in] hInst

Tipo: HINSTANCE

Se iPropId for TMT_STREAM, esse valor será NULL. Se iPropId for TMT_DISKSTREAM, esse valor será HINSTANCE de um arquivo de estilos carregado.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Windows 8: no modo de alto contraste, o fluxo de dados recuperado por essa função não é válido depois que o identificador de tema hTheme é fechado.

O fluxo de dados recuperado por essa função não é uma cópia; não exclua ou feche o fluxo de dados depois de usá-lo.

Requisitos

Requisito Valor
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 uxtheme.h
Biblioteca UxTheme.lib
DLL UxTheme.dll

Confira também

Blocos e estados