次の方法で共有


Visual クラス

定義

ビジュアル階層内の基本ビジュアル オブジェクト。

public ref class Visual : CompositionObject
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Visual : CompositionObject
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
class Visual : CompositionObject
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Visual : CompositionObject
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
public class Visual : CompositionObject
Public Class Visual
Inherits CompositionObject
継承
Object Platform::Object IInspectable CompositionObject Visual
派生
属性

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

ビジュアル オブジェクトは、シリアル化された描画コンテンツを作成およびレンダリングし、保持モードのビジュアル システムの基礎を形成します。 Visual クラスは基本的な位置とクリッピングをサポートしており、2D および 3D 変換を適用できます。 純色、画像、効果のあるコンテンツなどの追加機能は、 SpriteVisualContainerVisual などのサブクラスを通じて提供され、ビジュアルの Brush プロパティを CompositionColorBrushCompositionEffectBrushCompositionSurfaceBrush などの CompositionBrush サブクラスに設定します。

ビジュアル オブジェクトはスレッドアジャイルであり、UI スレッドにバインドされません。

アニメーション化可能なプロパティ

次のプロパティをアニメーション化できます。 CompositionObject.StartAnimation を呼び出して、 プロパティを CompositionAnimation に関連付けます。

回転

Visual では、次の 2 つの形式の回転がサポートされています。

  • axis-angle

    軸角度回転では、 RotationAngleRotationAxisCenterPoint の各プロパティを使用して、回転角度、回転する軸、および周囲を回転するビジュアルの中心点を指定します。

  • orientation

    方向による回転では、 Orientation プロパティを使用して、3D 空間の向きと回転を記述する四元数を指定します。

バージョン履歴

Windows のバージョン SDK バージョン 追加された値
1703 15063 ParentForTransform
1703 15063 RelativeOffsetAdjustment
1703 15063 RelativeSizeAdjustment

プロパティ

AnchorPoint

ビジュアルのオフセットに配置されるビジュアル上のポイント。 値は、ビジュアルのサイズに対して正規化されます。 アニメーション化可能。

BackfaceVisibility

3D 変換中にビジュアルの背面を表示するかどうかを指定します。

BorderMode

ビジュアルに関連付けられたビットマップとクリップの端、またはこのビジュアルにルート化されたサブツリー内のすべてのビジュアルを作成する方法を指定します。 親ビジュアルで BorderMode を設定すると、サブツリー内のすべての子ビジュアルに影響し、各子ビジュアルで選択的にオフにすることができます。

CenterPoint

回転またはスケーリングが発生するポイント。 アニメーション化可能

Clip

ビジュアルのクリッピング領域を指定します。 ビジュアルがレンダリングされると、クリッピング領域の内側にあるビジュアルの部分のみが表示され、クリッピング領域の外側に広がるコンテンツはすべてクリップされます (つまり、表示されません)。

Comment

CompositionObject に関連付ける文字列。

(継承元 CompositionObject)
CompositeMode

ビジュアルのビットマップを画面とブレンドする方法を指定します。

Compositor

この CompositionObject の作成に使用されるコンポジター

(継承元 CompositionObject)
Dispatcher

CompositionObject のディスパッチャー。

(継承元 CompositionObject)
DispatcherQueue

CompostionObject の DispatcherQueue を取得します。

(継承元 CompositionObject)
ImplicitAnimations

このオブジェクトにアタッチされた暗黙的なアニメーションのコレクション。

(継承元 CompositionObject)
IsHitTestVisible

このビジュアルにルート化されたビジュアル サブツリーがヒット テストに参加するかどうかを示す値を取得または設定します。

IsPixelSnappingEnabled

コンポジション エンジンがレンダリングされたビジュアルをピクセル境界に合わせるかどうかを示す値を取得または設定します。

IsVisible

ビジュアルとその子ビジュアルのサブツリー全体を表示するかどうかを示します。

Offset

ビジュアルの親に対する相対オフセット、またはルート ビジュアルの場合は、ビジュアルをホストするウィンドウの左上隅を基準としたオフセット。 アニメーション化可能。

Opacity

ビジュアルの不透明度。 アニメーション化可能。

opacity プロパティは、Visual の透明度 (存在する場合) を決定し、0 から 1 の値です。 0 は完全に透明で、1 は完全に不透明です。 Opacity プロパティが 0 のビジュアルは、ツリーにまだ存在します。 ビジュアルの他のプロパティと同様に、Opacity は Windows、UI を使用してアニメーション化できます。コンポジション アニメーション システム。

Orientation

ビジュアルに適用される 3D 空間の向きと回転を記述する四元数。 アニメーション化可能。

Parent

ビジュアルの親。

ParentForTransform

このビジュアルを構成する座標系を指定するビジュアル。

Properties

CompositionObject に関連付けられているプロパティのコレクション。

(継承元 CompositionObject)
RelativeOffsetAdjustment

親ビジュアルのサイズに対するビジュアルのオフセットを指定します。

RelativeSizeAdjustment

親ビジュアルのサイズに関するビジュアルのサイズを取得または設定します。

RotationAngle

ビジュアルの回転角度 (ラジアン単位)。 アニメーション化可能。

RotationAngleInDegrees

ビジュアルの回転角度を度単位で指定します。 アニメーション化可能。

RotationAxis

ビジュアルを回転させる軸。 アニメーション化可能。

Scale

ビジュアルに適用するスケール。

Size

ビジュアルの幅と高さ。 アニメーション化可能。

TransformMatrix

ビジュアルに適用する変換マトリックス。 アニメーション化可能。

メソッド

Close()

CompositionObject を閉じ、システム リソースを解放します。

(継承元 CompositionObject)
ConnectAnimation(String, CompositionAnimation)

接続とアニメーション。

(継承元 CompositionObject)
DisconnectAnimation(String)

アニメーションを切断します。

(継承元 CompositionObject)
Dispose()

アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。

(継承元 CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)

アニメーション化できるプロパティを定義します。

(継承元 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)

アニメーションをオブジェクトの指定したプロパティに接続し、アニメーションを開始します。

(継承元 CompositionObject)
StartAnimation(String, CompositionAnimation)

アニメーションをオブジェクトの指定したプロパティに接続し、アニメーションを開始します。

(継承元 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)

アニメーション グループを開始します。

CompositionObject の StartAnimationGroup メソッドを使用すると、CompositionAnimationGroup を開始できます。 グループ内のすべてのアニメーションは、オブジェクトで同時に開始されます。

(継承元 CompositionObject)
StopAnimation(String)

指定したプロパティからアニメーションを切断し、アニメーションを停止します。

(継承元 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)

アニメーション グループを停止します。

(継承元 CompositionObject)
TryGetAnimationController(String)

指定したプロパティで実行されているアニメーションの AnimationController を返します。

(継承元 CompositionObject)

適用対象

こちらもご覧ください