FrameworkElement.GoToElementStateCore(String, Boolean) メソッド

定義

名前空間:

Microsoft.UI.Xaml

派生クラスで実装すると、コントロールの起動時にすべての状態の XAML を読み込むのではなく、コード内のコントロール テンプレートのビジュアル ツリーを状態ごとに構築できます。

protected:
 virtual bool GoToElementStateCore(Platform::String ^ stateName, bool useTransitions) = GoToElementStateCore;

bool GoToElementStateCore(winrt::hstring const& stateName, bool const& useTransitions);

protected virtual bool GoToElementStateCore(string stateName, bool useTransitions);

function goToElementStateCore(stateName, useTransitions)

Protected Overridable Function GoToElementStateCore (stateName As String, useTransitions As Boolean) As Boolean

パラメーター

stateName

String

Platform::String

winrt::hstring

切り替え先の状態。

useTransitions

Boolean

bool

true 状態間の遷移に VisualTransition を使用する場合は 。 false 切り替えの使用をスキップし、要求された状態に直接移動します。 既定では、 falseです。

戻り値

Boolean

bool

true コントロールが正常に新しい状態に移行した場合、または既にその状態を使用していた場合。それ以外の場合は false。

注釈

の既定の FrameworkElement.GoToElementStateCore 実装では、 VisualStateManager.GoToState を呼び出すことによってアクセスされる通常の状態変更動作と、XAML コントロールの既定のコントロール テンプレート/ビジュアル状態読み込み動作も提供されます。 オーバーライド FrameworkElement.GoToElementStateCore する必要があるのは、実行時にコード内のコントロールのビジュアル ツリーを構築する完全な責任を負う準備ができている場合のみです。 これには、コンテンツ プロパティ、子要素コレクションなどから取得されたコンテンツのプレゼンテーションが含まれます。

カスタム コントロールの一般的な状態変更ロジックの場合は、 VisualStateManager.GoToState を使用する必要があります。 の目的のシナリオ FrameworkElement.GoToElementStateCore は、特に 、ListViewItem または GridViewItem のビジュアル ツリーを作成し、コンテンツを表示するテンプレートまたはロジックを最適化するアプリまたはコントロールを対象としています。

VisualStateManager.GoToState は静的ユーティリティ API であり、コントロール パラメーターを使用して状態変更を適用する コントロール を指定するため、シグネチャが若干異なります。 FrameworkElement.GoToElementStateCore は、呼び出し元オブジェクトを使用してこの情報を取得します。

こちらもご覧ください

• GoToState(Control, String, Boolean)