Viewport2DVisual3D.Material Property

Definition

Namespace:

System.Windows.Media.Media3D

Assembly:

PresentationCore.dll

Gets or sets the material that describes the appearance of the 3-D object.

public:
 property System::Windows::Media::Media3D::Material ^ Material { System::Windows::Media::Media3D::Material ^ get(); void set(System::Windows::Media::Media3D::Material ^ value); };

public System.Windows.Media.Media3D.Material Material { get; set; }

member this.Material : System.Windows.Media.Media3D.Material with get, set

Public Property Material As Material

Property Value

Material

The material for the 3-D object.

Examples

The following example shows how to specify the material where the 2-D visual (the button) should be placed by setting this property and also setting the IsVisualHostMaterial attached property to true:

<Viewport3D>
    <Viewport3D.Camera>
        <PerspectiveCamera Position="0, 0, 4"/>
    </Viewport3D.Camera>
    
    <!-- Button on 3D -->
    <Viewport2DVisual3D>
        <!-- Give the plane a slight rotation -->
        <Viewport2DVisual3D.Transform>
            <RotateTransform3D>
                <RotateTransform3D.Rotation>
                    <AxisAngleRotation3D Angle="40" Axis="0, 1, 0" />
                </RotateTransform3D.Rotation>
            </RotateTransform3D>
        </Viewport2DVisual3D.Transform>
        
        <!-- The Geometry, Material, and Visual for the Viewport2DVisual3D -->
        <Viewport2DVisual3D.Geometry>
            <MeshGeometry3D Positions="-1,1,0 -1,-1,0 1,-1,0 1,1,0"
                            TextureCoordinates="0,0 0,1 1,1 1,0" TriangleIndices="0 1 2 0 2 3"/>
        </Viewport2DVisual3D.Geometry>

        <Viewport2DVisual3D.Material>
            <DiffuseMaterial Viewport2DVisual3D.IsVisualHostMaterial="True" Brush="White"/>
        </Viewport2DVisual3D.Material>                               
        
        <Button>Hello, 3D</Button>
    </Viewport2DVisual3D>
    
    <!-- Lights -->
    <ModelVisual3D>
        <ModelVisual3D.Content>
            <DirectionalLight Color="#FFFFFFFF" Direction="0,0,-1"/>
        </ModelVisual3D.Content>
    </ModelVisual3D>
</Viewport3D>

Remarks

You must set the IsVisualHostMaterial attached property on the material on which you wish to have the 2-D visual placed.

Material is introduced in the .NET Framework version 3.5.