ItemsControl.ItemsPanel プロパティ

定義

項目のレイアウトを制御するパネルを定義するテンプレートを取得または設定します。

public:
 property ItemsPanelTemplate ^ ItemsPanel { ItemsPanelTemplate ^ get(); void set(ItemsPanelTemplate ^ value); };
ItemsPanelTemplate ItemsPanel();

void ItemsPanel(ItemsPanelTemplate value);
public ItemsPanelTemplate ItemsPanel { get; set; }
var itemsPanelTemplate = itemsControl.itemsPanel;
itemsControl.itemsPanel = itemsPanelTemplate;
Public Property ItemsPanel As ItemsPanelTemplate
<itemsControl>
  <itemsControl.ItemsPanel>
    singlePanelTemplate
  </itemsControl.ItemsPanel>
</itemsControl>
- or -
<itemsControl ItemsPanel="resourceReferenceToPanelTemplate"/>

プロパティ値

項目のレイアウトに使用するパネルを定義する ItemsPanelTemplateItemsControl の既定値は、StackPanel を指定する ItemsPanelTemplateです

ItemsControl のサブタイプでは、異なる既定の ItemsPanelTemplates を使用できます。 たとえば、 ListViewは既定で ItemsStackPanel を使用します。 別の型を使用すると、予期しない動作が発生する可能性があります。たとえば、ListView の ItemsPanel としてプレーンな StackPanel を使用すると、ドラッグ アンド ドロップ中にナレーターの動作を低下させることができます。

ListView で使用される既定のパネルを、Orientation が Horizontal に変更された ItemsStackPanel に置き換えます。

<ListView>
    <x:String>Hello</x:String>
    <x:String>World</x:String>

    <ItemsControl.ItemsPanel>
        <ItemsPanelTemplate>
            <ItemsStackPanel Orientation="Horizontal" />
        </ItemsPanelTemplate>
    </ItemsControl.ItemsPanel>
</ListView>

注釈

注意

ComboBox では、 ItemsPanel として CarouselPanel が使用されます。 ComboBox の ItemsPanel として別のパネルを使用することはサポートされていないため、望ましくない動作が発生する可能性があります。

適用対象