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

  • リファレンス

定義

名前空間:
Windows.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

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

戻り値

Boolean

bool

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

注釈

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

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

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

適用対象

こちらもご覧ください