VisualElement クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
画面上の領域を占有し、視覚的な外観を持ち、タッチ入力を取得できる Element 。
public ref class VisualElement : Microsoft::Maui::Controls::NavigableElement, Microsoft::Maui::Controls::IAnimatable, Microsoft::Maui::Controls::IVisualElementController, Microsoft::Maui::IViewpublic class VisualElement : Microsoft.Maui.Controls.NavigableElement, Microsoft.Maui.Controls.IAnimatable, Microsoft.Maui.Controls.IVisualElementController, Microsoft.Maui.IViewtype VisualElement = class
inherit NavigableElement
interface IAnimatable
interface IVisualElementController
interface IElementController
interface IView
interface IElement
interface ITransformPublic Class VisualElement
Inherits NavigableElement
Implements IAnimatable, IView, IVisualElementController- 継承
- 継承
- 派生
- 実装
注釈
ほとんどの .NET MAUI on-screen 要素の基本クラス。 画面上に項目を表示するためのほとんどのプロパティ、イベント、およびメソッドを提供します。
コンストラクター
| 名前 | 説明 |
|---|---|
| VisualElement() |
VisualElement クラスの新しいインスタンスを初期化します。 |
フィールド
プロパティ
| 名前 | 説明 |
|---|---|
| AnchorX |
要素の境界を基準にして、変換操作の中心点の X コンポーネントを取得または設定します。 これはバインド可能なプロパティです。 |
| AnchorY |
要素の境界を基準にして、変換操作の中心点の Y コンポーネントを取得または設定します。 これはバインド可能なプロパティです。 |
| AutomationId |
自動化フレームワークがこの要素を見つけ、対話することを可能にする値を取得または設定します。 (継承元 Element) |
| Background |
要素の背景を塗りつぶすために使用する Brush を取得または設定します。 これはバインド可能なプロパティです。 |
| BackgroundColor |
要素の背景を塗りつぶす Color を取得または設定します。 これはバインド可能なプロパティです。 |
| Batched |
この要素に対してバッチ処理された変更が行われることを示す値を取得します。 |
| Behaviors |
この要素に関連付けられている Behavior オブジェクトの一覧を取得します。 これはバインド可能な読み取り専用プロパティです。 |
| BindingContext |
この BindableObjectに属するバインドされたプロパティの対象となるプロパティを含むオブジェクトを取得または設定します。 これはバインド可能なプロパティです。 (継承元 BindableObject) |
| Bounds |
デバイスに依存しない単位で要素の境界を取得します。 |
| class |
要素のスタイル クラスを取得または設定します。 (継承元 NavigableElement) |
| ClassId |
意味的に同類の要素の集合を識別するために使用される値を取得または設定します。 (継承元 Element) |
| Clip |
要素のクリッピング領域を指定します。 これはバインド可能なプロパティです。 |
| DesiredSize |
レイアウト処理の測定パスの実行中に、この要素が計算したサイズを取得します。 |
| DisableLayout |
この要素のレイアウトが無効であることを示す値を取得します。 |
| Dispatcher |
このバインド可能なオブジェクトが作成されたときに使用可能だったディスパッチャーを取得します。それ以外の場合は、使用可能な最も近いディスパッチャー (おそらくウィンドウ/アプリ) を検索しようとします。 (継承元 BindableObject) |
| EffectControlProvider |
.NET MAUI による内部使用の場合。 (継承元 Element) |
| Effects |
実行時に要素に適用されるスタイルとプロパティを取得または設定します。 (継承元 Element) |
| FlowDirection |
レイアウトのフロー方向を取得または設定します。 これはバインド可能なプロパティです。 |
| Frame |
この要素が画面上に存在するフレームを取得または設定します。 |
| Handler |
この要素に関連付けられている IViewHandler を取得または設定します。 |
| Height |
デバイスに依存しない単位で、この要素の現在レンダリングされている高さを取得します。 これはバインド可能な読み取り専用プロパティです。 |
| HeightRequest |
デバイスに依存しない単位で、この要素の必要な高さのオーバーライドを取得または設定します。 これはバインド可能なプロパティです。 |
| Id |
アプリケーションの実行全体で要素を一意に識別するために使用できる値を取得します。 (継承元 Element) |
| InputTransparent |
ユーザーの操作中にこの要素がヒット テストに応答するかどうかを示す値を取得または設定します。 これはバインド可能なプロパティです。 |
| IsEnabled |
この要素をユーザー インターフェイスで有効にするかどうかを示す値を取得または設定します。 これはバインド可能なプロパティです。 |
| IsEnabledCore |
この値は、累積 IsEnabled 値を表します。 このプロパティをオーバーライドするすべての型は、値が変更される場合に RefreshIsEnabledProperty() メソッドも呼び出す必要があります。 |
| IsFocused |
この要素に現在フォーカスがあるかどうかを示す値を取得します。 これはバインド可能なプロパティです。 |
| IsInPlatformLayout |
この要素が現在プラットフォーム レイアウト サイクルを通過していることを示す値を取得または設定します。 |
| IsLoaded |
要素がメイン オブジェクト ツリーに接続されているかどうかを示します。 |
| IsPlatformEnabled |
この要素のプラットフォームに相当する要素が有効かどうかを示す値を取得または設定します。 |
| IsPlatformStateConsistent |
この要素が現在プラットフォームと同等の要素の状態と一致していることを示す値を取得または設定します。 |
| IsVisible |
この要素が画面に表示され、レイアウト内の領域を占有するかどうかを決定する値を取得または設定します。 これはバインド可能なプロパティです。 |
| LogicalChildren |
古い.
画面上の領域を占有し、視覚的な外観を持ち、タッチ入力を取得できる Element 。 (継承元 Element) |
| MaximumHeightRequest |
デバイスに依存しない単位でのレイアウト中に要素が要求する最大高さを取得または設定します。 これはバインド可能なプロパティです。 |
| MaximumWidthRequest |
デバイスに依存しない単位でのレイアウト中に要素が要求する最大幅を取得または設定します。 これはバインド可能なプロパティです。 |
| MinimumHeightRequest |
デバイスに依存しない単位でのレイアウト中に要素が要求する最小高さを取得または設定します。 これはバインド可能なプロパティです。 |
| MinimumWidthRequest |
デバイスに依存しない単位でのレイアウト中に要素が要求する最小幅を取得または設定します。 これはバインド可能なプロパティです。 |
| Navigation |
スタック ベースのナビゲーションを処理するオブジェクトを取得します。 (継承元 NavigableElement) |
| NavigationProxy |
NavigationへのNavigationProxyのキャストを取得します。 (継承元 NavigableElement) |
| Opacity |
描画時に要素に適用する不透明度値を取得または設定します。 この値の範囲は 0 から 1 です。この範囲外の値は、最も近い有効な値に設定されます。 これはバインド可能なプロパティです。 |
| Parent |
この要素の親 Element を取得または設定します。 (継承元 Element) |
| RealParent |
.NET MAUI による内部使用の場合。 (継承元 Element) |
| Resources |
ローカルのリソース ディクショナリを取得または設定します。 |
| Rotation |
要素の描画時に、Z 軸を中心とする回転 (アフィン回転) (度単位) を取得または設定します。 これはバインド可能なプロパティです。 |
| RotationX |
要素の描画時に、X 軸を中心とする回転 (パースペクティブ回転) (度単位) を取得または設定します。 これはバインド可能なプロパティです。 |
| RotationY |
要素の描画時に、Y 軸を中心とする回転 (パースペクティブ回転) (度単位) を取得または設定します。 これはバインド可能なプロパティです。 |
| Scale |
要素に適用するスケール ファクターを取得または設定します。 これはバインド可能なプロパティです。 |
| ScaleX |
X 方向に適用するスケールの値を取得または設定します。 これはバインド可能なプロパティです。 |
| ScaleY |
Y 方向に適用するスケールの値を取得または設定します。 これはバインド可能なプロパティです。 |
| Shadow |
要素によってキャストされるシャドウ効果を取得または設定します。 これはバインド可能なプロパティです。 |
| Style |
この要素の一意の Style を取得または設定します。 (継承元 NavigableElement) |
| StyleClass |
要素のスタイル クラスを取得または設定します。 (継承元 NavigableElement) |
| StyleId |
要素を一意に識別するユーザー定義の値を取得または設定します。 (継承元 Element) |
| TranslationX |
デバイスに依存しない単位の要素の X 変換デルタを取得または設定します。 これはバインド可能なプロパティです。 |
| TranslationY |
デバイスに依存しない単位の要素の Y 変換デルタを取得または設定します。 これはバインド可能なプロパティです。 |
| Triggers |
この要素に関連付けられている TriggerBase オブジェクトの一覧を取得します。 これはバインド可能な読み取り専用プロパティです。 |
| Visual |
要素の外観をオーバーライドする IVisual 実装を取得または設定します。 これはバインド可能なプロパティです。 |
| Width |
デバイスに依存しない単位で、この要素の現在の幅を取得します。 これはバインド可能な読み取り専用プロパティです。 |
| WidthRequest |
デバイスに依存しない単位で、この要素の必要な幅のオーバーライドを取得または設定します。 これはバインド可能なプロパティです。 |
| Window |
要素に関連付けられている Window を取得します。 これはバインド可能な読み取り専用プロパティです。 |
| X |
デバイスに依存しない単位で、この要素の現在の X 位置を取得します。 これはバインド可能な読み取り専用プロパティです。 |
| Y |
デバイスに依存しない単位で、この要素の現在の Y 位置を取得します。 これはバインド可能な読み取り専用プロパティです。 |
| ZIndex |
レイアウト内の要素の前後の z インデックスを取得または設定します。 これはバインド可能なプロパティです。 |
メソッド
| 名前 | 説明 |
|---|---|
| AddLogicalChild(Element) |
論理子に Element を追加します。 (継承元 Element) |
| ApplyBindings() |
現在のすべてのバインディングを BindingContextに適用します。 (継承元 BindableObject) |
| Arrange(Rect) |
子オブジェクトを配置し、要素のサイズを決定します。 |
| ArrangeOverride(Rect) |
サブクラスがコントロールレイアウトパス中にカスタム配置ロジックを実装できるようにします。 |
| BatchBegin() |
要素のプロパティに対する変更のバッチの開始を通知します。 これにより、より多くのプロパティ値が変更された場合にパフォーマンスが向上する可能性があります。 |
| BatchCommit() |
要素へのコマンドのバッチが終端に達したこと、およびこれらのコマンドを今コミットする必要があることを通知します。 |
| ChangeVisualState() |
この要素の現在のプロパティ値に基づいて、現在の表示状態を変更します。 |
| ClearLogicalChildren() |
すべての子 Elementを削除します。 (継承元 Element) |
| ClearValue(BindableProperty) |
バインド可能なプロパティに対して以前に設定されたすべての値をクリアします。 (継承元 BindableObject) |
| ClearValue(BindablePropertyKey) |
バインド可能なプロパティに対して以前に設定された値をクリアします。その値は、そのキーで識別されます。 (継承元 BindableObject) |
| CoerceValue(BindableProperty) |
指定したバインド可能なプロパティの値を強制します。 これを行うには、指定したバインド可能なプロパティの BindableProperty.CoerceValueDelegate を呼び出します。 (継承元 BindableObject) |
| CoerceValue(BindablePropertyKey) |
指定したバインド可能なプロパティの値を強制します。 これを行うには、指定したバインド可能なプロパティの BindableProperty.CoerceValueDelegate を呼び出します。 (継承元 BindableObject) |
| ComputeConstraintForView(View) |
画面上の領域を占有し、視覚的な外観を持ち、タッチ入力を取得できる Element 。 |
| EffectIsAttached(String) |
.NET MAUI による内部使用の場合。 (継承元 Element) |
| Finalize() |
ハンドルに関連付けられたすべてのリソースを解放します。 |
| FindByName(String) |
指定した名前を持つ要素を返します。 (継承元 Element) |
| Focus() |
この要素にフォーカスを設定しようとします。 |
| GetValue(BindableProperty) |
指定されたバインド可能なプロパティに含まれる値を返します。 (継承元 BindableObject) |
| InsertLogicalChild(Int32, Element) |
指定したインデックス位置にある論理子に Element を挿入します。 (継承元 Element) |
| InvalidateMeasure() |
要素の現在のメジャーを無効としてマークします。 |
| InvalidateMeasureNonVirtual(InvalidationTrigger) |
古い.
要素のメジャーを無効にします。 |
| InvalidateMeasureOverride() |
サブクラス (Layout など) のオーバーライドを許可する方法を提供します InvalidateMeasure() |
| IsSet(BindableProperty) |
バインド可能なプロパティが存在し、値が設定されているかどうかを判断します。 (継承元 BindableObject) |
| Layout(Rect) |
古い.
レイアウト サイクル中に要素の境界を更新します。 |
| MapBackgroundColor(IViewHandler, IView) |
画面上の領域を占有し、視覚的な外観を持ち、タッチ入力を取得できる Element 。 |
| MapBackgroundImageSource(IViewHandler, IView) |
画面上の領域を占有し、視覚的な外観を持ち、タッチ入力を取得できる Element 。 |
| Measure(Double, Double, MeasureFlags) |
古い.
デバイスに表示するために要素が必要とする最小サイズを返します。 |
| Measure(Double, Double) |
デバイスに表示するために要素が必要とする最小サイズを返します。 余白は測定から除外されますが、サイズと共に返されます。
親要素に渡される |
| MeasureOverride(Double, Double) |
サブクラスがコントロールメジャーパス中にカスタムメジャーロジックを実装できるようにします。 |
| OnBindingContextChanged() |
この要素のバインド コンテキストが変更されたときに呼び出されます。 |
| OnChildAdded(Element) |
子オブジェクトがこの要素に追加されたときに呼び出されます。 |
| OnChildRemoved(Element, Int32) |
子オブジェクトがこの要素から削除されたときに呼び出されます。 |
| OnChildrenReordered() |
ChildrenReordered イベントを発生させます。 |
| OnHandlerChanged() |
派生クラスでオーバーライドされた場合は、 HandlerChanged イベントを発生させる必要があります。 (継承元 Element) |
| OnHandlerChanging(HandlerChangingEventArgs) |
派生クラスでオーバーライドされた場合は、 HandlerChanging イベントを発生させる必要があります。 (継承元 Element) |
| OnMeasure(Double, Double) |
古い.
レイアウト測定が発生すると呼び出されるメソッド。 |
| OnParentChanged() |
派生クラスでオーバーライドされた場合は、 ParentChanged イベントを発生させる必要があります。 (継承元 Element) |
| OnParentChanging(ParentChangingEventArgs) |
派生クラスでオーバーライドされた場合は、 ParentChanging イベントを発生させる必要があります。 (継承元 Element) |
| OnParentSet() |
(内部) |
| OnPropertyChanged(String) |
バインドされたプロパティが変更されたときに呼び出されるメソッド。 (継承元 Element) |
| OnPropertyChanging(String) |
PropertyChanging イベントを発生させます。 (継承元 BindableObject) |
| OnSizeAllocated(Double, Double) |
レイアウト サイクル中に要素のサイズが設定されたときに呼び出されるメソッド。 このイベントに対するクラス処理を追加するには、このメソッドを実装します。 |
| PlatformSizeChanged() |
この要素のサイズに対応するプラットフォーム要素が変更され、新しいレイアウト サイクルが必要になる可能性があることを通知します。 |
| RefreshIsEnabledProperty() |
何らかのイベントが発生し、 IsEnabledCore プロパティの値が変更される場合は、常にこのメソッドを呼び出す必要があります。 |
| RemoveBinding(BindableProperty) |
バインド可能なプロパティから、以前に設定したバインドを削除します。 (継承元 BindableObject) |
| RemoveDynamicResource(BindableProperty) |
以前に設定した動的リソースを削除します。 (継承元 Element) |
| RemoveLogicalChild(Element) |
論理子から特定の Element の最初の出現箇所を削除します。 (継承元 Element) |
| SetBinding(BindableProperty, BindingBase) |
バインド可能なプロパティにバインドを割り当てます。 (継承元 BindableObject) |
| SetDynamicResource(BindableProperty, String) |
指定したキーを使用して DynamicResource を使用して更新する、この要素の BindableProperty プロパティを設定します。 (継承元 Element) |
| SetValue(BindableProperty, Object) |
指定したバインド可能なプロパティの値を設定します。 (継承元 BindableObject) |
| SetValue(BindablePropertyKey, Object) |
指定したバインド可能なプロパティの値を設定します。 (継承元 BindableObject) |
| SetValueFromRenderer(BindableProperty, Object) |
.NET MAUI による内部使用の場合。 (継承元 Element) |
| SetValueFromRenderer(BindablePropertyKey, Object) |
.NET MAUI による内部使用の場合。 (継承元 Element) |
| SizeAllocated(Double, Double) |
サブツリー レイアウトの開始を通知するために、レイアウト サイクル中に呼び出されるメソッド。 |
| UnapplyBindings() |
現在のコンテキストから現在のすべてのバインドを削除します。 (継承元 BindableObject) |
| Unfocus() |
この要素にキーボード フォーカスを設定解除します。 |
イベント
| 名前 | 説明 |
|---|---|
| BatchCommitted |
BatchCommit()を呼び出すことによって、プロパティ変更のバッチがコミットされたときに発生します。 |
| BindingContextChanged |
BindingContext プロパティの値が変化したときに発生します。 (継承元 BindableObject) |
| ChildAdded |
子要素が要素に追加されるたびに発生します。 (継承元 Element) |
| ChildRemoved |
子要素が要素から削除されるたびに発生します。 (継承元 Element) |
| ChildrenReordered |
この要素の子の順序が変更されたときに発生します。 |
| DescendantAdded |
子要素が要素のサブツリーに追加されるたびに発生します。 (継承元 Element) |
| DescendantRemoved |
子要素が要素サブツリーから削除されるたびに発生します。 (継承元 Element) |
| FocusChangeRequested |
古い.
フォーカスの変更が要求されたときに発生します。 |
| Focused |
この要素にフォーカスがある場合に発生します。 |
| HandlerChanged |
要素のハンドラーが変更されるたびに発生します。 (継承元 Element) |
| HandlerChanging |
要素のハンドラーが変更を開始するたびに発生します。 (継承元 Element) |
| Loaded |
要素が構築され、プラットフォームのビジュアル ツリーに追加されたときに発生します。 |
| MeasureInvalidated |
要素の現在のメジャーが無効になったときに発生します。 |
| ParentChanged |
要素の親が変更されるたびに発生します。 (継承元 Element) |
| ParentChanging |
要素の変更が開始されるたびに発生します。 (継承元 Element) |
| PropertyChanged |
プロパティ値が変更されたときに発生します。 (継承元 BindableObject) |
| PropertyChanging |
プロパティ値が変更されるときに発生します。 (継承元 BindableObject) |
| SizeChanged |
要素のサイズが変更されたときに発生します。 |
| Unfocused |
この要素がフォーカスされていないときに発生します。 |
| Unloaded |
要素がプラットフォームビジュアルツリーに接続されなくなったときに発生します。 |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| IContextFlyoutElement.ContextFlyout |
ビューの ContextFlyout を取得します。 メニュー ポップアップ、メニュー ポップアップ サブ項目、およびメニュー ポップアップ区切り記号をコンテキスト ポップアップに追加できます。 (継承元 Element) |
| IDynamicResourceHandler.SetDynamicResource(BindableProperty, String) |
画面上の領域を占有し、視覚的な外観を持ち、タッチ入力を取得できる Element 。 (継承元 BindableObject) |
| IEffectControlProvider.RegisterEffect(Effect) |
指定した |
| IElement.Handler |
要素のビュー ハンドラーを取得または設定します。 |
| IElement.Parent |
要素の親を取得します。 (継承元 Element) |
| IElementController.Descendants() |
.NET MAUI による内部使用の場合。 (継承元 Element) |
| IElementController.LogicalChildren |
.NET MAUI による内部使用の場合。 (継承元 Element) |
| IElementController.SetValueFromRenderer(BindableProperty, Object) |
.NET MAUI による内部使用の場合。 (継承元 Element) |
| INameScope.RegisterName(String, Object) |
.NET MAUI による内部使用の場合。 (継承元 Element) |
| INameScope.UnregisterName(String) |
.NET MAUI による内部使用の場合。 (継承元 Element) |
| IToolTipElement.ToolTip |
ユーザーがビューにポインターを置いたときに、ビューの目的の簡単な説明を表示する小さな四角形のポップアップ ウィンドウを表します。 (継承元 Element) |
| IView.Arrange(Rect) |
子要素を配置し、要素のサイズを決定します。 |
| IView.Background |
ビューの背景を塗りつぶすペイントを取得します。 |
| IView.Clip |
ビューの内容のアウトラインを定義するために使用するパスを取得します。 |
| IView.FlowDirection |
UI 要素が目でスキャンされる方向 |
| IView.Height |
IView の指定した高さを取得します。 |
| IView.HorizontalLayoutAlignment |
コンテナー内でのこの要素の配置の水平方向の側面を決定します。 |
| IView.InvalidateArrange() |
このビューのレイアウトを無効にするために呼び出されるメソッド。 |
| IView.InvalidateMeasure() |
このビューの現在のメジャー値が無効になり、次のメジャー パス中に再計算する必要があることを通知します。 |
| IView.IsFocused |
このビューが現在フォーカスされているかどうかを示す値を取得します。 |
| IView.Margin |
余白は、ビューと隣接するビューの間の距離を表します。 |
| IView.MaximumHeight |
0 から double までの IView の指定された最大高さ制約を取得します。PositiveInfinity。 |
| IView.MaximumWidth |
0 から double までの IView の指定された最大幅制約を取得します。PositiveInfinity。 |
| IView.Measure(Double, Double) |
ビューのサイズを更新します。 |
| IView.MinimumHeight |
0 から double までの IView の指定された最小高さ制約を取得します。PositiveInfinity。 |
| IView.MinimumWidth |
0 から double までの IView の指定された最小幅制約を取得します。PositiveInfinity。 |
| IView.Semantics |
アクセシビリティのためにすべてのビューにセマンティクスを追加します |
| IView.Shadow |
ターゲット ビューの周囲に影を描画します。 |
| IView.VerticalLayoutAlignment |
コンテナー内でのこの要素の配置の垂直方向の側面を決定します。 |
| IView.Visibility |
このビューをビジュアル ツリーの一部にするかどうかを決定する値を取得します。 |
| IView.Width |
IView の指定した幅を取得します。 |
| IVisualElementController.EffectiveFlowDirection |
.NET MAUI による内部使用の場合。 |
| IVisualElementController.InvalidateMeasure(InvalidationTrigger) |
.NET MAUI による内部使用の場合。 |
| IVisualTreeElement.GetVisualChildren() |
要素のビジュアルの子の読み取り専用リストを取得します。 (継承元 Element) |
| IVisualTreeElement.GetVisualParent() |
要素のビジュアルの親を取得します。 (継承元 Element) |
