Compartilhar via


Método IXpsOMGradientBrush::GetTransform (xpsobjectmodel.h)

Obtém um ponteiro para a interface IXpsOMMatrixTransform que contém a transformação de matriz resolvida para o pincel.

Sintaxe

HRESULT GetTransform(
  [out, retval] IXpsOMMatrixTransform **transform
);

Parâmetros

[out, retval] transform

Um ponteiro para a interface IXpsOMMatrixTransform que contém a transformação de matriz resolvida para o pincel. Se a transformação não tiver sido definida, um ponteiro NULL será retornado.

O valor retornado nesse parâmetro depende de qual método foi chamado mais recentemente para definir a transformação.

Método mais recente chamado Objeto que é retornado na transformação

SetTransformLocal

A transformação local definida por SetTransformLocal.

SetTransformLookup

A transformação compartilhada recuperada, com uma chave de pesquisa que corresponde à chave definida por SetTransformLookup, do diretório de recursos.
Nem SetTransformLocal nem SetTransformLookup ainda foram chamados. Ponteiro NULL .

Retornar valor

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam, aqueles na tabela a seguir. Para obter informações sobre valores retornados da API de documento XPS que não estão listados nesta tabela, consulte Erros de documento XPS.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
E_POINTER
transform é NULL.
XPS_E_LOOKUP_INVALID_TYPE
O nome da chave de pesquisa definido por SetStrokeBrushLookup faz referência a um objeto que não é um pincel.
XPS_E_LOOKUP_NOT_FOUND
Nenhum objeto pôde ser encontrado com um nome de chave que corresponda ao valor de pesquisa.

Nenhum objeto pôde ser encontrado com um nome de chave que corresponda ao valor passado na pesquisa.

Comentários

A transformação determina como o gradiente é transformado. A parte visível do gradiente que é renderizada na imagem é determinada pelo caminho, traço ou glifo que está usando o pincel de gradiente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho xpsobjectmodel.h

Confira também

IXpsOMGradientBrush

IXpsOMMatrixTransform

Especificação de Papel XML

Erros de documento XPS