GridView クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
行と列のデータ項目を表示するコントロールを表します。
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class GridView : ListViewBase
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class GridView : ListViewBase
Public Class GridView
Inherits ListViewBase
<GridView .../>
-or-
<GridView ...>
oneOrMoreItems
</GridView>
- 継承
-
Object IInspectable DependencyObject UIElement FrameworkElement Control ItemsControl Selector ListViewBase GridView
- 属性
Windows の要件
デバイス ファミリ |
Windows 10 (10.0.10240.0 で導入)
|
API contract |
Windows.Foundation.UniversalApiContract (v1.0 で導入)
|
例
ヒント
詳細、設計ガイダンス、およびコード例については、「 グリッド ビュー」を参照してください。
WinUI 2 ギャラリー アプリには、ほとんどの WinUI 2 コントロールと機能の対話型の例が含まれています。 Microsoft Store からアプリを入手するか、GitHub でソース コードを取得します。
ここでは、GridView は という名前cvsProjects
のグループ化された CollectionViewSource にバインドされます。 各グループ内の個々の項目の外観は、 ItemTemplate によって定義されます。
ItemsPanel は、GridView でのグループの配置方法を指定します。
GroupStyle.Panel は、各グループ内での個々の項目の配置方法を指定します。
GroupStyle.ContainerStyle を使用して、各グループの周囲に罫線を追加し、その最小サイズと余白を設定します。
空のグループを非表示にするには、HidesIfEmpty プロパティを true に設定します。
<Page
x:Class="GroupedGridViewApp.MainPage"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:GroupedGridViewApp"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d"
Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
<Page.Resources>
<CollectionViewSource x:Name="cvsProjects" IsSourceGrouped="True"
ItemsPath="Activities"/>
</Page.Resources>
<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
<GridView ItemsSource="{Binding Source={StaticResource cvsProjects}}" MaxHeight="500">
<GridView.ItemTemplate>
<DataTemplate>
<StackPanel Margin="20">
<TextBlock Text="{Binding Name}" FontWeight="Bold"
Style="{StaticResource BaseTextBlockStyle}"/>
<TextBlock Text="{Binding DueDate}" TextWrapping="NoWrap"
Style="{StaticResource BodyTextBlockStyle}" />
<CheckBox Content="Complete" IsChecked="{Binding Complete}"
IsEnabled="False"/>
</StackPanel>
</DataTemplate>
</GridView.ItemTemplate>
<GridView.ItemsPanel>
<ItemsPanelTemplate>
<ItemsWrapGrid MaximumRowsOrColumns="3"/>
</ItemsPanelTemplate>
</GridView.ItemsPanel>
<GridView.GroupStyle>
<GroupStyle HidesIfEmpty="True">
<GroupStyle.HeaderTemplate>
<DataTemplate>
<Grid Background="LightGray" Margin="0">
<TextBlock Text='{Binding Name}'
Foreground="Black" Margin="12"
Style="{StaticResource HeaderTextBlockStyle}"/>
</Grid>
</DataTemplate>
</GroupStyle.HeaderTemplate>
</GroupStyle>
</GridView.GroupStyle>
</GridView>
</Grid>
</Page>
using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using Windows.UI.Xaml.Controls;
namespace GroupedGridViewApp
{
public sealed partial class MainPage : Page
{
DateTime startDate = DateTime.Now;
public MainPage()
{
this.InitializeComponent();
PopulateProjects();
}
private void PopulateProjects()
{
List<Project> Projects = new List<Project>();
Project newProject = new Project();
newProject.Name = "Project 1";
newProject.Activities.Add(new Activity()
{ Name = "Activity 1", Complete = true, DueDate = startDate.AddDays(4) });
newProject.Activities.Add(new Activity()
{ Name = "Activity 2", Complete = true, DueDate = startDate.AddDays(5) });
Projects.Add(newProject);
newProject = new Project();
newProject.Name = "Project 2";
newProject.Activities.Add(new Activity()
{ Name = "Activity A", Complete = true, DueDate = startDate.AddDays(2) });
newProject.Activities.Add(new Activity()
{ Name = "Activity B", Complete = false, DueDate = startDate.AddDays(3) });
Projects.Add(newProject);
newProject = new Project();
newProject.Name = "Project 3";
Projects.Add(newProject);
cvsProjects.Source = Projects;
}
}
public class Project
{
public Project()
{
Activities = new ObservableCollection<Activity>();
}
public string Name { get; set; }
public ObservableCollection<Activity> Activities { get; private set; }
}
public class Activity
{
public string Name { get; set; }
public DateTime DueDate { get; set; }
public bool Complete { get; set; }
public string Project { get; set; }
}
}
次の例では、アプリ全体のすべての GridView の項目の角は 5px に丸められます。
<Application.Resources>
<CornerRadius x:Key="GridViewItemCornerRadius">5</CornerRadius>
</Application.Resources>
注釈
ヒント
詳細、設計ガイダンス、およびコード例については、「 リスト ビューとグリッド ビュー」を参照してください。
GridView を使用して、垂直方向にスクロールできる行と列の項目のコレクションを表示します。 データはまず横方向に並べられ、すべての列にデータが入ると、次の行に折り返して並べられます。 フォト ギャラリーのように、各項目の表示内容が豊富で表示領域を広く使う必要がある場合によく使います。
GridView は ItemsControl であるため、任意の型の項目のコレクションを含めることができます。 ビューのデータを設定するには、項目を Items コレクションに追加するか、ItemsSource プロパティをデータ ソースに設定します。
既定では、データ項目は、バインドされているデータ オブジェクトの文字列表現として GridView に表示されます。 GridView の項目の表示方法を正確に指定するには、 DataTemplate を作成して、個々のアイテムの表示に使用されるコントロールのレイアウトを定義します。 レイアウト内のコントロールは、データ オブジェクトのプロパティにバインドすることも、インラインでコンテンツを定義することもできます。 DataTemplate を GridView の ItemTemplate プロパティに割り当てます。 アプリで使用できる一般的なテンプレートについては、「 GridView の項目テンプレート」を参照してください。
ItemsSource プロパティを設定して GridView を設定すると、ItemTemplate はすべてのアイテムに適用されます。 Items コレクションに直接データを設定すると、ItemTemplate は、項目が GridViewItem でない場合にのみ適用されます。 この例では、テンプレートは最初の項目に適用されますが、2 番目の項目には適用されません。
<GridView>
<GridView.ItemTemplate>
<DataTemplate>
<Grid>
<Border Background="LightGray" Height="200" Width="200">
<TextBlock Text="{Binding}"
FontSize="48" Foreground="Green"/>
</Border>
</Grid>
</DataTemplate>
</GridView.ItemTemplate>
<GridView.Items>
<x:String>One</x:String>
<GridViewItem>Two</GridViewItem>
</GridView.Items>
</GridView>
GridView を使用して大規模なデータ セットを表示する場合は、「 ListView と GridView の最適化 」を参照して、スムーズで応答性の高いユーザー エクスペリエンスを維持するためのヒントを確認してください。
Windows 10バージョン 1709 (SDK 16299) - 動作の変更既定では、UWP アプリでは、アクティブ ペンは、選択の実行ではなく、リストのスクロール/パン (タッチ、タッチパッド、パッシブ ペンなどと同様に) をするようになりました。 アプリが以前の動作に依存している場合は、ペン スクロールを上書きして、以前の動作に戻すことができます。 参照先
既定では、ユーザーは GridView で 1 つの項目を選択できます。 SelectionMode プロパティを ListViewSelectionMode 列挙値に設定すると、複数選択を許可したり、選択を無効にしたりできます。 また、GridView 操作モードを変更して、項目が選択されるのではなく、ボタンのようにユーザークリックに応答するようにすることもできます。
次の表は、ユーザーが GridView と対話する方法と、その操作に応答する方法を示しています。
有効にする操作: | 使用する設定: | 処理するイベント: | 選択された項目の取得に使うプロパティ: |
---|---|---|---|
操作なし | 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 イベントは GridView からバブルアップしません。 つまり、その中に GridView があるコントロールは、ポインターが GridView の上にある場合、マウス ホイール変更メッセージを受け取りません。 たとえば、GridView を ScrollViewer の内部に配置した場合、ポインターが GridView の上にあるときは、マウス ホイールで ScrollViewer をスクロールすることはできません。
注意
GridView コントロールに Padding プロパティを設定すると、 右 パディングの値は無視されます。左、上、下のパディングの値のみが適用されます。
GridView では、大規模なデータ セットを使用してパフォーマンスを向上させるためのデータ仮想化がサポートされています。 ランダム アクセス仮想化は、データ ソースが適切なインターフェイスを実装する場合にサポートされます。これは、プログラミング言語によって異なります。
- Visual C++ コンポーネント拡張機能 (C++/CX) アプリでは 、IObservableVector を実装する必要があります。
- C# または Visual Basic アプリでは 、INotifyCollectionChanged と System.Collections.IList ( IList<T> ではなく) を実装する必要があります。 仮想化には、これらのインターフェイスの両方が必要です。 増分読み込みの仮想化は、データ ソースが ISupportIncrementalLoading インターフェイスを実装する場合に サポートされます。 増分読み込みがサポートされている場合は、 DataFetchSize、 IncrementalLoadingThreshold、 IncrementalLoadingTrigger、 LoadMoreItemsAsync の各メンバーを使用してデータ読み込みを制御できます。
Windows 8 Windows 8では、選択した GridViewItem 内のデータ項目が置き換えられると、SelectedIndex 値はクリアされません。 Windows 8.1 以降では、SelectedIndex 値がクリアされます。
GridView は ISemanticZoomInformation インターフェイスを実装しているため、 SemanticZoom コントロールのビューとして使用できます。
SemanticZoom コントロールで使用する場合は、GridView のコントロール テンプレートにある ScrollViewer で、ScrollViewer.IsHorizontalScrollChainingEnabled 添付プロパティを false に常に設定します。 <GridView ScrollViewer.IsHorizontalScrollChainingEnabled="False">
これらのメンバーは、GridView が SemanticZoom コントロールでホストされている場合にのみ有効です。IsActiveView、IsZoomedInView、SemanticZoomOwner、CompleteViewChange、CompleteViewChangeFrom、CompleteViewChangeTo、InitializeViewChange、MakeVisible、StartViewChangeFrom、StartViewChangeTo。
GridView の既定のテンプレートには、既存の切り替えアニメーションが含まれています。 具体的には、既定の ItemContainerTransitions 値には、 AddDeleteThemeTransition、 ContentThemeTransition、 ReorderThemeTransition 、 および EntranceThemeTransition (と) IsStaggeringEnabled="False"
の値が既に含まれています。 GridView で ItemContainerTransitions に新しい値を設定する場合は、これらの同じテーマ アニメーションを開始点として再現することを検討してください。 プロパティを自分で設定している場合、定義に再び含めない限り、これらの既定値は上書きされます。
スクロール可能ビュー (ScrollViewer など) で UIElement のポインター イベントを処理する必要がある場合は、 UIElement.CancelDirectmanipulation() を呼び出して、ビュー内の要素に対する操作イベントのサポートを明示的に無効にする必要があります。 ビューで操作イベントを再び有効にするには、UIElement.TryStartDirectManipulation() を呼び出します。
選択動作と CollectionViewSource
Selector から派生したリスト コントロールには、アイテム ソース (ItemsSource に使用される型) に依存する既定の選択動作があります。 アイテム ソースが CollectionViewSource インスタンスの場合、選択コントロールの動作は、選択範囲が既定で現在のアイテムに設定されます。 リストが最初に表示されると、選択範囲は既定で現在のアイテムとして最初の項目に設定されます。 この場合、最初の項目を選択しない場合は、GridView で IsSynchronizedWithCurrentItem を false に設定 します 。
WinUI 2.6 でのビジュアル更新
WinUI 2.6 では、GridView のビジュアルとデザインを更新するために、新しい API とスタイルが追加されました。 これらの更新されたビジュアルには、丸い角、改善された罫線、複数選択モードの丸められたチェックボックスなどがあります。
これらの新しいスタイルを使用する場合は、まずアプリで WinUI 2.6 を使用していることを確認します。 WinUI 2 をセットアップするには、「 Windows UI 2.x ライブラリの概要」を参照してください。
アプリで Xaml リソースを指定することで、常に GridView の外観を変更できます。 WinUI 2.6 で使用できる新しいリソースは です GridViewItemCornerRadius
。これは、GridViewItem コーナーでの丸めのレベルを制御します。 既定では、このテーマ リソースは 4px に設定されています。
コンストラクター
GridView() |
GridView クラスの新しいインスタンスを初期化します。 |
プロパティ
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 で構築されたオブジェクトのベースの Uniform Resource Identifier (URI) を表す Uniform Resource Identifier (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 のデータ コンテキストを取得または設定します。 データ コンテキストの一般的な用途は、 FrameworkElement が {Binding} マークアップ拡張機能を使用し、データ バインディングに参加する場合です。 (継承元 FrameworkElement) |
DataFetchSize |
仮想化/プリフェッチ操作のためにフェッチするデータの量を取得または設定します。 (継承元 ListViewBase) |
DefaultStyleKey |
コントロールの既定のスタイルを参照するキーを取得または設定します。 カスタム コントロールの作成者は、このプロパティを使用して、コントロールが使用するスタイルの既定値を変更します。 (継承元 Control) |
DefaultStyleResourceUri |
コントロールの既定のスタイルを含むリソース ファイルへのパスを取得または設定します。 (継承元 Control) |
DesiredSize |
レイアウト プロセスのメジャー パス中にこの UIElement が計算したサイズを取得します。 (継承元 UIElement) |
Dispatcher |
このオブジェクトが関連付けられている CoreDispatcher を取得します。 CoreDispatcher は、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の DependencyObject にアクセスできる機能を表します。 (継承元 DependencyObject) |
DisplayMemberPath |
各データ項目に表示されるプロパティの名前またはパスを取得または設定します。 (継承元 ItemsControl) |
ElementSoundMode |
サウンドを再生するかどうかのコントロールの設定を指定する値を取得または設定します。 (継承元 Control) |
ExitDisplayModeOnAccessKeyInvoked |
アクセス キーが呼び出されたときにアクセス キーの表示を閉じるかどうかを示す値を取得または設定します。 (継承元 UIElement) |
FlowDirection |
レイアウトを制御する任意の親要素内でテキストやその他の UI 要素が流れる方向を取得または設定します。 このプロパティは、 LeftToRight または RightToLeft に設定できます。 任意の要素で FlowDirection を RightToLeft に設定すると、配置が右に設定され、読み取り順序が右から左に設定され、コントロールのレイアウトが右から左に流れるようになります。 (継承元 FrameworkElement) |
FocusState |
このコントロールにフォーカスがあるかどうかを示す値と、フォーカスが取得されたモードを取得します。 (継承元 Control) |
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 |
コントロールの境界内でフォーカスが制限されているかどうかを示す値を取得または設定します (ゲーム パッド/リモート操作の場合)。 (継承元 Control) |
IsFocusEngagementEnabled |
コントロール境界内でフォーカスを制限できるかどうかを示す値を取得または設定します (ゲーム パッド/リモート操作の場合)。 (継承元 Control) |
IsGrouping |
コントロールがグループ化を使用しているかどうかを示す値を取得します。 (継承元 ItemsControl) |
IsHitTestVisible |
この UIElement の包含領域がヒット テストの true 値を返すことができるかどうかを取得または設定します。 (継承元 UIElement) |
IsHoldingEnabled |
Holding イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
IsItemClickEnabled |
ビュー内の項目が相互作用に応答して ItemClick イベントを発生させるかどうかを示す値を取得または設定します。 (継承元 ListViewBase) |
IsLoaded |
要素が要素ツリーに追加され、操作の準備ができているかどうかを示す値を取得します。 (継承元 FrameworkElement) |
IsMultiSelectCheckBoxEnabled |
複数選択を有効にするためにチェック ボックスを表示するかどうかを示す値を取得または設定します。 (継承元 ListViewBase) |
IsRightTapEnabled |
RightTapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
IsSwipeEnabled |
スワイプ操作でビューが個別の入力処理をサポートするかどうかを示す値を取得または設定します。 (継承元 ListViewBase) |
IsSynchronizedWithCurrentItem |
セレクターで SelectedItem を Items プロパティの現在のアイテムと同期させる必要があるかどうかを示す値を取得または設定します。 (継承元 Selector) |
IsTabStop |
コントロールがタブ ナビゲーションに含まれるかどうかを示す値を取得または設定します。 (継承元 Control) |
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 |
Pointer 値として表されるすべてのキャプチャされたポインターのセット を取得します 。 (継承元 UIElement) |
Projection |
この要素をレンダリングするときに適用するパースペクティブ プロジェクション (3-D 効果) を取得または設定します。 (継承元 UIElement) |
RenderSize |
UIElement の最終的なレンダリング サイズを取得します。 使用は推奨されません。「解説」を参照してください。 (継承元 UIElement) |
RenderTransform |
UIElement のレンダリング位置に影響する変換情報を取得または設定します。 (継承元 UIElement) |
RenderTransformOrigin |
UIElement の境界を基準にして、RenderTransform によって宣言された可能なレンダー変換の原点を取得または設定します。 (継承元 UIElement) |
ReorderMode |
ListViewBase インスタンスの並べ替え動作を取得または設定します。 [有効] の場合、並べ替えされていないリストとグループ化されていないリストは、ユーザー操作によって並べ替えることができます。 (継承元 ListViewBase) |
RequestedTheme |
リソースの決定に UIElement (およびその子要素) によって使用される UI テーマを取得または設定します。 RequestedTheme で指定した UI テーマは、アプリ レベルの RequestedTheme をオーバーライドできます。 (継承元 FrameworkElement) |
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 キーを使用してアプリ UI を移動したときに要素がフォーカスを受け取る順序を示す値を取得または設定します。 (継承元 Control) |
TabNavigation |
このコントロールのタブと 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) |
UIContext |
要素のコンテキスト識別子を取得します。 (継承元 UIElement) |
UseLayoutRounding |
オブジェクトとそのビジュアル サブツリーのレンダリングで、レンダリングをピクセル全体に合わせた丸め動作を使用するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
UseSystemFocusVisuals |
システムによって描画されるフォーカス ビジュアルをコントロールで使用するか、コントロール テンプレートで定義されたビジュアルを使用するかを示す値を取得または設定します。 (継承元 Control) |
VerticalAlignment |
パネルや項目コントロールなどの親オブジェクトで構成されている場合に FrameworkElement に適用される垂直方向の配置特性を取得または設定します。 (継承元 FrameworkElement) |
VerticalContentAlignment |
コントロールのコンテンツの垂直方向の配置を取得または設定します。 (継承元 Control) |
Visibility |
UIElement の可視性を取得または設定します。 表示されない UIElement はレンダリングされず、目的のサイズをレイアウトに伝達しません。 (継承元 UIElement) |
Width |
FrameworkElement の幅を取得または設定します。 (継承元 FrameworkElement) |
XamlRoot |
この要素が表示される を |
XYFocusDown |
ユーザーが方向パッド (D パッド) を押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 Control) |
XYFocusDownNavigationStrategy |
ダウン ナビゲーションのターゲット要素を決定するために使用する戦略を指定する値を取得または設定します。 (継承元 UIElement) |
XYFocusKeyboardNavigation |
キーボード方向矢印を使用してナビゲーションを有効または無効にする値を取得または設定します。 (継承元 UIElement) |
XYFocusLeft |
ユーザーが方向パッド (D パッド) を左に押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 Control) |
XYFocusLeftNavigationStrategy |
左側のナビゲーションのターゲット要素を決定するために使用される戦略を指定する値を取得または設定します。 (継承元 UIElement) |
XYFocusRight |
ユーザーが方向パッド (D パッド) を右に押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 Control) |
XYFocusRightNavigationStrategy |
右ナビゲーションのターゲット要素を決定するために使用される戦略を指定する値を取得または設定します。 (継承元 UIElement) |
XYFocusUp |
ユーザーが方向パッド (D パッド) を上に押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 Control) |
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 |
ビュー内の項目の 1 つを含むドラッグ操作が終了したときに発生します。 (継承元 ListViewBase) |
DragItemsStarting |
ビュー内のいずれかの項目を含むドラッグ操作が開始されたときに発生します。 (継承元 ListViewBase) |
DragLeave |
入力システムが、この要素を原点として基になるドラッグ イベントを報告するときに発生します。 (継承元 UIElement) |
DragOver |
この要素がドロップ先となる可能性のある、基になるドラッグ イベントを入力システムが報告したときに発生します。 (継承元 UIElement) |
DragStarting |
ドラッグ操作が開始されたときに発生します。 (継承元 UIElement) |
Drop |
入力システムがこの要素をドロップ先とするドロップ イベントを報告したときに発生します。 (継承元 UIElement) |
DropCompleted |
ソースが終了したときに、この要素を使用したドラッグ アンド ドロップ操作が発生します。 (継承元 UIElement) |
EffectiveViewportChanged |
FrameworkElement の有効なビューポートが変更されたときに発生します。 (継承元 FrameworkElement) |
FocusDisengaged |
コントロールの境界からフォーカスが離されると発生します (ゲーム パッド/リモート操作の場合)。 (継承元 Control) |
FocusEngaged |
コントロールの境界内でフォーカスが制限されている場合に発生します (ゲーム パッド/リモート操作の場合)。 (継承元 Control) |
GettingFocus |
UIElement がフォーカスを受け取る前に発生します。 このイベントは、イベントがバブルしている間にフォーカスが移動されないように同期的に発生します。 (継承元 UIElement) |
GotFocus |
UIElement がフォーカスを受け取ったときに発生します。 このイベントは非同期的に発生するため、バブルが完了する前にフォーカスを再び移動できます。 (継承元 UIElement) |
Holding |
この要素のヒット テスト領域で、それ以外のハンドルされない Hold 操作が発生したときに発生します。 (継承元 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 アクションの終了が PointerReleased イベントを発生させる保証はされないことに注意してください。他のイベントが発生する可能性があります。 詳細については、「解説」を参照してください。 (継承元 UIElement) |
PointerWheelChanged |
ポインター ホイールのデルタ値が変更されたときに発生します。 (継承元 UIElement) |
PreviewKeyDown |
UIElement にフォーカスがあるときにキーボード キーが押されたときに発生します。 (継承元 UIElement) |
PreviewKeyUp |
UIElement にフォーカスがあるときにキーボード キーが解放されたときに発生します。 (継承元 UIElement) |
ProcessKeyboardAccelerators |
キーボード ショートカット (またはアクセラレータ) が押されたときに発生します。 (継承元 UIElement) |
RightTapped |
ポインターが 要素の上にある間に右タップ入力刺激が発生したときに発生します。 (継承元 UIElement) |
SelectionChanged |
現在選択されている項目が変更されたときに発生します。 (継承元 Selector) |
SizeChanged |
ActualHeight プロパティまたは ActualWidth プロパティが FrameworkElement の値を変更したときに発生します。 (継承元 FrameworkElement) |
Tapped |
この要素のヒット テスト領域で、それ以外の場合はハンドルされない Tap 操作が発生したときに発生します。 (継承元 UIElement) |
Unloaded |
このオブジェクトがメイン オブジェクト ツリーに接続されなくなったときに発生します。 (継承元 FrameworkElement) |