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.