AnimatedIcon クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザーの操作とビジュアルの状態の変化に応じてアニメーション化できるビジュアルを表示および制御するアイコンを表します。
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Source")]
class AnimatedIcon : IconElement
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Source")]
public class AnimatedIcon : IconElement
Public Class AnimatedIcon
Inherits IconElement
- 継承
- 属性
例
ヒント
詳細、設計ガイダンス、およびコード例については、「 アニメーション アイコン」を参照してください。
WinUI 3 ギャラリー アプリには、ほとんどの WinUI 3 コントロールと機能の対話型の例が含まれています。 Microsoft Store からアプリを入手するか、GitHub でソース コードを取得します。
ボタンに AnimatedIcon を追加する
この例では、ポインター イベントが発生したときにアニメーション化する戻る矢印アイコンを含む戻るボタンを示します。
- AnimatedBackVisualSource は、WinUI によって提供される逆矢印アニメーションです。
- FallbackIconSource は、アニメーションを再生できない場合に使用されます。
- に設定
true
された UIElement.AddHandler メソッドhandledEventsToo
は、ボタンが PointerRoutedEventArgs.Handled としてマークするイベントに使用されます。
<!--
xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
xmlns:animatedvisuals="using:Microsoft.UI.Xaml.Controls.AnimatedVisuals"
-->
<AppBarButton x:Name="BackButton" Label="Back"
muxc:AnimatedIcon.State="Normal"
PointerEntered="AppBarButton_PointerEntered"
PointerExited="AppBarButton_PointerExited">
<muxc:AnimatedIcon>
<animatedvisuals:AnimatedBackVisualSource/>
<muxc:AnimatedIcon.FallbackIconSource>
<muxc:SymbolIconSource Symbol="Back"/>
</muxc:AnimatedIcon.FallbackIconSource>
</muxc:AnimatedIcon>
</AppBarButton>
// using muxc = Microsoft.UI.Xaml.Controls;
// Add handlers.
protected override void OnNavigatedTo(NavigationEventArgs e)
{
SettingsButton.AddHandler(UIElement.PointerPressedEvent,
new PointerEventHandler(AppBarButton_PointerPressed), true);
SettingsButton.AddHandler(UIElement.PointerReleasedEvent,
new PointerEventHandler(AppBarButton_PointerReleased), true);
base.OnNavigatedTo(e);
}
// Remove handlers.
protected override void OnNavigatedFrom(NavigationEventArgs e)
{
SettingsButton.RemoveHandler(UIElement.PointerPressedEvent,
(PointerEventHandler)AppBarButton_PointerPressed);
SettingsButton.RemoveHandler(UIElement.PointerReleasedEvent,
(PointerEventHandler)AppBarButton_PointerReleased);
base.OnNavigatedFrom(e);
}
private void AppBarButton_PointerEntered(object sender, PointerRoutedEventArgs e)
{
muxc.AnimatedIcon.SetState((UIElement)sender, "PointerOver");
}
private void AppBarButton_PointerPressed(object sender, PointerRoutedEventArgs e)
{
muxc.AnimatedIcon.SetState((UIElement)sender, "Pressed");
}
private void AppBarButton_PointerReleased(object sender, PointerRoutedEventArgs e)
{
muxc.AnimatedIcon.SetState((UIElement)sender, "Normal");
}
private void AppBarButton_PointerExited(object sender, PointerRoutedEventArgs e)
{
muxc.AnimatedIcon.SetState((UIElement)sender, "Normal");
}
注釈
アイコンのアニメーションビジュアルを指定するには、 AnimatedIcon.Source プロパティを設定します。 WinUI には、 Microsoft.UI.Xaml.Controls.AnimatedVisuals 名前空間の一般的なアイコンのアニメーションビジュアルが用意されています。
場合によっては、システムの設定や制限によって、アイコンがアニメーション化されない場合があります。
- ユーザーがシステム設定でアニメーションをオフにすると、
AnimatedIcon
コントロールの状態遷移の最終フレームが表示されます。 - Lottie アニメーションをサポートしていない古いバージョンの Windows など、アニメーションがサポートされていない場合に使用する FallbackIconSource を指定します。
カスタム アニメーション
アプリでアニメーションアイコンとして使用するカスタム アニメーションを作成できます。 アニメーションは Adobe AfterEffects を使用して作成できます。その出力を Lottie-Windows ライブラリで使用して、IAnimatedVisualSource2 を実装するカスタム クラスを生成できます。 このクラスは、アニメーション化されたアイコンの ソース として使用できます。 詳細については、「 Lottie を使用して AnimatedIcon のアニメーションコンテンツを作成する」を参照してください。
アニメーション化されたアイコンの状態を制御する
アニメーションの再生位置と状態を変更するには、 AnimatedIcon.State 添付プロパティを設定します。 state プロパティは、"""、"Normal
"PointerOver
、"" などの視覚的な状態を記述する文字列値をPressed
受け取ります。 "" などのPressedToNormal
特定の状態遷移を指定することもできます。
アニメーションアイコンソースには、アニメーションタイムライン内の位置を視覚的な状態にマップするマーカーが含まれています。 添付プロパティを Source
設定 State
するために をサポートする文字列値は、コレクションで Markers
定義されます。 詳細については、「 AnimatedIcon マーカーを定義する」を参照してください。
多くの場合、コントロール テンプレートで使用されるアニメーション化されたビジュアル ソースには、状態を制御するためのマップの Markers
より複雑なセットがあります。一方、より一般的に使用するためにアニメーション化されたビジュアルには、ポインター イベントにマップするより単純なセット Markers
が含まれることがよくあります。
状態を設定する場所
プロパティは、XAML ツリーの AnimatedIcon
または 先祖に設定できます。 どちらの場合も、添付プロパティの構文を次のように使用する必要があります。
<muxc:AnimatedIcon muxc:AnimatedIcon.State="Normal">...</muxc:AnimatedIcon>
重要
XAML ツリーに を追加 AnimatedIcon
し、先祖要素の プロパティを State
設定する場合、アニメーション化されたアイコンがアニメーション化されるようにするには、 State
アニメーション化されたアイコンが最初に読み込まれる前に、プロパティを初期値に設定する必要があります。 通常は、次に示すように XAML で初期状態を設定します。
<StackPanel muxc:AnimatedIcon.State="Normal" ...>
<muxc:AnimatedIcon>
<animatedvisuals:AnimatedBackVisualSource/>
</muxc:AnimatedIcon>
</StackPanel>
表示状態を使用する
XAML コントロールの に ControlTemplate
を追加AnimatedIcon
し、VisualStateManager を使用してその状態を設定できます。 NavigationViewItem などの一部のコントロールでは、アイコンとして設定された のAnimatedIcon
状態が自動的に設定されます。
コントロール テンプレートのビジュアル状態を設定 AnimatedIcon.State
する例については、WinUI GitHub リポジトリの 「CheckBox_themeresources.xaml 」を参照してください。 コントロールはCheckBox
、チェック マークに AnimatedAcceptVisualSource を使用します。 ビジュアル状態セッターは次のようになります。
<VisualState x:Name="CheckedPointerOver">
...
<VisualState.Setters>
<Setter Target="CheckGlyph.(AnimatedIcon.State)" Value="PointerOverOn"/>
</VisualState.Setters>
</VisualState>
ポインター イベントを処理する
ユーザーの AnimatedIcon
操作に応答するには、いくつかのポインター イベントに応答して AnimatedIcon.State 添付プロパティを設定する必要があります。 次の表は、通常処理するポインター イベントと、これらのイベントにマップされる一般的な状態を示しています。 (ただし、すべてのアニメーション化されたアイコン ソースがこれらの状態に正確にマップされるわけではありません)。
イベント | 状態 |
---|---|
UIElement.PointerEntered | "PointerOver " |
UIElement.PointerPressed | "Pressed " |
UIElement.PointerReleased | "Normal " |
UIElement.PointerExited | "Normal " |
ヒント
Click イベントを持つ Button または他のコントロール内に をAnimatedIcon
配置すると、 PointerPressed
イベントと PointerReleased
イベントは PointerRoutedEventArgs.Handled としてマークされます。 ボタンでこれらのイベントを処理するには、UIElement.AddHandler メソッドを使用してイベント ハンドラーを接続し、 として true
を指定handledEventsToo
します。 UIElement.RemoveHandler を使用して、イベント ハンドラーを切断します。
これらのイベント ハンドラーを示すサンプル コードについては、「例」セクションを参照してください。
XAML 添付プロパティ
AnimatedIcon
は、 XAML 添付プロパティのホスト サービス クラスです。
アタッチされたプロパティへの XAML プロセッサ アクセスをサポートし、同等の get 操作と set 操作をコードに公開するために、各 XAML 添付プロパティには Get メソッドと Set アクセサー メソッドのペアがあります。 コードで値を取得または設定するもう 1 つの方法は、依存関係プロパティ システムを使用して GetValue または SetValue を呼び出し、識別子フィールドを依存関係プロパティ識別子として渡すことです。
コンストラクター
AnimatedIcon() |
AnimatedIcon クラスの新しいインスタンスを初期化します。 |
プロパティ
AccessKey |
この要素のアクセス キー (ニーモニック) を取得または設定します。 (継承元 UIElement) |
AccessKeyScopeOwner |
ソース要素のビジュアル ツリーにない場合でも、この要素のアクセス キー スコープを提供するソース要素を取得または設定します。 (継承元 UIElement) |
ActualHeight |
FrameworkElement のレンダリングされた高さを取得します。 「解説」を参照してください。 (継承元 FrameworkElement) |
ActualOffset |
レイアウト プロセスの配置パス中に計算された、親を基準としたこの UIElement の位置を取得します。 (継承元 UIElement) |
ActualSize |
レイアウト プロセスの配置パス中にこの UIElement が計算したサイズを取得します。 (継承元 UIElement) |
ActualTheme |
要素で現在使用されている UI テーマを取得します。 これは RequestedTheme とは異なる場合があります。 (継承元 FrameworkElement) |
ActualWidth |
FrameworkElement のレンダリングされた幅を取得します。 「解説」を参照してください。 (継承元 FrameworkElement) |
AllowDrop |
この UIElement をドラッグ アンド ドロップ操作の目的でドロップ ターゲットにできるかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
AllowFocusOnInteraction |
ユーザーが操作するときに要素が自動的にフォーカスを取得するかどうかを示す値を取得または設定します。 (継承元 FrameworkElement) |
AllowFocusWhenDisabled |
無効なコントロールがフォーカスを受け取ることができるかどうかを取得または設定します。 (継承元 FrameworkElement) |
BaseUri |
XAML 読み込み時に XAML で構築されたオブジェクトのベース URI を表す URI (Uniform Resource Identifier) を取得します。 このプロパティは、実行時の URI 解決に役立ちます。 (継承元 FrameworkElement) |
CacheMode |
レンダリングされたコンテンツを可能な限り複合ビットマップとしてキャッシュする必要があることを示す値を取得または設定します。 (継承元 UIElement) |
CanBeScrollAnchor |
UIElement をスクロール アンカーの候補にできるかどうかを示す値を取得または設定します。 (継承元 UIElement) |
CanDrag |
要素をドラッグ アンド ドロップ操作でデータとしてドラッグできるかどうかを示す値を取得または設定します。 (継承元 UIElement) |
CenterPoint |
要素の中心点 (回転またはスケーリングが発生するポイント) を取得または設定します。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
Clip |
UIElement の内容のアウトラインを定義するために使用する RectangleGeometry を取得または設定します。 (継承元 UIElement) |
CompositeMode |
親レイアウトとウィンドウ内の要素の代替合成モードとブレンド モードを宣言するプロパティを取得または設定します。 これは、混合 XAML/Microsoft DirectX UI に関連する要素に関連します。 (継承元 UIElement) |
ContextFlyout |
この要素に関連付けられているポップアップを取得または設定します。 (継承元 UIElement) |
DataContext |
FrameworkElement のデータ コンテキストを取得または設定します。 データ コンテキストの一般的な用途は、 が {Binding} マークアップ拡張機能を使用し、データ バインディングに参加する場合 |
DesiredSize |
レイアウト プロセスのメジャー パス中にこの UIElement が計算したサイズを取得します。 (継承元 UIElement) |
Dispatcher |
常に Windows アプリ SDK アプリで を返します |
DispatcherQueue |
このオブジェクトが |
ExitDisplayModeOnAccessKeyInvoked |
アクセス キーが呼び出されたときにアクセス キーの表示を閉じるかどうかを指定する値を取得または設定します。 (継承元 UIElement) |
FallbackIconSource |
アニメーション化されたアイコンを実行できない場合に使用する静的アイコンを取得または設定します。 |
FallbackIconSourceProperty |
FallbackIconSource 依存関係プロパティを識別します。 |
FlowDirection |
レイアウトを制御する任意の親要素内でテキストやその他の UI 要素が流れる方向を取得または設定します。 このプロパティは、 または |
FocusState |
このコントロールにフォーカスがあるかどうかを示す値と、フォーカスが取得されたモードを取得します。 (継承元 UIElement) |
FocusVisualMargin |
FrameworkElement のフォーカス ビジュアルの外側の余白を取得または設定します。 (継承元 FrameworkElement) |
FocusVisualPrimaryBrush |
FrameworkElement の または |
FocusVisualPrimaryThickness |
FrameworkElement の または フォーカス ビジュアルの外側の境界線の |
FocusVisualSecondaryBrush |
FrameworkElement の または |
FocusVisualSecondaryThickness |
FrameworkElement の または フォーカス ビジュアルの内側の境界線の |
Foreground |
前景色を表すブラシを取得または設定します。 (継承元 IconElement) |
Height |
FrameworkElement の推奨される高さを取得または設定します。 (継承元 FrameworkElement) |
HighContrastAdjustment |
ハイ コントラスト テーマが有効になっている場合に、フレームワークが要素のビジュアル プロパティを自動的に調整するかどうかを示す値を取得または設定します。 (継承元 UIElement) |
HorizontalAlignment |
パネルや項目コントロールなど、レイアウトの親で構成されている場合に FrameworkElement に適用される水平方向の配置特性を取得または設定します。 (継承元 FrameworkElement) |
IsAccessKeyScope |
要素が独自のアクセス キー スコープを定義するかどうかを示す値を取得または設定します。 (継承元 UIElement) |
IsDoubleTapEnabled |
DoubleTapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
IsHitTestVisible |
この UIElement の包含領域がヒット テストの true 値を返すことができるかどうかを取得または設定します。 (継承元 UIElement) |
IsHoldingEnabled |
Holding イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
IsLoaded |
要素が要素ツリーに追加され、操作の準備ができているかどうかを示す値を取得します。 (継承元 FrameworkElement) |
IsRightTapEnabled |
RightTapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
IsTabStop |
コントロールがタブ ナビゲーションに含まれるかどうかを示す値を取得または設定します。 (継承元 UIElement) |
IsTapEnabled |
Tapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
KeyboardAcceleratorPlacementMode |
コントロール のヒント に、関連付けられているキーボード アクセラレータのキーの組み合わせを表示するかどうかを示す値を取得または設定します。 (継承元 UIElement) |
KeyboardAcceleratorPlacementTarget |
アクセラレータ キーの組み合わせを表示 するコントロールヒント を示す値を取得または設定します。 (継承元 UIElement) |
KeyboardAccelerators |
キーボードを使用してアクションを呼び出すキーの組み合わせのコレクションを取得します。 アクセラレータは通常、ボタンまたはメニュー項目に割り当てられます。
|
KeyTipHorizontalOffset |
UIElement に関連してキー ヒントを左右に配置する距離を示す値を取得または設定します。 (継承元 UIElement) |
KeyTipPlacementMode |
アクセス キーのキー ヒントが UIElement の境界に対して配置される場所を示す値を取得または設定します。 (継承元 UIElement) |
KeyTipTarget |
アクセス キーのキー ヒントの対象となる要素を示す値を取得または設定します。 (継承元 UIElement) |
KeyTipVerticalOffset |
UI 要素に関連してキー ヒントを配置する距離を示す値を取得または設定します。 (継承元 UIElement) |
Language |
FrameworkElement に適用されるローカライズ/グローバリゼーション言語情報と、オブジェクト表現と UI の現在の FrameworkElement のすべての子要素を取得または設定します。 (継承元 FrameworkElement) |
Lights |
この要素にアタッチされている XamlLight オブジェクトのコレクションを取得します。 (継承元 UIElement) |
ManipulationMode |
UIElement の動作とジェスチャとの対話に使用される ManipulationModes 値を取得または設定します。 この値を設定すると、アプリ コードでこの要素から操作イベントを処理できます。 (継承元 UIElement) |
Margin |
FrameworkElement の外側の余白を取得または設定します。 (継承元 FrameworkElement) |
MaxHeight |
FrameworkElement の最大高さ制約を取得または設定します。 (継承元 FrameworkElement) |
MaxWidth |
FrameworkElement の最大幅制約を取得または設定します。 (継承元 FrameworkElement) |
MinHeight |
FrameworkElement の最小高さ制約を取得または設定します。 (継承元 FrameworkElement) |
MinWidth |
FrameworkElement の最小幅制約を取得または設定します。 (継承元 FrameworkElement) |
MirroredWhenRightToLeft |
FlowDirection が RightToLeft の場合にアイコンをミラー化するかどうかを示す値を取得または設定します。 |
MirroredWhenRightToLeftProperty |
MirroredWhenRightToLeft 依存関係プロパティを識別します。 |
Name |
オブジェクトの識別名を取得または設定します。 XAML プロセッサが XAML マークアップからオブジェクト ツリーを作成する場合、ランタイム コードはこの名前で XAML で宣言されたオブジェクトを参照できます。 (継承元 FrameworkElement) |
Opacity |
オブジェクトの不透明度の程度を取得または設定します。 (継承元 UIElement) |
OpacityTransition |
Opacity プロパティへの変更をアニメーション化する ScalarTransition を取得または設定します。 (継承元 UIElement) |
Parent |
オブジェクト ツリー内のこの FrameworkElement の親オブジェクトを取得します。 (継承元 FrameworkElement) |
PointerCaptures |
Pointer 値として表されるすべてのキャプチャされたポインターのセット を取得します 。 (継承元 UIElement) |
Projection |
この要素をレンダリングするときに適用するパースペクティブ プロジェクション (3-D 効果) を取得または設定します。 (継承元 UIElement) |
ProtectedCursor |
ポインターがこの要素の上にあるときに表示されるカーソルを取得または設定します。 既定値は null で、カーソルに変更がないことを示します。 (継承元 UIElement) |
RasterizationScale |
各ビュー ピクセルの生 (物理) ピクセルの数を表す値を取得します。 (継承元 UIElement) |
RenderSize |
UIElement の最終的なレンダリング サイズを取得します。 使用は推奨されません。「備考」を参照してください。 (継承元 UIElement) |
RenderTransform |
UIElement のレンダリング位置に影響する変換情報を取得または設定します。 (継承元 UIElement) |
RenderTransformOrigin |
UIElement の境界を基準にして RenderTransform によって宣言された、可能なレンダリング変換の原点を取得または設定します。 (継承元 UIElement) |
RequestedTheme |
リソースを決定するために UIElement (およびその子要素) によって使用される UI テーマを取得または設定します。 で指定 |
Resources |
ローカルで定義されたリソース ディクショナリを取得します。 XAML では、XAML の暗黙的なコレクション構文を使用して、プロパティ要素の |
Rotation |
時計回りの回転角度を度単位で取得または設定します。 RotationAxis と CenterPoint を基準にして回転します。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
RotationAxis |
要素を回転させる軸を取得または設定します。 (継承元 UIElement) |
RotationTransition |
Rotation プロパティの変更をアニメーション化する ScalarTransition を取得または設定します。 (継承元 UIElement) |
Scale |
要素のスケールを取得または設定します。 要素の CenterPoint を基準にして拡大縮小します。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
ScaleTransition |
Scale プロパティの変更をアニメーション化する Vector3Transition を取得または設定します。 (継承元 UIElement) |
Shadow |
要素によってキャストされる影効果を取得または設定します。 (継承元 UIElement) |
Source |
オブジェクトによって表示されるアニメーション化されたビジュアルを |
SourceProperty |
Source 依存関係プロパティを識別 します 。 |
StateProperty |
AnimatedIcon.State XAML 添付プロパティを識別します。 |
Style |
レイアウトとレンダリング中にこのオブジェクトに適用されるインスタンス Style を取得または設定します。 (継承元 FrameworkElement) |
TabFocusNavigation |
このコントロールのタブと TabIndex の動作方法を変更する値を取得または設定します。 (継承元 UIElement) |
TabIndex |
ユーザーが Tab キーを使用してコントロール内を移動するときに要素がフォーカスを受け取る順序を決定する値を取得または設定します。 (継承元 UIElement) |
Tag |
このオブジェクトに関するカスタム情報を格納するために使用できる任意のオブジェクト値を取得または設定します。 (継承元 FrameworkElement) |
Transform3D |
この要素をレンダリングするときに適用する 3-D 変換効果を取得または設定します。 (継承元 UIElement) |
TransformMatrix |
要素に適用する変換行列を取得または設定します。 (継承元 UIElement) |
Transitions |
UIElement に適用される Transition スタイル要素のコレクションを取得または設定します。 (継承元 UIElement) |
Translation |
要素の x、y、z のレンダリング位置を取得または設定します。 (継承元 UIElement) |
TranslationTransition |
Translation プロパティの変更をアニメーション化する Vector3Transition を取得または設定します。 (継承元 UIElement) |
Triggers |
FrameworkElement に対して定義されているアニメーションのトリガーのコレクションを取得します。 一般的に使用されません。 「解説」を参照してください。 (継承元 FrameworkElement) |
UseLayoutRounding |
オブジェクトとそのビジュアル サブツリーのレンダリングで、レンダリングをピクセル全体に合わせる丸め動作を使用するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
UseSystemFocusVisuals |
コントロールがシステムによって描画されたフォーカス ビジュアルを使用するか、コントロール テンプレートで定義されているフォーカス ビジュアルを使用するかを示す値を取得または設定します。 (継承元 UIElement) |
VerticalAlignment |
パネルや項目コントロールなどの親オブジェクトで構成されている場合に FrameworkElement に適用される垂直方向の配置特性を取得または設定します。 (継承元 FrameworkElement) |
Visibility |
UIElement の可視性を取得または設定します。 |
Width |
FrameworkElement の幅を取得または設定します。 (継承元 FrameworkElement) |
XamlRoot |
この要素が表示される を |
XYFocusDown |
ユーザーがゲーム コントローラーの方向パッド (D パッド) を押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 UIElement) |
XYFocusDownNavigationStrategy |
ダウン ナビゲーションのターゲット要素を決定するために使用する戦略を指定する値を取得または設定します。 (継承元 UIElement) |
XYFocusKeyboardNavigation |
キーボード方向矢印を使用してナビゲーションを有効または無効にする値を取得または設定します。 (継承元 UIElement) |
XYFocusLeft |
ユーザーがゲーム コントローラーの方向パッド (D パッド) を左に押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 UIElement) |
XYFocusLeftNavigationStrategy |
左ナビゲーションのターゲット要素を決定するために使用される戦略を指定する値を取得または設定します。 (継承元 UIElement) |
XYFocusRight |
ユーザーがゲーム コントローラーの方向パッド (D パッド) を右に押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 UIElement) |
XYFocusRightNavigationStrategy |
右ナビゲーションのターゲット要素を決定するために使用する戦略を指定する値を取得または設定します。 (継承元 UIElement) |
XYFocusUp |
ユーザーがゲーム コントローラーの方向パッド (D パッド) を押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 UIElement) |
XYFocusUpNavigationStrategy |
アップ ナビゲーションのターゲット要素を決定するために使用する戦略を指定する値を取得または設定します。 (継承元 UIElement) |
添付プロパティ
State |
開発者が AnimatedIcon に設定するプロパティ。 |
メソッド
AddHandler(RoutedEvent, Object, Boolean) |
指定したルーティング イベントのルーティング イベント ハンドラーを追加します。このハンドラーは、現在の要素のハンドラー コレクションに追加されます。 イベントが他の場所で処理される場合でも、指定されたハンドラーを呼び出すように を |
Arrange(Rect) |
子オブジェクトを配置し、 UIElement のサイズを決定します。 子要素のカスタム レイアウトを実装する親オブジェクトは、そのレイアウトオーバーライド実装からこのメソッドを呼び出して、再帰的なレイアウト更新を形成する必要があります。 (継承元 UIElement) |
ArrangeOverride(Size) |
レイアウトの "配置" パスの動作を提供します。 クラスは、このメソッドをオーバーライドして、独自の "配置" パス動作を定義できます。 (継承元 FrameworkElement) |
CancelDirectManipulations() |
現在の UIElement を含む ScrollViewer 親に対して、進行中の直接操作処理 (システム定義のパン/ズーム) を取り消します。 (継承元 UIElement) |
CapturePointer(Pointer) |
ポインター キャプチャを UIElement に設定します。 キャプチャされると、キャプチャを持つ要素のみがポインター関連のイベントを発生させます。 (継承元 UIElement) |
ClearValue(DependencyProperty) |
依存関係プロパティのローカル値をクリアします。 (継承元 DependencyObject) |
FindName(String) |
指定した識別子名を持つオブジェクトを取得します。 (継承元 FrameworkElement) |
FindSubElementsForTouchTargeting(Point, Rect) |
UIElement サブクラスが、タッチ ターゲットの解決に役立つ子要素を公開できるようにします。 (継承元 UIElement) |
Focus(FocusState) |
この要素にフォーカスを設定することを試みます。 (継承元 UIElement) |
GetAnimationBaseValue(DependencyProperty) |
依存関係プロパティに対して確立された基本値を返します。これは、アニメーションがアクティブでない場合に適用されます。 (継承元 DependencyObject) |
GetBindingExpression(DependencyProperty) |
指定したプロパティのバインドを表す BindingExpression を返します。 (継承元 FrameworkElement) |
GetChildrenInTabFocusOrder() |
UIElement サブクラスが Tab フォーカスに参加する子要素を公開できるようにします。 (継承元 UIElement) |
GetState(DependencyObject) |
指定した DependencyObject の AnimatedIcon.State 添付プロパティの値を取得します。 |
GetValue(DependencyProperty) |
DependencyObject から依存関係プロパティの現在の有効な値を返します。 (継承元 DependencyObject) |
GetVisualInternal() |
要素が |
GoToElementStateCore(String, Boolean) |
派生クラスで実装すると、コントロールの起動時にすべての状態の XAML を読み込むのではなく、コード内のコントロール テンプレートのビジュアル ツリーを状態ごとに構築できます。 (継承元 FrameworkElement) |
InvalidateArrange() |
UIElement の配置状態 (レイアウト) を無効にします。 無効にすると、 UIElement のレイアウトが更新され、非同期的に行われます。 (継承元 UIElement) |
InvalidateMeasure() |
UIElement の測定状態 (レイアウト) を無効にします。 (継承元 UIElement) |
InvalidateViewport() |
有効なビューポートの計算に使用される UIElement の ビューポート状態を無効にします。 (継承元 FrameworkElement) |
Measure(Size) |
UIElement の DesiredSize をUpdatesします。 通常、レイアウトの子のカスタム レイアウトを実装するオブジェクトは、独自の MeasureOverride 実装からこのメソッドを呼び出して、再帰的なレイアウト更新を形成します。 (継承元 UIElement) |
MeasureOverride(Size) |
レイアウト サイクルの "メジャー" パスの動作を提供します。 クラスは、このメソッドをオーバーライドして、独自の "Measure" パス動作を定義できます。 (継承元 FrameworkElement) |
OnApplyTemplate() |
アプリケーション コードまたは内部プロセス (再構築レイアウト パスなど) が ApplyTemplate を呼び出すたびに呼び出されます。 最も簡単に言うと、これは、UI 要素がアプリに表示される直前に メソッドが呼び出されていることを意味します。 クラスの既定のテンプレート後ロジックに影響を与えるために、このメソッドをオーバーライドします。 (継承元 FrameworkElement) |
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
BringIntoViewRequested イベントが発生する前に呼び出されます。 (継承元 UIElement) |
OnCreateAutomationPeer() |
派生クラスで実装すると、Microsoft UI オートメーション インフラストラクチャのクラス固有の AutomationPeer 実装が返されます。 (継承元 UIElement) |
OnDisconnectVisualChildren() |
クラス固有のコンテンツまたは子プロパティから項目が削除されたときにレイアウトとロジックがどのように動作するかを実装するには、このメソッドをオーバーライドします。 (継承元 UIElement) |
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs) |
アプリで キーボード ショートカット (またはアクセラレータ) が処理されるときに呼び出されます。 キーボード アクセラレータが呼び出されたときにアプリがどのように応答するかを処理するには、このメソッドをオーバーライドします。 (継承元 UIElement) |
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) |
アプリでキーボード ショートカット (またはアクセラレータ) が処理される直前に呼び出されます。 アプリケーション コードまたは内部プロセスが ProcessKeyboardAccelerators を呼び出すたびに呼び出されます。 このメソッドをオーバーライドして、既定のアクセラレータ処理に影響を与える。 (継承元 UIElement) |
PopulatePropertyInfo(String, AnimationPropertyInfo) |
アニメーション化できるプロパティを定義します。 (継承元 UIElement) |
PopulatePropertyInfoOverride(String, AnimationPropertyInfo) |
派生クラスでオーバーライドされると、アニメーション化できるプロパティを定義します。 (継承元 UIElement) |
ReadLocalValue(DependencyProperty) |
ローカル値が設定されている場合は、依存関係プロパティのローカル値を返します。 (継承元 DependencyObject) |
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
この DependencyObject インスタンスの特定の DependencyProperty に対する変更をリッスンするための通知関数を登録します。 (継承元 DependencyObject) |
ReleasePointerCapture(Pointer) |
この UIElement によって 1 つの特定のポインターをキャプチャするためのポインター キャプチャを解放します。 (継承元 UIElement) |
ReleasePointerCaptures() |
この要素によって保持されているすべてのポインター キャプチャを解放します。 (継承元 UIElement) |
RemoveHandler(RoutedEvent, Object) |
指定したルーティング イベント ハンドラーをこの UIElement から削除します。 通常、問題のハンドラーは AddHandler によって追加されました。 (継承元 UIElement) |
SetBinding(DependencyProperty, BindingBase) |
指定されたバインド オブジェクトを使用して、 FrameworkElement にバインドをアタッチします。 (継承元 FrameworkElement) |
SetState(DependencyObject, String) |
指定した DependencyObject の AnimatedIcon.State 添付プロパティの値を指定します。 |
SetValue(DependencyProperty, Object) |
DependencyObject の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject) |
StartAnimation(ICompositionAnimationBase) |
要素で指定したアニメーションを開始します。 (継承元 UIElement) |
StartBringIntoView() |
XAML フレームワークに対する要求を開始し、その中に含まれているスクロール可能な領域内で 要素を表示します。 (継承元 UIElement) |
StartBringIntoView(BringIntoViewOptions) |
指定したオプションを使用して、XAML フレームワークに対する要求を開始して、 要素を表示します。 (継承元 UIElement) |
StartDragAsync(ExpPointerPoint) |
ユーザーの操作とビジュアルの状態の変化に応じてアニメーション化できるビジュアルを表示および制御するアイコンを表します。 (継承元 UIElement) |
StartDragAsync(PointerPoint) |
ドラッグ アンド ドロップ操作を開始します。 重要 管理者として、ユーザーが管理者特権モードでアプリを実行する場合はサポートされません。 |
StopAnimation(ICompositionAnimationBase) |
要素の指定したアニメーションを停止します。 (継承元 UIElement) |
TransformToVisual(UIElement) |
UIElement から指定したオブジェクトに座標を変換するために使用できる変換オブジェクトを返します。 (継承元 UIElement) |
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) |
UIElement のビジュアル ツリー全体でショートカットを検索して、 キーボード ショートカット (またはアクセラレータ) を呼び出そうとします。 (継承元 UIElement) |
UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
RegisterPropertyChangedCallback を呼び出して以前に登録した変更通知を取り消します。 (継承元 DependencyObject) |
UpdateLayout() |
UIElement の子オブジェクトのすべての位置が、レイアウト用に適切に更新されるようにします。 (継承元 UIElement) |
イベント
AccessKeyDisplayDismissed |
アクセス キーが表示されなくなったときに発生します。 (継承元 UIElement) |
AccessKeyDisplayRequested |
ユーザーがアクセス キーの表示を要求したときに発生します。 (継承元 UIElement) |
AccessKeyInvoked |
ユーザーがアクセス キー シーケンスを完了したときに発生します。 (継承元 UIElement) |
ActualThemeChanged |
ActualTheme プロパティの値が変更されたときに発生します。 (継承元 FrameworkElement) |
BringIntoViewRequested |
この要素またはその子孫のいずれかで StartBringIntoView が呼び出されたときに発生します。 (継承元 UIElement) |
CharacterReceived |
1 つの構成済み文字が入力キューによって受信されたときに発生します。 (継承元 UIElement) |
ContextCanceled |
コンテキスト入力ジェスチャが操作ジェスチャに続き、コンテキスト ポップアップを開くべきではないことを要素に通知するときに発生します。 (継承元 UIElement) |
ContextRequested |
ユーザーが右クリックなどのコンテキスト入力ジェスチャを完了したときに発生します。 (継承元 UIElement) |
DataContextChanged |
FrameworkElement.DataContext プロパティの値が変更されたときに発生します。 (継承元 FrameworkElement) |
DoubleTapped |
この要素のヒット テスト領域で、それ以外の方法でハンドルされない DoubleTap 相互作用が発生したときに発生します。 (継承元 UIElement) |
DragEnter |
入力システムが、この要素をターゲットとして使用して基になるドラッグ イベントを報告するときに発生します。 (継承元 UIElement) |
DragLeave |
入力システムが、この要素を原点として基になるドラッグ イベントを報告するときに発生します。 (継承元 UIElement) |
DragOver |
この要素がドロップ先となる可能性のある、基になるドラッグ イベントを入力システムが報告したときに発生します。 (継承元 UIElement) |
DragStarting |
ドラッグ操作が開始されたときに発生します。 (継承元 UIElement) |
Drop |
入力システムがこの要素をドロップ先とするドロップ イベントを報告したときに発生します。 (継承元 UIElement) |
DropCompleted |
ソースとしてこの要素を使用したドラッグ アンド ドロップ操作が終了したときに発生します。 (継承元 UIElement) |
EffectiveViewportChanged |
FrameworkElement の有効なビューポートが変更されたときに発生します。 (継承元 FrameworkElement) |
GettingFocus |
UIElement がフォーカスを受け取る前に発生します。 このイベントは、イベントがバブルしている間にフォーカスが移動されないように同期的に発生します。 (継承元 UIElement) |
GotFocus |
UIElement がフォーカスを受け取ったときに発生します。 このイベントは非同期的に発生するため、バブルが完了する前にフォーカスを再び移動できます。 (継承元 UIElement) |
Holding |
この要素のヒット テスト領域で、それ以外の場合はハンドルされない 保留 操作が発生したときに発生します。 (継承元 UIElement) |
KeyDown |
UIElement にフォーカスがあるときにキーボード キーが押されたときに発生します。 (継承元 UIElement) |
KeyUp |
UIElement にフォーカスがあるときにキーボード キーが解放されたときに発生します。 (継承元 UIElement) |
LayoutUpdated |
レイアウト関連のプロパティが値を変更したり、レイアウトを更新するその他のアクションが原因で、ビジュアル ツリーのレイアウトが変更されたときに発生します。 (継承元 FrameworkElement) |
Loaded |
FrameworkElement が構築され、オブジェクト ツリーに追加され、操作の準備ができたときに発生します。 (継承元 FrameworkElement) |
Loading |
FrameworkElement の読み込みが開始されたときに発生します。 (継承元 FrameworkElement) |
LosingFocus |
UIElement がフォーカスを失う前に発生します。 このイベントは、イベントがバブルしている間にフォーカスが移動されないように同期的に発生します。 (継承元 UIElement) |
LostFocus |
UIElement がフォーカスを失ったときに発生します。 このイベントは非同期的に発生するため、バブルが完了する前にフォーカスを再び移動できます。 (継承元 UIElement) |
ManipulationCompleted |
UIElement の操作が完了したときに発生します。 (継承元 UIElement) |
ManipulationDelta |
操作中に入力デバイスが位置を変更したときに発生します。 (継承元 UIElement) |
ManipulationInertiaStarting |
操作中に入力デバイスが UIElement オブジェクトとのコンタクトを失ったときと慣性が開始したときに発生します。 (継承元 UIElement) |
ManipulationStarted |
入力デバイスが UIElement に対する操作を開始すると発生します。 (継承元 UIElement) |
ManipulationStarting |
操作プロセッサを初めて作成するときに発生します。 (継承元 UIElement) |
NoFocusCandidateFound |
ユーザーが (タブまたは方向矢印を使用して) フォーカスを移動しようとしたときに、フォーカス候補が移動方向に見つからないため、フォーカスが移動しない場合に発生します。 (継承元 UIElement) |
PointerCanceled |
接触したポインターが異常に接触を失ったときに発生します。 (継承元 UIElement) |
PointerCaptureLost |
この要素によって以前に保持されていたポインター キャプチャが別の要素または別の場所に移動したときに発生します。 (継承元 UIElement) |
PointerEntered |
ポインターがこの要素のヒット テスト領域に入ったときに発生します。 (継承元 UIElement) |
PointerExited |
ポインターがこの要素のヒット テスト領域から離れると発生します。 (継承元 UIElement) |
PointerMoved |
ポインターがこの要素のヒット テスト領域内に残っている間にポインターが移動したときに発生します。 (継承元 UIElement) |
PointerPressed |
ポインター デバイスがこの要素内で Press アクションを開始したときに発生します。 (継承元 UIElement) |
PointerReleased |
この要素内で、以前に Press アクションを開始したポインター デバイスが解放されたときに発生します。 Press アクションの終了がイベントを発生 |
PointerWheelChanged |
ポインター ホイールのデルタ値が変更されたときに発生します。 (継承元 UIElement) |
PreviewKeyDown |
UIElement にフォーカスがあるときにキーボード キーが押されたときに発生します。 (継承元 UIElement) |
PreviewKeyUp |
UIElement にフォーカスがあるときにキーボード キーが離されたときに発生します。 (継承元 UIElement) |
ProcessKeyboardAccelerators |
キーボード ショートカット (またはアクセラレータ) が押されたときに発生します。 (継承元 UIElement) |
RightTapped |
ポインターが要素の上にある間に右タップ入力刺激が発生したときに発生します。 (継承元 UIElement) |
SizeChanged |
ActualHeight または ActualWidth プロパティが FrameworkElement の値を変更したときに発生します。 (継承元 FrameworkElement) |
Tapped |
この要素のヒット テスト領域で、それ以外のハンドルされない Tap 操作が発生したときに発生します。 (継承元 UIElement) |
Unloaded |
このオブジェクトがメイン オブジェクト ツリーに接続されなくなったときに発生します。 (継承元 FrameworkElement) |
適用対象
こちらもご覧ください
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示