FrameworkElement.GoToElementStateCore(String, Boolean) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
派生クラスで実装すると、コントロールの起動時にすべての状態の 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
です。
戻り値
bool
true
コントロールが正常に新しい状態に移行した場合、または既にその状態を使用していた場合。それ以外の場合は false
。
注釈
の既定の FrameworkElement.GoToElementStateCore
実装では、 VisualStateManager.GoToState を呼び出すことによってアクセスされる通常の状態変更動作と、XAML コントロールの既定のコントロール テンプレート/ビジュアル状態読み込み動作も提供されます。 オーバーライド FrameworkElement.GoToElementStateCore
する必要があるのは、実行時にコード内のコントロールのビジュアル ツリーを構築する完全な責任を負う準備ができている場合のみです。 これには、コンテンツ プロパティ、子要素コレクションなどから取得されたコンテンツのプレゼンテーションが含まれます。
カスタム コントロールの一般的な状態変更ロジックの場合は、 VisualStateManager.GoToState を使用する必要があります。 の目的のシナリオ FrameworkElement.GoToElementStateCore
は、特に 、ListViewItem または GridViewItem のビジュアル ツリーを作成し、コンテンツを表示するテンプレートまたはロジックを最適化するアプリまたはコントロールを対象としています。
VisualStateManager.GoToState は静的ユーティリティ API であり、コントロール パラメーターを使用して状態変更を適用する コントロール を指定するため、シグネチャが若干異なります。
FrameworkElement.GoToElementStateCore
は、呼び出し元オブジェクトを使用してこの情報を取得します。