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 : CompositionObject
Public Class Visual
Inherits CompositionObject
- 継承
- 派生
- 属性
注釈
ビジュアル オブジェクトは、シリアル化された描画コンテンツを作成およびレンダリングし、保持モードのビジュアル システムの基礎を形成します。 Visual クラスは基本的な位置とクリッピングをサポートし、2D 変換と 3D 変換を適用できます。 純色、画像、効果のあるコンテンツなどの追加機能は、 SpriteVisual や ContainerVisual などのサブクラスを通じて提供され、ビジュアルの Brush プロパティを CompositionColorBrush、 CompositionEffectBrush、CompositionSurfaceBrush などの CompositionBrush サブクラスに設定 します。
ビジュアル オブジェクトはスレッド アジャイルであり、UI スレッドにバインドされていません。
アニメーション化可能なプロパティ
次のプロパティをアニメーション化できます。 CompositionObject.StartAnimation を呼び出して、プロパティを CompositionAnimation に関連付けます。
- サイズ
- オフセット
- 不透明度
- 印刷の向き
- CenterPoint
- RotationAngle
- RotationAngleInDegrees
- 回転軸
- TransformMatrix
Rotation
Visual では、次の 2 つの形式の回転がサポートされています。
axis-angle
軸角度回転では、 RotationAngle、 RotationAxis、 CenterPoint のプロパティを使用して、回転角度、回転する軸、および周囲を回転するビジュアルの中心点を指定します。
向き
方向による回転では、 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 のビジュアルは、ツリー内に引き続き存在します。 ビジュアルの他のプロパティと同様に、不透明度はWindows、UI を使用してアニメーション化できます。コンポジション アニメーション システム。 |
| Orientation |
ビジュアルに適用される 3D 空間での向きと回転を記述する四元数。 アニメーション化可能。 |
| Parent |
ビジュアルの親。 |
| ParentForTransform |
このビジュアルを構成する座標系を指定するビジュアル。 |
| Properties |
CompositionObject に関連付けられているプロパティのコレクション。 (継承元 CompositionObject) |
| RelativeOffsetAdjustment |
親ビジュアルのサイズに対するビジュアルのオフセットを指定します。 |
| RelativeSizeAdjustment |
親ビジュアルのサイズに関するビジュアルのサイズを取得または設定します。 |
| RotationAngle |
ビジュアルの回転角度 (ラジアン単位)。 アニメーション化可能。 |
| RotationAngleInDegrees |
ビジュアルの回転角度を度単位で指定します。 アニメーション化可能。 |
| RotationAxis |
ビジュアルを回転させる軸。 アニメーション化可能。 |
| Scale |
ビジュアルに適用するスケール。 |
| Size |
ビジュアルの幅と高さ。 アニメーション化可能。 |
| TransformMatrix |
ビジュアルに適用する変換マトリックス。 アニメーション化可能。 |