Aracılığıyla paylaş


ListView Denetimi

Her öğenin yanında bir simge bulunan tek bir değer sütunu görüntüleyen ListView denetimi. Kullanıcının önceden belirlenmiş bir listeden bir özellik için tek bir dize veya tamsayı değeri seçmesini sağlar. Olası değerler ListView tablosundanokunur. Denetim tablosununÖzellik sütununa özelliğin adını girerek denetimi bir tamsayı veya dize değeriyle ilişkilendirebilirsiniz.

Denetimi tablosu Metin alanının içeriği hiçbir zaman ListView denetimi tarafından görüntülenmez. Bunun yerine, bu alan denetim tarafından görüntülenecek metin stilini belirtir ve ekran gözden geçirme yardımcı programları tarafından kullanılan denetimin açıklamasını içerir. Bir metin dizesinin yazı tipi ve yazı tipi stilini ayarlamak için görüntülenen karakter dizesine {\style} veya {&stili} ön ekini ekleyin. Burada stil, TextStyle tablosununTextStyle sütununda listelenen bir tanımlayıcıdır. Bunlardan hiçbiri yoksa, ancak DefaultUIFont özelliği geçerli bir metin stili olarak tanımlanırsa, bu yazı tipi kullanılır. Bunu izleyen bilgiler, denetimin açıklaması olarak ekran gözden geçirme yardımcı programları tarafından okunur. Bkz. Erişilebilirlik .

Denetim Öznitelikleri

Bu denetimle aşağıdaki öznitelikleri kullanabilirsiniz. Bir olayı kullanarak özniteliğin değerini değiştirmek için, denetimi EventMapping tablosundaki bir ControlEvent'e abone olun ve özniteliğin tanımlayıcısını Öznitelik sütununda listeleyin. Olay sütununa ControlEvent tanımlayıcısını girin.

Öznitelik tanımlayıcısı Onaltılık bit Açıklama
IndirectPropertyName Bu, denetimle ilişkili dolaylı bir özelliğin adıdır. Dolaylı öznitelik biti ayarlanırsa, denetim bu ada sahip özelliğin değerini görüntüler veya değiştirir. Dolaylı öznitelik biti ayarlanırsa, bu ad aynı zamanda Denetimi tablosunun Özellik sütununda listelenen özelliğin değeridir.
Konum İletişim kutusundaki denetimin konumu. Denetimin sol köşesinin genişliğini, yüksekliğini ve koordinatlarını Denetim tablosunun Width, Height, X ve Y sütunlarınagirin. Uzunluk ve uzaklık için yükleyici birimlerini kullanın.
PropertyName   Bu, bu denetimle ilişkili özelliğin adıdır. Dolaylı öznitelik biti ayarlanmadıysa, denetim bu ada sahip özelliğin değerini görüntüler veya değiştirir. Bu öznitelik, Denetimi tablosunun Özellik sütununda belirtilir.
PropertyValue Bu denetim tarafından görüntülenen veya değiştirilen özelliğin geçerli değeri. Dolaylı öznitelik biti ayarlanmadıysa, bu PropertyName değeridir. Dolaylı öznitelik biti ayarlanırsa, bu IndirectPropertyName değeridir. Öznitelik değişirse, denetim yeni değeri yansıtır.
metin Ekran okuyucularda metin görüntülemek için, Denetimi tablosunun Metin sütununametni girin. Bkz. Erişilebilirlik .
görünür 0x00000000 0x00000001
Gizli denetim. Görünür denetim.
Denetimin oluşturulması sırasında görünür veya gizli olmasını sağlamak için bu biti Denetimi tablosundaki Öznitelikler sütununun bit sözcüğüne ekleyin.
Ayrıca, ControlCondition tablosunu kullanarak bir denetimi gizleyebilir veya gösterebilirsiniz.
Etkin 0x00000000 0x00000002
Denetim devre dışı durumda. Etkin durumdaki denetim.
Oluşturmada denetimi etkinleştirmek için bu biti Denetimi Öznitelikler sütunundaki bit sözcüğüne ekleyin.
ControlCondition tablosunukullanarak da denetimi etkinleştirebilir veya devre dışı bırakabilirsiniz.
Batık 0x00000000 0x00000004
Varsayılan görsel stilini görüntüler. Denetimi 3B batık bir görünümle görüntüler.
Bu bitleri Denetimi tablosunun Öznitelikler sütunundaki bit sözcüğüne ekleyin.
Dolaylı 0x00000000 0x00000008
Denetim, Denetim tablosunun Özellik sütunundaki özelliğinin değerinigörüntüler veya değiştirir. Denetim, Control tablosunun Özellik sütununda listelenen tanımlayıcıya sahip özelliğin değerini görüntüler veya değiştirir.
Bu denetimle ilişkili özelliğe dolaylı olarak başvurulup başvurulmadığını belirler.
tamsayı 0x00000000 0x00000010
Denetimle ilişkili özellik bir dize değeridir. Denetimle ilişkilendirilmiş özellik bir tamsayı değeridir.
Denetimin oluşturulmasında bu özniteliği ayarlamak Denetimi tablosunun Öznitelikler sütununun bit sözcüğüne bu biti ekleyin.
RTLRO 0x00000000 0x00000020
Denetimdeki metin soldan sağa okuma sırasına göre görüntülenir. Denetimdeki metin sağdan sola okuma sırasına göre görüntülenir.
Sağ Hizalı 0x00000000 0x00000040
Denetimdeki metin sola hizalanır. Denetimdeki metin sağa hizalanır.
LeftScroll 0x00000000 0x00000080
Kaydırma çubuğu denetimin sağ tarafında bulunur. Kaydırma çubuğu denetimin sol tarafında bulunur.
BiDi 0x000000E0 RTLRO, RightAlignedve LeftScroll özniteliklerinin bir bileşimi için bu değeri ayarlayın.
Sıralanmış 0x00000000 0x00010000
Alfabetik sırada görüntülenen öğeler. ListView tablosunda belirtilen sırayla görüntülenen öğeler.
Öğeleri ListView tablosunun Order sütunu tarafından belirtilen sırada görüntülemek için bu biti Öznitelikler sütununa bit sözcüğüne ekleyin.
FixedSize 0x00000000 0x00100000
Simge görüntüsünü denetime sığacak şekilde genişletir. Denetimdeki simge görüntüsünü kırpın veya ortalar.
Bu biti Denetimi tablosunun Öznitelikler sütununun bit sözcüğüne ekleyin.
IconSize 0x00000000 0x00200000
0x00400000
0x00600000
İlk görüntüyü yükler. İlk 16x16 görüntüsünü yükler.
İlk 32x32 görüntüsünü yükler.
İlk 48x48 görüntüsünü yükler.
Simge dosyası aynı simgenin farklı boyutlu görüntülerini içerebilir. Denetimi tablosunun Öznitelikler sütununa uygun bit sözcüğünün değerini ekleyin
Bu bitler ayarlanmamışsa, yükleyici FixedSize özniteliğini yoksayar ve görüntü denetim dikdörtgenine sığacak şekilde uzatılır. Hem IconSize bitleri hem de FixedSize bitleri ayarlanırsa, denetimden küçük bir görüntü ortalanır ve resim sığacak şekilde küçültülecek denetimden daha büyüktür.

 

Açıklamalar

Bu denetim, CreateWindowEx işlevi kullanılarak WC_LISTVIEW sınıfından oluşturulabilir. LVS_REPORT, LVS_NOCOLUMNHEADER, WS_VSCROLL, WS_HSCROLL, LVS_SHAREIMAGELISTS, LVS_SINGLESEL, LVS_SHOWSELALWAYS, WS_BORDERve WS_TABSTOP stilleri vardır. Sıralanmış stil biti açık değilse, denetim de LVS_SORTASCENDING stiline sahiptir.

Ekran okuyucularla uyumluluk için, ilk etkin denetim olarak ListView denetimine sahip bir iletişim kutusu yazarken, düzenleme alanına ait metin alanını İletişim Kutusu tablosundaki ilk etkin denetimyapmalısınız. Statik metin odak alamadığından, iletişim kutusu oluşturulduğunda düzenleme alanı başlangıçta amaçlandığı gibi odağı alır, ancak bunu yapmak ekran okuyucuların doğru bilgileri göstermesini sağlar.