Método IDCompositionVisual::SetOffsetX(float) (dcomp.h)
Altera o valor da propriedade OffsetX desse visual. A propriedade OffsetX especifica o novo deslocamento do visual ao longo do eixo x, em relação ao visual pai.
Sintaxe
HRESULT SetOffsetX(
[in] float offsetX
);
Parâmetros
[in] offsetX
Tipo: float
O novo deslocamento do visual ao longo do eixo x, em pixels.
Valor retornado
Tipo: HRESULT
Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. Confira Códigos de erro do DirectComposition para obter uma lista de códigos de erro.
Comentários
Esse método falhará se o parâmetro offsetX for NaN, infinito positivo ou infinito negativo.
Alterar a propriedade OffsetX de um visual transforma o sistema de coordenadas de toda a subárvore visual com raiz nesse visual. Se a propriedade Clip desse visual for especificada, o retângulo de clipe também será transformado.
Uma transformação especificada pela propriedade Transform é aplicada após a propriedade OffsetX. Em outras palavras, o efeito de definir a propriedade Transform e a propriedade OffsetX é o mesmo que definir apenas a propriedade Transform em um objeto de grupo de transformação em que o primeiro membro do grupo é um objeto IDCompositionTranslateTransform que tem o mesmo valor OffsetX que offsetX. No entanto, você deve usar IDCompositionVisual::SetOffsetX sempre que possível porque é um pouco mais rápido.
Se as propriedades OffsetX e OffsetY estiverem definidas como 0 e a propriedade Transform estiver definida como NULL, o sistema de coordenadas do visual será o mesmo que o de seu pai.
Se a propriedade OffsetX foi animada anteriormente, esse método remove a animação e define a propriedade como o valor estático especificado.
Exemplos
Para obter um exemplo, consulte Como criar uma árvore visual simples.
Requisitos
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | dcomp.h |
| Biblioteca | Dcomp.lib |
| DLL | Dcomp.dll |