ListView-besturingselement
Het besturingselement ListView waarmee één kolom met waarden wordt weergegeven met een pictogram naast elk item. Hiermee kan de gebruiker één tekenreeks of geheel getal voor een eigenschap selecteren in een vooraf bepaalde lijst. De mogelijke waarden worden gelezen uit de ListView-tabel. U kunt het besturingselement koppelen aan een geheel getal of tekenreekswaarde door de naam van de eigenschap in te voeren in de kolom Eigenschap van de Control-tabel.
De inhoud van het veld Tekst van de Control-tabel wordt nooit weergegeven door het besturingselement ListView. In plaats daarvan geeft dit veld de stijl van tekst op die door het besturingselement moet worden weergegeven en bevat een beschrijving van het besturingselement dat wordt gebruikt door de hulpprogramma's voor schermbeoordeling. Als u het lettertype en de tekenstijl van een tekenreeks wilt instellen, moet u de tekenreeks van weergegeven tekens voorafzetten met {\style} of {&stijl}. Waar stijl een id is die wordt vermeld in de kolom TextStyle van de tabel TextStyle. Als geen van deze aanwezig is, maar de eigenschap DefaultUIFont is gedefinieerd als een geldige tekststijl, wordt dat lettertype gebruikt. De volgende informatie wordt gelezen door de hulpprogramma's voor schermbeoordeling als de beschrijving van het besturingselement. Zie Toegankelijkheid.
Besturingskenmerken
U kunt de volgende kenmerken gebruiken met dit besturingselement. Als u de waarde van een kenmerk wilt wijzigen met behulp van een gebeurtenis, abonneert u het besturingselement op een ControlEvent in de EventMapping-tabel en vermeldt u de id van het kenmerk in de kolom Kenmerk. Voer de id in van de ControlEvent in de kolom Gebeurtenis.
| Kenmerk-id | Hexadecimale bit | Beschrijving |
|---|---|---|
| IndirectPropertyName | Dit is de naam van een indirecte eigenschap die is gekoppeld aan het besturingselement. Als de bit van het indirecte kenmerk is ingesteld, wordt in het besturingselement de waarde van de eigenschap met deze naam weergegeven of gewijzigd. Als de bit van het indirecte kenmerk is ingesteld, is deze naam ook de waarde van de eigenschap die wordt vermeld in de kolom Eigenschap van de Control-tabel. | |
| positie | Positie van het besturingselement in het dialoogvenster. Voer de breedte, hoogte en coördinaten van het besturingselement in de linkerhoek van het besturingselement in de kolommen Breedte, Hoogte, X en Y van de Control-tabel in. Gebruik installatie-eenheden voor lengte en afstand. |
|
| PropertyName- | Dit is de naam van de eigenschap die aan dit besturingselement is gekoppeld. Als de bit van het indirecte kenmerk niet is ingesteld, wordt in het besturingselement de waarde van de eigenschap met deze naam weergegeven of gewijzigd. Dit kenmerk wordt opgegeven in de kolom Eigenschap van de Control-tabel. | |
| PropertyValue- | Huidige waarde van de eigenschap die door dit besturingselement wordt weergegeven of gewijzigd. Als de indirecte kenmerk-bit niet is ingesteld, is dit de waarde van PropertyName. Als de bit van het indirecte kenmerk is ingesteld, is dit de waarde van IndirectPropertyName. Als het kenmerk wordt gewijzigd, geeft het besturingselement de nieuwe waarde weer. | |
| tekst | Als u tekst in schermlezers wilt weergeven, voert u de tekst in de kolom Tekst van de Control-tabel in. Zie Toegankelijkheid. | |
| zichtbare | 0x00000000 0x00000001 |
Verborgen besturingselement. Zichtbaar besturingselement. Neem deze bit op in het bitwoord van de kolom Kenmerken in de tabel Control om het besturingselement zichtbaar of verborgen te maken. U kunt een besturingselement ook verbergen of weergeven met behulp van de tabel ControlCondition. |
| ingeschakelde | 0x00000000 0x00000002 |
Besturingselement met een uitgeschakelde status. Besturingselement in een ingeschakelde status. Neem deze bit op in het bitwoord in de kolom Kenmerken van het Besturingselement om het besturingselement bij het maken in te schakelen. U kunt een besturingselement ook in- of uitschakelen met behulp van de tabel ControlCondition. |
| 0x00000000 0x00000004 |
Hiermee wordt de standaardvisualstijl weergegeven. Geeft het besturingselement weer met een gezonken, 3D, look. Neem deze bits op in het bitwoord in de kolom Kenmerken van de Control-tabel. |
|
| indirect | 0x00000000 0x00000008 |
Het besturingselement geeft de waarde van de eigenschap weer of wijzigt deze in de kolom Eigenschap van de tabel Control. Het besturingselement geeft de waarde weer of wijzigt de waarde van de eigenschap met de id die wordt vermeld in de kolom Eigenschap van de tabel Control. Bepaalt of de eigenschap die aan dit besturingselement is gekoppeld indirect wordt verwezen. |
| geheel getal | 0x00000000 0x00000010 |
De eigenschap die aan het besturingselement is gekoppeld, is een tekenreekswaarde. De eigenschap die aan het besturingselement is gekoppeld, is een geheel getal. Neem deze bit op in het bitwoord van de kolom Kenmerken van de tabel Control om dit kenmerk in te stellen bij het maken van het besturingselement. |
| RTLRO- | 0x00000000 0x00000020 |
Tekst in het besturingselement wordt weergegeven in de leesrichting van links naar rechts. Tekst in het besturingselement wordt weergegeven in de leesrichting van rechts naar links. |
| rechts uitgelijnde | 0x00000000 0x00000040 |
Tekst in het besturingselement wordt links uitgelijnd. Tekst in het besturingselement wordt rechts uitgelijnd. |
| LeftScroll- | 0x00000000 0x00000080 |
De schuifbalk bevindt zich aan de rechterkant van het besturingselement. De schuifbalk bevindt zich aan de linkerkant van het besturingselement. |
| BiDi- | 0x000000E0 | Stel deze waarde in voor een combinatie van de RTLRO-, RightAligneden LeftScroll kenmerken. |
| gesorteerde | 0x00000000 0x00010000 |
Items die in alfabetische volgorde worden weergegeven. Items die worden weergegeven in de volgorde die is opgegeven in de ListView-tabel. Neem deze bit op in het bitwoord in de kolom Kenmerken om items weer te geven in de volgorde die is opgegeven door de kolom Volgorde van de tabel ListView. |
| FixedSize | 0x00000000 0x00100000 |
Hiermee wordt de afbeelding van het pictogram uitgerekt zodat deze past bij het besturingselement. Hiermee wordt de afbeelding van het pictogram in het besturingselement gewassen of gecentrerd. Neem deze bit op in het bitwoord van de kolom Kenmerken van de Control-tabel. |
| IconSize | 0x00000000 0x00200000 0x00400000 0x00600000 |
Laadt de eerste afbeelding. Laadt de eerste 16x16-afbeelding. Laadt de eerste 32x32 afbeelding. Laadt de eerste afbeelding van 48x48. Een pictogrambestand kan verschillende grootteafbeeldingen van hetzelfde pictogram bevatten. Neem de waarde van het juiste bitwoord op in de kolom Kenmerken van de Control-tabel Als deze bits niet zijn ingesteld, negeert het installatieprogramma het kenmerk FixedSize en wordt de afbeelding uitgerekt zodat deze past bij de rechthoek van het besturingselement. Als zowel de IconSize-bits als de FixedSize-bits zijn ingesteld, wordt een afbeelding kleiner dan het besturingselement gecentreerd en is een afbeelding groter dan het besturingselement dat het passend is. |
Opmerkingen
Dit besturingselement kan worden gemaakt op basis van de WC_LISTVIEW-klasse met behulp van de functie CreateWindowEx. Het bevat de stijlen LVS_REPORT, LVS_NOCOLUMNHEADER, WS_VSCROLL, WS_HSCROLL, LVS_SHAREIMAGELISTS, LVS_SINGLESEL, LVS_SHOWSELALWAYS, WS_BORDERen WS_TABSTOP. Als de bit gesorteerde stijl niet is ingeschakeld, heeft het besturingselement ook de LVS_SORTASCENDING stijl.
Voor compatibiliteit met schermlezers moet u bij het ontwerpen van een dialoogvenster met een ListView-besturingselement als het eerste actieve besturingselement het tekstveld dat hoort bij het bewerkingsveld het eerste actieve besturingselement in de dialoogvenstertabel. Aangezien de statische tekst niet de focus kan krijgen, krijgt het bewerkingsveld de focus in eerste instantie zoals bedoeld, maar dit zorgt ervoor dat schermlezers de juiste informatie weergeven.