ModelVisual3D Classe

Definição

Espaço de Nomes:: System.Windows.Media.Media3D

Assemblagem:: PresentationCore.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Fornece um Visual3D que renderiza Model3D objetos.

public ref class ModelVisual3D : System::Windows::Media::Media3D::Visual3D, System::Windows::Markup::IAddChild

[System.Windows.Markup.ContentProperty("Children")]
public class ModelVisual3D : System.Windows.Media.Media3D.Visual3D, System.Windows.Markup.IAddChild

[<System.Windows.Markup.ContentProperty("Children")>]
type ModelVisual3D = class
    inherit Visual3D
    interface IAddChild

Public Class ModelVisual3D
Inherits Visual3D
Implements IAddChild

Herança: Object

DispatcherObject

DependencyObject

Visual3D
ModelVisual3D

Atributos: ContentPropertyAttribute

Implementações: IAddChild

Exemplos

O exemplo seguinte mostra uma instância do ModelVisual3D em marcação. myTeapot refere-se a um MeshGeometry3D definido externamente. Podes substituir qualquer geometria tua.

<DockPanel>
  <Viewport3D Name="myViewport">

    <Viewport3D.Camera>
      <PerspectiveCamera FarPlaneDistance="20" LookDirection="5,-2,-3" UpDirection="0,1,0" NearPlaneDistance="0" Position="-5,2,3" FieldOfView="45" />
    </Viewport3D.Camera>

    <ModelVisual3D x:Name="topModelVisual3D">
      <ModelVisual3D.Children>
        <ModelVisual3D>
          <ModelVisual3D.Content>
            <DirectionalLight Color="#FFFFFFFF" Direction="-3,-4,-5" />
          </ModelVisual3D.Content>
        </ModelVisual3D>

        <ModelVisual3D>
          <ModelVisual3D.Content>
            <GeometryModel3D Geometry="{StaticResource myTeapot}">
              <GeometryModel3D.Material>
                <DiffuseMaterial>
                  <DiffuseMaterial.Brush>
                    <SolidColorBrush Color="Blue" Opacity="1.0" />
                  </DiffuseMaterial.Brush>
                </DiffuseMaterial>
              </GeometryModel3D.Material>
              <GeometryModel3D.Transform>
                <RotateTransform3D>
                  <RotateTransform3D.Rotation>
                    <AxisAngleRotation3D x:Name="myAngleRotation" Axis="0,3,0" Angle="1" />
                  </RotateTransform3D.Rotation>
                </RotateTransform3D>
              </GeometryModel3D.Transform>
            </GeometryModel3D>
          </ModelVisual3D.Content>
        </ModelVisual3D>


      </ModelVisual3D.Children>
    </ModelVisual3D>


    <Viewport3D.Triggers>

      <EventTrigger RoutedEvent="Viewport3D.Loaded">
        <BeginStoryboard>
          <Storyboard>
            <DoubleAnimation 
              Storyboard.TargetName="myAngleRotation"
              Storyboard.TargetProperty="Angle"
              From="0" To="360" Duration="0:0:10"
              RepeatBehavior="Forever" />
          </Storyboard>
        </BeginStoryboard>
      </EventTrigger>
    </Viewport3D.Triggers>


  </Viewport3D>
</DockPanel>

Observações

Fornece serviços e propriedades comuns a todos os objetos visuais, incluindo testes de impacto, transformação de coordenadas e cálculos de caixas delimitadoras.

A ModelVisual3D classe tem uma Children propriedade que permite construir uma estrutura em árvore de ModelVisual3D objetos.

ModelVisual3D Os objetos são otimizados como nós de cena. Por exemplo, eles armazenam os limites em cache. Sempre que puderes, usa ModelVisual3D objetos para instâncias únicas dentro da tua cena. Esta utilização contrasta com a dos Model3D objetos, que são objetos leves otimizados para serem partilhados e reutilizados. Por exemplo, usa um Model3D objeto para construir um modelo de carro; e usa dez ModelVisual3D objetos para colocar dez carros na tua cena.

Construtores

Name	Description
ModelVisual3D()	Inicializa uma nova instância da ModelVisual3D classe.

Campos

Name	Description
ContentProperty	Identifica a Content propriedade de dependência.
TransformProperty	Identifica a Transform propriedade de dependência.

Propriedades

Name	Description
Children	Recebe uma coleção de objetos filhos Visual3D .
Content	Obtém ou define o modelo que compreende o conteúdo do ModelVisual3D.
DependencyObjectType	Obtém o DependencyObjectType que envolve o tipo CLR desta instância. (Herdado de DependencyObject)
Dispatcher	Percebe o Dispatcher que isto DispatcherObject está associado. (Herdado de DispatcherObject)
HasAnimatedProperties	Recebe um valor que indica se tem Visual3D propriedades animadas. (Herdado de Visual3D)
IsSealed	Recebe um valor que indica se esta instância está atualmente selada (apenas leitura). (Herdado de DependencyObject)
Transform	Obtém ou define o conjunto de transformação no ModelVisual3D.
Visual3DChildrenCount	Devolve o número de objetos filhos.
Visual3DModel	Obtém ou define o Model3D objeto para renderizar. (Herdado de Visual3D)

Métodos

Name	Description
AddVisual3DChild(Visual3D)	Define a relação pai-filho entre dois visuais 3D. (Herdado de Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Aplica o efeito de um dado AnimationClock a uma dada propriedade de dependência. O efeito do novo AnimationClock em qualquer animação atual é determinado pelo valor do `handoffBehavior` parâmetro. (Herdado de Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Aplica o efeito de um dado AnimationClock a uma dada propriedade de dependência. (Herdado de Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Inicia uma sequência de animação para o DependencyProperty objeto, baseada tanto no especificado AnimationTimeline como HandoffBehaviorno . (Herdado de Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline)	Inicia uma sequência de animação para o DependencyProperty objeto, baseada no especificado AnimationTimeline. (Herdado de Visual3D)
CheckAccess()	Determina se o thread que chama tem acesso a este DispatcherObject. (Herdado de DispatcherObject)
ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade. A propriedade a ser limpa é especificada por um DependencyProperty identificador. (Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)	Limpa o valor local de uma propriedade de apenas leitura. O imóvel a ser limpo é especificado por um DependencyPropertyKey. (Herdado de DependencyObject)
CoerceValue(DependencyProperty)	Coage o valor da propriedade de dependência especificada. Isto é conseguido invocando qualquer CoerceValueCallback função especificada nos metadados da propriedade para a propriedade de dependência tal como existe na chamada DependencyObject. (Herdado de DependencyObject)
Equals(Object)	Determina se um fornecido DependencyObject é equivalente à corrente DependencyObject. (Herdado de DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Devolve o ancestral comum do objeto visual e outro objeto visual especificado. (Herdado de Visual3D)
GetAnimationBaseValue(DependencyProperty)	Recupera o valor base do objeto especificado DependencyProperty . (Herdado de Visual3D)
GetHashCode()	Obtém um código de hash para isto DependencyObject. (Herdado de DependencyObject)
GetLocalValueEnumerator()	Cria um enumerador especializado para determinar quais as propriedades de dependência que têm valores localmente definidos neste DependencyObject. (Herdado de DependencyObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValue(DependencyProperty)	Devolve o valor efetivo atual de uma propriedade de dependência nesta instância de um DependencyObject. (Herdado de DependencyObject)
GetVisual3DChild(Int32)	Devolve o especificado Visual3D na coleção principal.
InvalidateProperty(DependencyProperty)	Reavalia o valor efetivo da propriedade de dependência especificada. (Herdado de DependencyObject)
IsAncestorOf(DependencyObject)	Determina se o objeto visual é um ancestral do objeto visual descendente. (Herdado de Visual3D)
IsDescendantOf(DependencyObject)	Determina se o objeto visual é descendente do objeto visual ancestral. (Herdado de Visual3D)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Invocado sempre que o valor efetivo de qualquer propriedade de dependência disto DependencyObject for atualizado. A propriedade específica da dependência que mudou é reportada nos dados do evento. (Herdado de DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Chamado quando o Visual3DCollection objeto visual é modificado. (Herdado de Visual3D)
OnVisualParentChanged(DependencyObject)	Chamada quando o pai do objeto visual 3D é alterado. (Herdado de Visual3D)
ReadLocalValue(DependencyProperty)	Devolve o valor local de uma propriedade de dependência, se esta existir. (Herdado de DependencyObject)
RemoveVisual3DChild(Visual3D)	Elimina a relação pai-filho entre dois visuais 3D. (Herdado de Visual3D)
SetCurrentValue(DependencyProperty, Object)	Define o valor de uma propriedade de dependência sem alterar a sua fonte de valor. (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência, especificado pelo seu identificador de propriedade de dependência. (Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Define o valor local de uma propriedade de dependência somente de leitura, especificado pelo DependencyPropertyKey identificador da propriedade de dependência. (Herdado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Devolve um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
TransformToAncestor(Visual)	Devolve uma transformação que pode ser usada para transformar coordenadas deste Visual3D objeto para o ancestral especificado Visual do objeto. (Herdado de Visual3D)
TransformToAncestor(Visual3D)	Devolve uma transformação que pode ser usada para transformar coordenadas deste Visual3D objeto para o ancestral especificado Visual3D do objeto. (Herdado de Visual3D)
TransformToDescendant(Visual3D)	Devolve uma transformação que pode ser usada para transformar coordenadas deste Visual3D objeto para o objeto de descida especificado Visual3D . (Herdado de Visual3D)
VerifyAccess()	Faz cumprir que o thread que chama tem acesso a este DispatcherObject. (Herdado de DispatcherObject)

Implementações de Interface Explícita

Name	Description
IAddChild.AddChild(Object)	Adiciona um objeto filho.
IAddChild.AddText(String)	Adiciona o conteúdo textual de um nó ao objeto.

Aplica-se a

Comentários

Esta página foi útil?