Visual クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ビジュアル階層内の基本ビジュアル オブジェクト。
[WebHostHidden]
public ref class Visual : CompositionObject/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.LiftedContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[WebHostHidden]
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(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
[WebHostHidden]
class Visual : CompositionObject[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.LiftedContract), 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(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public class Visual : CompositionObjectPublic Class Visual
Inherits CompositionObject- 継承
- 派生
- 属性
注釈
ビジュアル オブジェクトは、シリアル化された描画コンテンツを作成およびレンダリングし、保持モードのビジュアル システムの基礎を形成します。 Visual クラスは基本的な位置とクリッピングをサポートしており、2D 変換と 3D 変換を適用できます。 純色、画像、効果を含むコンテンツなどの追加機能は、SpriteVisual や ContainerVisual などのサブクラスを通じて提供され、ビジュアルの Brush プロパティを CompositionColorBrush、CompositionEffectBrush、CompositionSurfaceBrush などの CompositionBrush サブクラスに設定します。
ビジュアル オブジェクトはスレッド アジャイルであり、UI スレッドにバインドされません。
アニメーション化可能なプロパティ
次のプロパティをアニメーション化できます。 CompositionObject.StartAnimation を呼び出して、プロパティを CompositionAnimation に関連付けます。
- Size
- Offset
- Opacity
- Orientation
- CenterPoint
- RotationAngle
- RotationAngleInDegrees
- RotationAxis
- TransformMatrix
回転
Visual では、次の 2 つの形式の回転がサポートされています。
軸角度
軸角度回転では、 RotationAngle、 RotationAxis、 CenterPoint の各プロパティを使用して、回転角度、回転する軸、および回転するビジュアルの中心点を指定します。
orientation
向きによる回転では、 Orientation プロパティを使用して、3D 空間の向きと回転を表す四元数を指定します。
プロパティ
| AnchorPoint |
ビジュアルのオフセットに配置されるビジュアル上のポイント。 値は、ビジュアルのサイズに関して正規化されます。 アニメーション化可能。 |
| BackfaceVisibility |
3D 変換中にビジュアルの背面を表示するかどうかを指定します。 |
| BorderMode |
ビジュアルに関連付けられたビットマップとクリップ、またはサブツリー内のすべてのビジュアルをこのビジュアルにルート化して、ビットマップとクリップのエッジを作成する方法を指定します。 親ビジュアルで BorderMode を設定すると、サブツリー内のすべての子ビジュアルに影響し、各子ビジュアルで選択的にオフにすることができます。 |
| CenterPoint |
回転またはスケーリングが発生するポイント。 アニメーション化可能 |
| Clip |
ビジュアルのクリッピング領域を指定します。 ビジュアルをレンダリングすると、クリッピング領域の内側にあるビジュアルの部分のみが表示され、クリッピング領域の外側に広がるコンテンツはクリップされます (つまり、表示されません)。 |
| Comment |
CompositionObject に関連付ける文字列。 (継承元 CompositionObject) |
| CompositeMode |
ビジュアルのビットマップを画面とブレンドする方法を指定します。 |
| Compositor |
この CompositionObject の作成に使用するコンポジター。 (継承元 CompositionObject) |
| DispatcherQueue |
CompositionObject の 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 |
ビジュアルに適用する変換マトリックス。 アニメーション化可能。 |