ListView クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
垂直スタック内のデータ項目を表示するコントロールを表します。
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ListView : ListViewBase[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class ListView : ListViewBasePublic Class ListView
Inherits ListViewBase<ListView .../>
-or-
<ListView ...>
oneOrMoreItems
</ListView>
- 継承
-
Object IInspectable DependencyObject UIElement FrameworkElement Control ItemsControl Selector ListViewBase ListView
- 派生
- 属性
例
ヒント
詳細、設計ガイダンス、およびコード例については、「 リスト ビューとグリッド ビュー」を参照してください。
WinUI 3 ギャラリー アプリには、ほとんどの WinUI 3 コントロールと機能の対話型の例が含まれています。 Microsoft Store からアプリを入手するか、GitHub でソース コードを取得します。
この例では、ListView の ItemTemplate がインラインで定義されています。 ItemsSource が設定されているため、ItemTemplate はすべてのアイテムに適用されます。
<ListView x:Name="itemListView"
Margin="120,0,0,60"
ItemsSource="{Binding Source={StaticResource itemsViewSource}}"
SelectionChanged="ItemListView_SelectionChanged">
<ListView.ItemTemplate>
<DataTemplate>
<Grid Height="110" Margin="6">
<Grid.ColumnDefinitions>
<ColumnDefinition Width="Auto"/>
<ColumnDefinition Width="*"/>
</Grid.ColumnDefinitions>
<Border Background="{StaticResource ListViewItemPlaceholderBackgroundThemeBrush}" Width="110" Height="110">
<Image Source="{Binding Image}" Stretch="UniformToFill"/>
</Border>
<StackPanel Grid.Column="1" VerticalAlignment="Top" Margin="10,0,0,0">
<TextBlock Text="{Binding Title}" Style="{StaticResource TitleTextStyle}" TextWrapping="NoWrap"/>
<TextBlock Text="{Binding Subtitle}" Style="{StaticResource CaptionTextStyle}" TextWrapping="NoWrap"/>
<TextBlock Text="{Binding Description}" Style="{StaticResource BodyTextStyle}" MaxHeight="60"/>
</StackPanel>
</Grid>
</DataTemplate>
</ListView.ItemTemplate>
</ListView>
<ListView>
<ListView.ItemTemplate>
<DataTemplate>
<Grid>
<Border Background="LightGray" Height="200" Width="200">
<TextBlock Text="{Binding}"
FontSize="48" Foreground="Green"/>
</Border>
</Grid>
</DataTemplate>
</ListView.ItemTemplate>
<ListView.Items>
<x:String>One</x:String>
<ListViewItem>Two</ListViewItem>
</ListView.Items>
</ListView>
注釈
ListView を使用して、垂直方向または水平方向に積み重ねられた項目のコレクションを表示します。 行と列にコレクションを表示するには、 GridView を使用します。
ListView は ItemsControl であるため、任意の型の項目のコレクションを含めることができます。 ビューのデータを設定するには、項目を Items コレクションに追加するか、ItemsSource プロパティをデータ ソースに設定します。
既定では、データ項目は、バインドされているデータ オブジェクトの文字列表現として ListView に表示されます。 ListView の項目の表示方法を正確に指定するには、 DataTemplate を作成して、個々の項目の表示に使用されるコントロールのレイアウトを定義します。 レイアウト内のコントロールは、データ オブジェクトのプロパティにバインドすることも、インラインでコンテンツを定義することもできます。 DataTemplate を ListView の ItemTemplate プロパティに割り当てます。 アプリで使用できる一般的なテンプレートについては、「 ListView の項目テンプレート」を参照してください。
注意
ItemsSource プロパティを設定して ListView に値を設定すると、ItemTemplate はすべてのアイテムに適用されます。 Items コレクションに直接データを設定した場合、ItemTemplate は、アイテムが ListViewItem でない場合にのみ適用されます。 詳細については、「例」を参照してください。
ListView を使用して大規模なデータ セットを表示する場合は、「 ListView と GridView の最適化 」を参照して、スムーズで応答性の高いユーザー エクスペリエンスを維持するためのヒントを確認してください。
注意
既定では、選択を実行する代わりに、アクティブなペンでリスト (タッチ、タッチパッド、パッシブ ペンなど) をスクロール/パンします。 アプリでテキストの選択にアクティブなペンを使用する必要がある場合は、ペンのスクロール動作をオーバーライドできます。 詳細については、 ScrollViewer クラス リファレンスの「Pen interaction」セクションを参照してください。
既定では、ユーザーは ListView で 1 つの項目を選択できます。 SelectionMode プロパティを ListViewSelectionMode 列挙値に設定すると、複数選択を許可したり、選択を無効にしたりできます。 また、ListView 操作モードを変更して、項目を選択するのではなく、ボタンのようにクリックするようにユーザーに応答させることもできます。
次の表は、ユーザーが ListView を操作する方法と、操作に応答する方法を示しています。
| 有効にする操作: | 使用する設定: | 処理するイベント: | 選択された項目の取得に使うプロパティ: |
|---|---|---|---|
| 操作なし | SelectionMode = None、IsItemClickEnabled = False | なし | なし |
| 単一選択 | Selectionmode = Single、 IsItemClickEnabled = False | SelectionChanged | SelectedItem、SelectedIndex |
| 連続する複数選択 | Selectionmode = Multiple、 IsItemClickEnabled = False | SelectionChanged | SelectedItems |
| 連続しない複数選択 | Selectionmode = Extended、 IsItemClickEnabled = False | SelectionChanged | SelectedItems |
| クリック | Selectionmode = None、 IsItemClickEnabled = True | ItemClick | 該当なし |
注意
PointerWheelChanged イベントは ListView からバブルアップしません。 つまり、ポインターが ListView の上にある場合、その中に ListView があるコントロールは、マウス ホイール変更メッセージを受け取りません。 たとえば、 ScrollViewer の内部に ListView を配置した場合、ポインターが ListView の上にあるときは、マウス ホイールで ScrollViewer をスクロールすることはできません。
ListView では、大規模なデータ セットを使用してパフォーマンスを向上させるためのデータ仮想化がサポートされています。 ランダム アクセス仮想化は、データ ソースが適切なインターフェイスを実装する場合にサポートされます。これは、プログラミング言語によって異なります。
- Visual C++ コンポーネント拡張機能 (C++/CX) アプリでは 、IObservableVector を実装する必要があります。
- C# または Visual Basic アプリでは 、INotifyCollectionChanged と System.Collections.IList ( IList ではなく) を実装する必要があります。 仮想化には、これらのインターフェイスの両方が必要です。 増分読み込みの仮想化は、データ ソースが ISupportIncrementalLoading インターフェイスを実装する場合に サポートされます。 増分読み込みがサポートされている場合は、これらのメンバーを使用して、 DataFetchSize、 IncrementalLoadingThreshold、 IncrementalLoadingTrigger、 LoadMoreItemsAsync のデータ読み込みを制御できます。
Windows 8 Windows 8では、選択した ListViewItem 内のデータ項目が置き換えられると、SelectedIndex 値はクリアされません。 Windows 8.1 以降では、SelectedIndex 値がクリアされます。
ListView は ISemanticZoomInformation インターフェイスを実装するため、 SemanticZoom コントロールのビューとして使用できます。 SemanticZoom コントロールで使用する場合は、ListView のコントロール テンプレートにある ScrollViewer で、次のように、常に ScrollViewer.IsVerticalScrollChainingEnabled 添付プロパティを false に設定します。<ListView ScrollViewer.IsVerticalScrollChainingEnabled="False"> これらのメンバーは、ListView が SemanticZoom コントロール (IsActiveView、IsZoomedInView、SemanticZoomOwner、CompleteViewChange、CompleteViewChangeFrom、CompleteViewChangeTo、InitializeViewChange、MakeVisible、StartViewChangeFrom、StartViewChangeTo) でホストされている場合にのみ有効です。
スクロール可能ビュー (ScrollViewer など) で UIElement のポインター イベントを処理する必要がある場合は、 UIElement.CancelDirectmanipulation() を呼び出して、ビュー内の要素の操作イベントのサポートを明示的に無効にする必要があります。 ビューで操作イベントを再度有効にするには、 UIElement.TryStartDirectManipulation を呼び出します。
選択動作と CollectionViewSource
Selector から派生したリスト コントロールには、項目ソース (ItemsSource に使用される型) に依存する既定の選択動作があります。 項目ソースが CollectionViewSource インスタンスの場合、選択コントロールの動作は、選択範囲が既定で現在の項目に設定されます。 リストが最初に表示されるとき、選択範囲は既定で現在のアイテムとして最初の項目になります。 この場合、最初の項目を選択しない場合は、ListView で IsSynchronizedWithCurrentItem を false に設定します。
コンストラクター
| ListView() |
ListView クラスの新しいインスタンスを初期化します。 |
プロパティ
| 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) |
| Background |
コントロールの背景を提供するブラシを取得または設定します。 (継承元 Control) |
| BackgroundSizing |
この要素の境界線に対する背景の延長距離を示す値を取得または設定します。 (継承元 Control) |
| BaseUri |
XAML 読み込み時に XAML で構築されたオブジェクトのベース URI を表す URI (Uniform Resource Identifier) を取得します。 このプロパティは、実行時の URI 解決に役立ちます。 (継承元 FrameworkElement) |
| BorderBrush |
コントロールの境界線の塗りつぶしを表すブラシを取得または設定します。 (継承元 Control) |
| BorderThickness |
コントロールの境界線の太さを取得または設定します。 (継承元 Control) |
| CacheMode |
レンダリングされたコンテンツを可能な限り複合ビットマップとしてキャッシュする必要があることを示す値を取得または設定します。 (継承元 UIElement) |
| CanBeScrollAnchor |
UIElement をスクロール アンカーの候補にできるかどうかを示す値を取得または設定します。 (継承元 UIElement) |
| CanDrag |
要素をドラッグ アンド ドロップ操作でデータとしてドラッグできるかどうかを示す値を取得または設定します。 (継承元 UIElement) |
| CanDragItems |
ビュー内の項目をデータ ペイロードとしてドラッグできるかどうかを示す値を取得または設定します。 (継承元 ListViewBase) |
| CanReorderItems |
ユーザー操作によってビュー内のアイテムを並べ替えることができるかどうかを示す値を取得または設定します。 (継承元 ListViewBase) |
| CenterPoint |
要素の中心点 (回転またはスケーリングが発生するポイント) を取得または設定します。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
| CharacterSpacing |
em の 1/1000 単位の文字間の均一な間隔を取得または設定します。 (継承元 Control) |
| Clip |
UIElement の内容のアウトラインを定義するために使用する RectangleGeometry を取得または設定します。 (継承元 UIElement) |
| CompositeMode |
親レイアウトとウィンドウ内の要素の代替合成モードとブレンド モードを宣言するプロパティを取得または設定します。 これは、混合 XAML/Microsoft DirectX UI に関連する要素に関連します。 (継承元 UIElement) |
| ContextFlyout |
この要素に関連付けられているポップアップを取得または設定します。 (継承元 UIElement) |
| CornerRadius |
コントロールの境界線の角の半径を取得または設定します。 (継承元 Control) |
| DataContext |
FrameworkElement のデータ コンテキストを取得または設定します。 データ コンテキストの一般的な用途は、 が {Binding} マークアップ拡張機能を使用し、データ バインディングに参加する場合 |
| DataFetchSize |
仮想化/プリフェッチ操作のためにフェッチするデータの量を取得または設定します。 (継承元 ListViewBase) |
| DefaultStyleKey |
コントロールの既定のスタイルを参照するキーを取得または設定します。 カスタム コントロールの作成者は、このプロパティを使用して、コントロールが使用するスタイルの既定値を変更します。 (継承元 Control) |
| DefaultStyleResourceUri |
コントロールの既定のスタイルを含むリソース ファイルへのパスを取得または設定します。 (継承元 Control) |
| DesiredSize |
レイアウト プロセスのメジャー パス中にこの UIElement が計算したサイズを取得します。 (継承元 UIElement) |
| Dispatcher |
常に Windows アプリ SDK アプリで を返します |
| DispatcherQueue |
このオブジェクトが |
| DisplayMemberPath |
各データ項目に表示されるプロパティの名前またはパスを取得または設定します。 (継承元 ItemsControl) |
| ElementSoundMode |
サウンドを再生するかどうかのコントロールの設定を指定する値を取得または設定します。 (継承元 Control) |
| ExitDisplayModeOnAccessKeyInvoked |
アクセス キーが呼び出されたときにアクセス キーの表示を閉じるかどうかを指定する値を取得または設定します。 (継承元 UIElement) |
| FlowDirection |
レイアウトを制御する任意の親要素内でテキストやその他の UI 要素が流れる方向を取得または設定します。 このプロパティは、 または |
| FocusState |
このコントロールにフォーカスがあるかどうかを示す値と、フォーカスが取得されたモードを取得します。 (継承元 UIElement) |
| FocusVisualMargin |
FrameworkElement のフォーカス ビジュアルの外側の余白を取得または設定します。 (継承元 FrameworkElement) |
| FocusVisualPrimaryBrush |
FrameworkElement の または |
| FocusVisualPrimaryThickness |
FrameworkElement の または フォーカス ビジュアルの外側の境界線の |
| FocusVisualSecondaryBrush |
FrameworkElement の または |
| FocusVisualSecondaryThickness |
FrameworkElement の または フォーカス ビジュアルの内側の境界線の |
| FontFamily |
コントロール内にテキストを表示するために使用されるフォントを取得または設定します。 (継承元 Control) |
| FontSize |
このコントロール内のテキストのサイズを取得または設定します。 (継承元 Control) |
| FontStretch |
画面上でのフォントの縮小率または拡大率を取得または設定します。 (継承元 Control) |
| FontStyle |
テキストをレンダリングするスタイルを取得または設定します。 (継承元 Control) |
| FontWeight |
指定したフォントの太さを取得または設定します。 (継承元 Control) |
| Footer |
リスト フッターの内容を取得または設定します。 (継承元 ListViewBase) |
| FooterTemplate |
ビュー フッターの内容を表示するために使用する DataTemplate を取得または設定します。 (継承元 ListViewBase) |
| FooterTransitions |
ビュー フッターに適用される Transition スタイル要素のコレクションを取得または設定します。 (継承元 ListViewBase) |
| Foreground |
前景色を表すブラシを取得または設定します。 (継承元 Control) |
| GroupStyle |
グループの各レベルの外観を定義する GroupStyle オブジェクトのコレクションを取得します。 (継承元 ItemsControl) |
| GroupStyleSelector |
カスタム GroupStyleSelector ロジック クラスへの参照を取得または設定します。 GroupStyleSelector は、そのコンテンツの特性に基づいて、コンテンツに使用するさまざまな GroupStyle 値を返します。 (継承元 ItemsControl) |
| Header |
リスト ヘッダーの内容を取得または設定します。 (継承元 ListViewBase) |
| HeaderTemplate |
ビュー ヘッダーの内容を表示するために使用する DataTemplate を取得または設定します。 (継承元 ListViewBase) |
| HeaderTransitions |
ビュー ヘッダーに適用される Transition スタイル要素のコレクションを取得または設定します。 (継承元 ListViewBase) |
| Height |
FrameworkElement の推奨される高さを取得または設定します。 (継承元 FrameworkElement) |
| HighContrastAdjustment |
ハイ コントラスト テーマが有効になっている場合に、フレームワークが要素のビジュアル プロパティを自動的に調整するかどうかを示す値を取得または設定します。 (継承元 UIElement) |
| HorizontalAlignment |
パネルや項目コントロールなど、レイアウトの親で構成されている場合に FrameworkElement に適用される水平方向の配置特性を取得または設定します。 (継承元 FrameworkElement) |
| HorizontalContentAlignment |
コントロールのコンテンツの水平方向の配置を取得または設定します。 (継承元 Control) |
| IncrementalLoadingThreshold |
ListViewBase クラスがより多くの項目のプリフェッチを開始するタイミングを制御するしきい値範囲を取得または設定します。 (継承元 ListViewBase) |
| IncrementalLoadingTrigger |
ListViewBase クラスによるプリフェッチ操作の条件を示す値を取得または設定します。 (継承元 ListViewBase) |
| IsAccessKeyScope |
要素が独自のアクセス キー スコープを定義するかどうかを示す値を取得または設定します。 (継承元 UIElement) |
| IsActiveView |
ListViewBase インスタンスが所有する SemanticZoom のアクティブ ビューであるかどうかを示す値を取得または設定します。 (継承元 ListViewBase) |
| IsDoubleTapEnabled |
DoubleTapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
| IsEnabled |
ユーザーがコントロールを操作できるかどうかを示す値を取得または設定します。 (継承元 Control) |
| IsFocusEngaged |
ユーザーがゲーム コントローラーの A/Select ボタンを押したときに、フォーカスがコントロールに制限されているかどうかを示す値を取得または設定します。 (継承元 Control) |
| IsFocusEngagementEnabled |
ユーザーがゲーム コントローラーの [A/Select] ボタンを押したときにフォーカスをコントロールに制限できるかどうかを示す値を取得または設定します。 (継承元 Control) |
| IsGrouping |
コントロールがグループ化を使用しているかどうかを示す値を取得します。 (継承元 ItemsControl) |
| IsHitTestVisible |
この UIElement の包含領域がヒット テストの true 値を返すことができるかどうかを取得または設定します。 (継承元 UIElement) |
| IsHoldingEnabled |
Holding イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
| IsItemClickEnabled |
操作に応答して、ビュー内の項目が ItemClick イベントを発生させるかどうかを示す値を取得または設定します。 (継承元 ListViewBase) |
| IsLoaded |
要素が要素ツリーに追加され、操作の準備ができているかどうかを示す値を取得します。 (継承元 FrameworkElement) |
| IsMultiSelectCheckBoxEnabled |
複数選択を有効にするためにチェック ボックスを表示するかどうかを示す値を取得または設定します。 (継承元 ListViewBase) |
| IsRightTapEnabled |
RightTapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
| IsSwipeEnabled |
ビューがスワイプ操作の個別の入力処理をサポートするかどうかを示す値を取得または設定します。 (継承元 ListViewBase) |
| IsSynchronizedWithCurrentItem |
Selector で SelectedItem を Items プロパティの現在のアイテムと同期させる必要があるかどうかを示す値を取得または設定します。 (継承元 Selector) |
| IsTabStop |
コントロールがタブ ナビゲーションに含まれるかどうかを示す値を取得または設定します。 (継承元 UIElement) |
| IsTapEnabled |
Tapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
| IsTextScaleFactorEnabled |
システム テキスト サイズの設定を反映するように、自動テキストの拡大を有効にするかどうかを取得または設定します。 (継承元 Control) |
| IsZoomedInView |
ListViewBase インスタンスが所有する SemanticZoom のズームイン ビューであるかどうかを示す値を取得または設定します。 (継承元 ListViewBase) |
| ItemContainerGenerator |
この ItemsControl に関連付けられている ItemContainerGenerator を取得します。 (継承元 ItemsControl) |
| ItemContainerStyle |
ItemsControl の項目コンテナーをレンダリングするときに使用するスタイルを取得または設定します。 (継承元 ItemsControl) |
| ItemContainerStyleSelector |
カスタム StyleSelector ロジック クラスへの参照を取得または設定します。 StyleSelector は、表示されるオブジェクトの特性に基づいて、項目コンテナーに使用するさまざまな Style 値を返します。 (継承元 ItemsControl) |
| ItemContainerTransitions |
ItemsControl の項目コンテナーに適用される Transition スタイル要素のコレクションを取得または設定します。 (継承元 ItemsControl) |
| Items |
コントロールの内容を生成するために使用されるコレクションを取得します。 (継承元 ItemsControl) |
| ItemsPanel |
項目のレイアウトを制御するパネルを定義するテンプレートを取得または設定します。 (継承元 ItemsControl) |
| ItemsPanelRoot |
ItemsPanel で指定されたパネルを取得します。 (継承元 ItemsControl) |
| ItemsSource |
ItemsControl のコンテンツの生成に使用するオブジェクト ソースを取得または設定します。 (継承元 ItemsControl) |
| ItemTemplate |
各項目の表示に使用する DataTemplate を取得または設定します。 (継承元 ItemsControl) |
| ItemTemplateSelector |
カスタム DataTemplateSelector ロジック クラスへの参照を取得または設定します。 このプロパティによって参照される DataTemplateSelector は、アイテムに適用するテンプレートを返します。 (継承元 ItemsControl) |
| 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) |
| Name |
オブジェクトの識別名を取得または設定します。 XAML プロセッサが XAML マークアップからオブジェクト ツリーを作成する場合、ランタイム コードはこの名前で XAML で宣言されたオブジェクトを参照できます。 (継承元 FrameworkElement) |
| Opacity |
オブジェクトの不透明度を取得または設定します。 (継承元 UIElement) |
| OpacityTransition |
Opacity プロパティの変更をアニメーション化する ScalarTransition を取得または設定します。 (継承元 UIElement) |
| Padding |
コントロールのパディングを取得または設定します。 (継承元 Control) |
| Parent |
オブジェクト ツリー内のこの FrameworkElement の親オブジェクトを取得します。 (継承元 FrameworkElement) |
| PointerCaptures |
ポインター値として表される、キャプチャされたすべてのポインターのセットを取得 します 。 (継承元 UIElement) |
| Projection |
この要素をレンダリングするときに適用するパースペクティブ プロジェクション (3-D 効果) を取得または設定します。 (継承元 UIElement) |
| ProtectedCursor |
ポインターがこの要素の上にあるときに表示されるカーソルを取得または設定します。 既定値は null で、カーソルに変更がないことを示します。 (継承元 UIElement) |
| RasterizationScale |
各ビュー ピクセルの生 (物理) ピクセルの数を表す値を取得します。 (継承元 UIElement) |
| RenderSize |
UIElement の最終的なレンダリング サイズを取得します。 使用は推奨されません。「備考」を参照してください。 (継承元 UIElement) |
| RenderTransform |
UIElement のレンダリング位置に影響する変換情報を取得または設定します。 (継承元 UIElement) |
| RenderTransformOrigin |
UIElement の境界を基準にして RenderTransform によって宣言された、可能なレンダリング変換の原点を取得または設定します。 (継承元 UIElement) |
| ReorderMode |
ListViewBase インスタンスの並べ替え動作を取得または設定します。 [有効] の場合、並べ替えられていないリストとグループ化されていないリストは、ユーザー操作によって並べ替えることができます。 (継承元 ListViewBase) |
| RequestedTheme |
リソースを決定するために UIElement (およびその子要素) によって使用される UI テーマを取得または設定します。 で指定 |
| RequiresPointer |
UI 要素がマウス モードをサポートするかどうかを取得または設定します。これは、キーボードやゲーム コントローラーなどの非ポインター入力デバイスでのポインター操作エクスペリエンスをエミュレートします。 (継承元 Control) |
| Resources |
ローカルで定義されたリソース ディクショナリを取得します。 XAML では、XAML の暗黙的なコレクション構文を使用して、プロパティ要素の |
| Rotation |
時計回りの回転角度を度単位で取得または設定します。 RotationAxis と CenterPoint を基準にして回転します。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
| RotationAxis |
要素を回転させる軸を取得または設定します。 (継承元 UIElement) |
| RotationTransition |
Rotation プロパティの変更をアニメーション化する ScalarTransition を取得または設定します。 (継承元 UIElement) |
| Scale |
要素のスケールを取得または設定します。 要素の CenterPoint を基準にして拡大縮小します。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
| ScaleTransition |
Scale プロパティの変更をアニメーション化する Vector3Transition を取得または設定します。 (継承元 UIElement) |
| SelectedIndex |
選択した項目のインデックスを取得または設定します。 (継承元 Selector) |
| SelectedItem |
選択されている項目を取得または設定します。 (継承元 Selector) |
| SelectedItems |
現在選択されている項目を取得します。 (継承元 ListViewBase) |
| SelectedRanges |
リスト内で現在選択されている項目を記述する ItemIndexRange オブジェクトのコレクションを取得します。 (継承元 ListViewBase) |
| SelectedValue |
SelectedValuePath を使用して取得した、選択した項目の値を取得または設定します。 (継承元 Selector) |
| SelectedValuePath |
SelectedItem プロパティの SelectedValue プロパティを取得するために使用されるプロパティ パスを取得または設定します。 (継承元 Selector) |
| SelectionMode |
ListViewBase インスタンスの選択動作を取得または設定します。 (継承元 ListViewBase) |
| SemanticZoomOwner |
ListViewBase をホストする SemanticZoom インスタンスを取得または設定します。 (継承元 ListViewBase) |
| Shadow |
要素によってキャストされる影効果を取得または設定します。 (継承元 UIElement) |
| ShowsScrollingPlaceholders |
スクロール中にアイテムのプレースホルダー UI がビューに表示されるかどうかを示す値を取得または設定します。 (継承元 ListViewBase) |
| SingleSelectionFollowsFocus |
キーボード フォーカスが変更されたときに項目の選択が変更されるかどうかを示す値を取得または設定します。 (継承元 ListViewBase) |
| Style |
レイアウトとレンダリング中にこのオブジェクトに適用されるインスタンス Style を取得または設定します。 (継承元 FrameworkElement) |
| TabFocusNavigation |
このコントロールのタブと TabIndex の動作方法を変更する値を取得または設定します。 (継承元 UIElement) |
| TabIndex |
ユーザーが Tab キーを使用してコントロール内を移動するときに要素がフォーカスを受け取る順序を決定する値を取得または設定します。 (継承元 UIElement) |
| TabNavigation |
このコントロールのタブと UIElement.TabIndex の動作方法を変更する値を取得または設定します。 注意 Windows 10 Creators Update (ビルド 10.0.15063) 以降では、UiElement 基本クラスで TabFocusNavigation プロパティを使用して、ControlTemplate を使用しないオブジェクトをタブ シーケンスに含めることができます。 |
| Tag |
このオブジェクトに関するカスタム情報を格納するために使用できる任意のオブジェクト値を取得または設定します。 (継承元 FrameworkElement) |
| Template |
コントロール テンプレートを取得または設定します。 コントロール テンプレートは、UI でのコントロールの視覚的な外観を定義し、XAML マークアップで定義されています。 (継承元 Control) |
| 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) |
| VerticalContentAlignment |
コントロールのコンテンツの垂直方向の配置を取得または設定します。 (継承元 Control) |
| 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) |
メソッド
イベント
| AccessKeyDisplayDismissed |
アクセス キーが表示されなくなったときに発生します。 (継承元 UIElement) |
| AccessKeyDisplayRequested |
ユーザーがアクセス キーの表示を要求したときに発生します。 (継承元 UIElement) |
| AccessKeyInvoked |
ユーザーがアクセス キー シーケンスを完了したときに発生します。 (継承元 UIElement) |
| ActualThemeChanged |
ActualTheme プロパティの値が変更されたときに発生します。 (継承元 FrameworkElement) |
| BringIntoViewRequested |
この要素またはその子孫のいずれかで StartBringIntoView が呼び出されたときに発生します。 (継承元 UIElement) |
| CharacterReceived |
1 つの構成済み文字が入力キューによって受信されたときに発生します。 (継承元 UIElement) |
| ChoosingGroupHeaderContainer |
項目コンテナーがデータ グループに対して選択されるときに発生します。 (継承元 ListViewBase) |
| ChoosingItemContainer |
データ項目に対して項目コンテナーを選択するときに発生します。 (継承元 ListViewBase) |
| ContainerContentChanging |
UI コンテナーに関連付けられているデータ項目が変更されたときに発生します。 (継承元 ListViewBase) |
| ContextCanceled |
コンテキスト入力ジェスチャが操作ジェスチャに続き、コンテキスト ポップアップを開くべきではないことを要素に通知するときに発生します。 (継承元 UIElement) |
| ContextRequested |
ユーザーが右クリックなどのコンテキスト入力ジェスチャを完了したときに発生します。 (継承元 UIElement) |
| DataContextChanged |
FrameworkElement.DataContext プロパティの値が変更されたときに発生します。 (継承元 FrameworkElement) |
| DoubleTapped |
この要素のヒット テスト領域で、それ以外の方法でハンドルされない DoubleTap 相互作用が発生したときに発生します。 (継承元 UIElement) |
| DragEnter |
入力システムが、この要素をターゲットとして使用して基になるドラッグ イベントを報告するときに発生します。 (継承元 UIElement) |
| DragItemsCompleted |
ビュー内のいずれかの項目を含むドラッグ操作が終了したときに発生します。 (継承元 ListViewBase) |
| DragItemsStarting |
ビュー内のいずれかの項目を含むドラッグ操作が開始されたときに発生します。 (継承元 ListViewBase) |
| DragLeave |
入力システムが、この要素を原点として基になるドラッグ イベントを報告するときに発生します。 (継承元 UIElement) |
| DragOver |
この要素がドロップ先となる可能性のある、基になるドラッグ イベントを入力システムが報告したときに発生します。 (継承元 UIElement) |
| DragStarting |
ドラッグ操作が開始されたときに発生します。 (継承元 UIElement) |
| Drop |
入力システムがこの要素をドロップ先とするドロップ イベントを報告したときに発生します。 (継承元 UIElement) |
| DropCompleted |
ソースとしてこの要素を使用したドラッグ アンド ドロップ操作が終了したときに発生します。 (継承元 UIElement) |
| EffectiveViewportChanged |
FrameworkElement の有効なビューポートが変更されたときに発生します。 (継承元 FrameworkElement) |
| FocusDisengaged |
ユーザーがゲーム コントローラーの B/Back ボタンを押すと、コントロールからフォーカスが離されると発生します。 (継承元 Control) |
| FocusEngaged |
ユーザーがゲーム コントローラーの A/Select ボタンを押すと、フォーカスがコントロールに制限されるときに発生します。 (継承元 Control) |
| GettingFocus |
UIElement がフォーカスを受け取る前に発生します。 このイベントは、イベントがバブルしている間にフォーカスが移動されないように同期的に発生します。 (継承元 UIElement) |
| GotFocus |
UIElement がフォーカスを受け取ったときに発生します。 このイベントは非同期的に発生するため、バブルが完了する前にフォーカスを再び移動できます。 (継承元 UIElement) |
| Holding |
この要素のヒット テスト領域で、それ以外の場合はハンドルされない 保留 操作が発生したときに発生します。 (継承元 UIElement) |
| IsEnabledChanged |
IsEnabled プロパティが変更されたときに発生します。 (継承元 Control) |
| ItemClick |
リスト ビュー内のアイテムが相互作用を受け取り、 IsItemClickEnabled プロパティが true の場合に発生します。 (継承元 ListViewBase) |
| 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) |
| SelectionChanged |
現在選択されている項目が変更されたときに発生します。 (継承元 Selector) |
| SizeChanged |
ActualHeight または ActualWidth プロパティが FrameworkElement の値を変更したときに発生します。 (継承元 FrameworkElement) |
| Tapped |
この要素のヒット テスト領域で、それ以外のハンドルされない Tap 操作が発生したときに発生します。 (継承元 UIElement) |
| Unloaded |
このオブジェクトがメイン オブジェクト ツリーに接続されなくなったときに発生します。 (継承元 FrameworkElement) |
適用対象
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示