Método IXpsOMTileBrush::SetTransformLookup (xpsobjectmodel.h)
Define o nome da chave de pesquisa de uma transformação de matriz compartilhada que será usada como a transformação para esse pincel. A transformação de matriz compartilhada referenciada pela chave de pesquisa é armazenada no dicionário de recursos.
Sintaxe
HRESULT SetTransformLookup(
[in] LPCWSTR key
);
Parâmetros
[in] key
Uma variável de cadeia de caracteres que contém o nome da chave de pesquisa de uma transformação de matriz compartilhada no dicionário de recursos. Se uma chave de pesquisa já tiver sido definida, um ponteiro NULL a limpará.
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 |
|---|---|
|
O método foi bem-sucedido. |
|
De acordo com a Especificação de Papel XML, o valor da pesquisa não é uma cadeia de caracteres de chave de pesquisa válida. |
|
O nome da chave de pesquisa na chave faz referência a um objeto que não é uma geometria. |
|
Nenhum objeto pôde ser encontrado com um nome de chave que corresponda ao valor passado na chave. |
Comentários
A transformação é aplicada antes que a imagem do pincel seja renderizada no caminho, traço ou glifo que está usando o pincel de bloco. O pincel de bloco tem apenas uma transformação, que pode ser local ou remota.
Depois de chamar SetTransformLookup, a transformação local é liberada e GetTransformLocal retorna um ponteiro NULL no parâmetro de transformação . A tabela a seguir explica a relação entre os valores locais e de pesquisa dessa propriedade.
| Método mais recente chamado | Objeto retornado em transformação por GetTransform | Objeto retornado em transformação por GetTransformLocal | Cadeia de caracteres retornada na chave por GetTransformLookup |
|---|---|---|---|
| A transformação definida por SetTransformLocal. | A transformação definida por SetTransformLocal. | Ponteiro NULL . | |
| SetTransformLookup (este método) | A transformação que é recuperada, usando uma chave de pesquisa que corresponde à chave definida por SetTransformLookup, do diretório de recursos. | Ponteiro NULL . | A chave de pesquisa definida por SetTransformLookup. |
| Nem SetTransformLocal nem SetTransformLookup ainda foram chamados. | Ponteiro NULL . | Ponteiro NULL . | Ponteiro NULL . |
Requisitos
| 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 |