ItemsControl.ItemsPanel Properti

Definisi

Ruang nama:

Windows.UI.Xaml.Controls

Mendapatkan atau mengatur templat yang menentukan panel yang mengontrol tata letak item.

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"/>

Nilai Properti

ItemsPanelTemplate

ItemsPanelTemplate yang menentukan panel yang akan digunakan untuk tata letak item. Nilai default untuk ItemsControl adalah ItemsPanelTemplate yang menentukan StackPanel.

Subjenis ItemControl dapat menggunakan ItemPanelTemplates default yang berbeda. Misalnya, ListViewsecara default menggunakan ItemsStackPanel. Menggunakan jenis yang berbeda dapat menyebabkan perilaku yang tidak terduga; misalnya menggunakan StackPanel biasa karena ItemPanel ListView dapat mengubah perilaku Narator selama seret dan letakkan.

Contoh

Ganti panel default yang digunakan dalam ListView dengan ItemsStackPanel yang Orientasinya berubah menjadi Horizontal.

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

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

Keterangan

Catatan

ComboBox menggunakan CarouselPanel sebagai ItemsPanel-nya. Menggunakan panel yang berbeda karena ItemsPanel comboBox tidak didukung dan dapat mengakibatkan perilaku yang tidak diinginkan.