Tuval uygulamaları galeri denetimindeGallery control in canvas apps

Başka denetimleri kapsayan ve veri kümesi gösteren bir denetimdir.A control that contains other controls and shows a set of data.

AçıklamaDescription

Galeri denetimleri, bir veri kaynağındaki birden çok kaydı gösterebilir ve her bir kayıt, birden çok veri türü içerebilir.A Gallery control can show multiple records from a data source, and each record can contain multiple types of data. Örneğin; bir Galeri denetiminde, her bir kişinin adının, adresinin ve telefon numarasının bulunduğu iletişim bilgilerini gösteren ayrı ayrı öğeler kullanılarak birden çok kişi gösterilebilir.For example, a Gallery control can show multiple contacts with each item showing contact information that includes a name, an address, and a phone number for each contact. Her bir veri alanı, Galeri denetimi içinde ayrı bir denetimde görünür ve bu denetimleri şablonu içinde yapılandırabilirsiniz.Each data field appears in a separate control within the Gallery control, and you can configure those controls in its template. Şablon, bir Galeri denetiminin sol kenarında yatay yönde ve yine bir Galeri denetiminin üstünde dikey yönde olacak şekilde galerideki ilk öğe olarak görünür.The template appears as the first item inside the gallery, on the left edge of a Gallery control in horizontal/landscape orientation and at the top of a Gallery control in vertical/portrait orientation. Şablonda yaptığınız tüm değişiklikler, Galeri denetimi geneline yansıtılır.Any changes that you make in the template are reflected throughout the Gallery control.

Görüntü ve metin galerisindeki kullanılabilir gösteren yanı sıra değişken yükseklik öğeleri için bir galeri için önceden tanımlanmış şablonlar sağlar.Predefined templates for showing images and text in a gallery are available, as well as a gallery for variable-height items.

SınırlamalarıLimitations

Kullanıcı kaydırma, esnek yükseklik galeri denetimi önce bu şu anda görünümü gönderilen aşağı ve görünümünü çıkış veri yükleme tamamlandığında, öğenin tüm öğeleri yüklenir.If a user scrolls the Flexible height gallery control before all items are loaded, the item that's currently in view may be pushed down and out of view when the data loading is finished. Bu sorunu önlemek için bir standart kullanın galeri denetimi yerine esnek yükseklik değişken.To avoid this issue, use a standard Gallery control instead of the Flexible height variant.

Temel özelliklerKey properties

Default: uygulama başlatıldığında galeriden seçilecek veri kaynağındaki öğe veya kayıt.Default – The item or record from the data source to be selected in the gallery when the app starts up.

Items: bir denetimde görünen verilerin kaynağı (galeri, liste veya grafik gibi).Items – The source of data that appears in a control such as a gallery, a list, or a chart.

Selected: seçili öğe.Selected – The selected item.

Ek özelliklerAdditional properties

AccessibleLabel – ekran okuyucular için etiket Galerisi (içerdiği öğeler için değil).AccessibleLabel – Label of the gallery (not the items it contains) for screen readers. Öğe listesinin ne olduğunu açıklamalıdır.Should describe what the list of items are.

AllItems: galeri şablonunun bir parçası olan ek denetim değerleri de dahil olmak üzere bir galerideki tüm öğeler.AllItems – All items in a gallery, including additional control values that are a part of the gallery's template.

BorderColor: bir denetimin kenarlığının rengi.BorderColor – The color of a control's border.

BorderStyle: Düz, Kesik Çizgili, Noktalı veya Hiçbiri değerleriyle bir denetimin kenarlık stili.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness: bir denetimin kenarlık kalınlığı.BorderThickness – The thickness of a control's border.

DisplayMode: denetimin kullanıcı girişine izin verip vermediği (Edit), yalnızca veri görüntüleyip görüntülemediği (View) veya devre dışı olup olmadığı (Disabled).DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

Fill: denetimin arka plan rengi.Fill – The background color of a control.

Height: denetimin üst ve alt kenarları arasındaki uzaklık.Height – The distance between a control's top and bottom edges.

ItemAccessibleLabel – her bir galeri öğesi ekran okuyucular için etiket.ItemAccessibleLabel – Label of each gallery item for screen readers. Her öğe ne olduğunu açıklamalıdır.Should describe what each item is.

NavigationStep: ShowNavigation özelliği true olarak ayarlanmışsa ve kullanıcı söz konusu galerinin herhangi bir ucunda gezinti oku seçerse galerinin ekranda nereye kadar kaydırıldığı.NavigationStep – How far a gallery scrolls if its ShowNavigation property is set to true and the user selects a navigation arrow at either end of that gallery.

Seçilebilir : galeri öğelerini seçilebilir.Selectable – Whether gallery items can be selected. Ayarlandığında trueekran okuyucular galeri seçilebilir listesi olarak tanımlamak ve tıklayarak veya dokunarak bir öğe seçin.When set to true, screen readers identify the gallery as a selectable list, and you select an item by clicking or tapping it. Ayarlandığında falseekran okuyucular, normal bir liste olarak galeri tanımlamak ve tıklayarak veya dokunarak bir öğesi olmayan onu seçin.When set to false, screen readers identify the gallery as a regular list, and clicking or tapping an item doesn't select it.

ShowNavigation: kullanıcının tıklayarak veya dokunarak galerideki öğelerde kaydırma yapmasına olanak sağlayan bir okun galerinin her bir ucunda görünüp görünmediği.ShowNavigation – Whether an arrow appears at each end of a gallery so that a user can scroll through the items in the gallery by clicking or tapping an arrow.

ShowScrollbar: kullanıcı galerinin üzerine geldiğinde bir kaydırma çubuğunun görünüp görünmediği.ShowScrollbar – Whether a scrollbar appears when the user hovers over a gallery.

Snap: kullanıcı bir galeride kaydırma yaptığında sonraki öğenin tam olarak görünecek şekilde otomatik olarak yaslanıp yaslanmadığı.Snap – Whether, when a user scrolls through a gallery, it automatically snaps so that the next item appears in full.

TemplateFill: bir galerinin arka plan rengi.TemplateFill – The background color of a gallery.

TemplatePadding: bir galeride bulunan öğeler arasındaki uzaklık.TemplatePadding – The distance between items in a gallery.

TemplateSize: dikey yöndeki bir galeri şablonunun yüksekliği veya yatay yöndeki bir galeri şablonunun genişliği.TemplateSize – The height of the template for a gallery in vertical/portrait orientation or the width of the template for a gallery in horizontal/landscape orientation.

Transition: kullanıcı galeride bir öğenin üzerine geldiğinde oluşan görsel efekt (Pop, Push veya None).Transition – The visual effect (Pop, Push, or None) when the user hovers over an item in a gallery.

Visible: denetimin gizli veya görünür olması.Visible – Whether a control appears or is hidden.

Width: denetimin sol ve sağ kenarları arasındaki uzaklık.Width – The distance between a control's left and right edges.

WrapCount: yatay ya da dikey düzende satır veya sütun başına gösterilen öğe sayısı.WrapCount – Number of items shown per row or column based on horizontal or vertical layout.

X: denetimin sol kenarı ile üst kapsayıcısının (üst kapsayıcı mevcut değilse ekranın) sol kenarı arasındaki uzaklık.X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y: denetimin üst kenarı ile üst kapsayıcının (üst kapsayıcı mevcut değilse ekranın) üst kenarı arasındaki uzaklık.Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

Filter( VeriKaynağı; Formül )Filter( DataSource; Formula )

ÖrneklerExamples

Verileri gösterme ve filtrelemeShow and filter data

Kullanıcıdan veri almaGet data from the user

Erişilebilirlik yönergeleriAccessibility guidelines

Renk karşıtlığıColor contrast

Bir galeri öğesinde herhangi bir yere tıklanmasının amacı öğeyi seçmek ise şunlar arasında yeterli renk karşıtlığı olmalıdır:If clicking anywhere in a gallery item is meant to select it, there must be adequate color contrast between:

  • BorderColor ve galerinin dışında kalan renk (bir kenarlık varsa)BorderColor and the color outside the gallery (if there is a border)
  • Fill ve galerinin dışında kalan renk (bir kenarlık yoksa)Fill and the color outside the gallery (if there is no border)

Ekran okuyucu desteğiScreen reader support

  • AccessibleLabel mevcut olmalıdır.AccessibleLabel must be present.

    Not

    Ekran okuyucuları, galerideki öğeler değiştiğinde duyurur.Screen readers will announce when items in the gallery change. AccessibleLabel değerinden de bahsedilir.The AccessibleLabel is also mentioned. Bu özellik, duyuruya bağlam ekler ve aynı ekran üzerinde birden fazla galeri olduğunda daha da önemlidir.This gives context to the announcement and is even more important when there are multiple galleries on the same screen.

  • Bir galeri öğesi birden çok denetim içerdiği kullanırsanız ItemAccessibleLabel galeri öğe içeriği özetlemek için.When a gallery item contains multiple controls, use ItemAccessibleLabel to summarize the gallery item's contents.

  • Değerini seçilebilir için true bir galeri öğesini seçmesi için kullanıcıların istiyorsanız.Set the value of Selectable to true if you want users to select a gallery item. Aksi takdirde, bu değeri ayarlamak false.Otherwise, set that value to false.

  • Bir galeri öğesi birden çok denetim içerdiği kullanırsanız ItemAccessibleLabel galeri özetini öğenin içeriği sağlamak için.When a gallery item contains multiple controls, use ItemAccessibleLabel to provide a summary of the gallery item's contents.

  • Seçilebilir olup kullanıcıların bir galeri öğesini seçmesi için yöneliktir bağlı olarak uygun şekilde ayarlanması gerekir.Selectable should be set appropriately, depending on whether users are meant to select a gallery item.

Klavye desteğiKeyboard support

  • ShowScrollbar değerini true olarak ayarlamayı düşünün.Consider setting ShowScrollbar to true. Çoğu dokunmatik ekranlı cihazda kaydırma başlayana kadar kaydırma çubuğu gösterilmez.On most touch screen devices, the scrollbar will not show until scrolling begins.

  • Bir galeri öğesinde herhangi bir yere tıklamak öğeyi seçmek anlamına geliyorsa, klavye kullanıcılarının galeri öğesini seçmesi için de bir yol olmalıdır.If clicking anywhere in a gallery item is meant to select it, there must also be way for keyboard users to select the gallery item. Örneğin, OnSelect özelliği Select(Parent) olarak ayarlanmış bir Button ekleme.For example, adding a Button that has its OnSelect property set to Select(Parent).

    Not

    Galeri dışındaki denetimler, galeri içindeki klavye ile gezinme sırasında dikkate alınmaz.Controls outside the gallery are not considered in the keyboard navigation order within the gallery. Bir galerinin içindeki denetimlerin TabIndex değeri kapsamdadır.TabIndex of controls inside a gallery are scoped. Daha fazla bilgi için bkz. erişilebilirlik özellikleri.See accessibility properties to learn more.