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

Confira também

IDCompositionVisual

IDCompositionVisual::SetOffsetY

IDCompositionVisual::SetTransform