Método IDCompositionVisual::SetTransformParent (dcomp.h)
Define a propriedade TransformParent desse visual. A propriedade TransformParent estabelece o sistema de coordenadas relativo ao qual esse visual é composto.
Sintaxe
HRESULT SetTransformParent(
[in, optional] IDCompositionVisual *visual
);
Parâmetros
[in, optional] visual
Tipo: IDCompositionVisual*
O novo visual que estabelece o sistema de coordenadas base para esse visual. Este parâmetro pode ser NULL.
Retornar valor
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
O sistema de coordenadas de um visual é modificado pelas propriedades OffsetX, OffsetY e Transform. Normalmente, essas propriedades definem o sistema de coordenadas de um visual em relação ao pai imediato. Esse método especifica o visual relativo ao qual o sistema de coordenadas desse visual se baseia. O visual especificado deve ser um ancestral do visual atual. Se não for um ancestral, o sistema de coordenadas será baseado no pai imediato desse visual, assim como se a propriedade TransformParent estivesse definida como NULL. Como os visuais podem ser reparentados, essa propriedade poderá entrar em vigor novamente se o visual especificado se tornar um ancestral do visual de destino por meio de uma operação de reparenciamento.
Se o parâmetro visual for NULL, o sistema de coordenadas sempre será transformado em relação ao pai imediato do visual. Esse será o comportamento padrão se esse método não for usado.
Esse método falhará se o parâmetro visual for um ponteiro inválido ou se não tiver sido criado pela mesma interface IDCompositionDevice que este visual. A interface não pode ser uma implementação personalizada; somente interfaces criadas pelo Microsoft DirectComposition podem ser usadas com esse método.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |