Método IDCompositionVisual::SetOffsetY(float) (dcomp.h)
Altera o valor da propriedade OffsetY deste visual. A propriedade OffsetY especifica o novo deslocamento do visual ao longo do eixo y, em relação ao visual pai.
Sintaxe
HRESULT SetOffsetY(
[in] float offsetY
);
Parâmetros
[in] offsetY
Tipo: float
O novo deslocamento do visual ao longo do eixo y, 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 offsetY for NaN, infinito positivo ou infinito negativo.
Alterar a propriedade OffsetY 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 OffsetY. Em outras palavras, o efeito de definir a propriedade Transform e a propriedade OffsetY é 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 OffsetY que offsetY. No entanto, você deve usar IDCompositionVisual::SetOffsetY 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 OffsetY 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 |