ListView-kontroll
ListView-kontrollen som visar en enda kolumn med värden med en ikon bredvid varje objekt. Det gör att användaren kan välja en enskild sträng eller heltalsvärde för en egenskap från en fördefinierad lista. Möjliga värden läse från tabellen ListView. Du kan associera kontrollen med ett heltal eller strängvärde genom att ange egenskapens namn i kolumnen Egenskap i tabellen Control.
Innehållet i fältet Text i tabellen Control visas aldrig av ListView-kontrollen. I stället anger det här fältet textformatet som ska visas av kontrollen och innehåller en beskrivning av kontrollen som används av verktygen för skärmgranskning. Om du vill ange teckensnittet och teckensnittsformatet för en textsträng prefixar du strängen med tecken som visas med {\style} eller {&formatmall}. Där formatmallen är en identifierare i kolumnen TextStyle i tabellen TextStyle. Om ingen av dessa finns, men egenskapen DefaultUIFont definieras som ett giltigt textformat, används det teckensnittet. Informationen som följer detta läss av verktyg för skärmgranskning som beskrivning av kontrollen. Se Hjälpmedel.
Kontrollattribut
Du kan använda följande attribut med den här kontrollen. Om du vill ändra värdet för ett attribut med hjälp av en händelse prenumererar du på kontrollen till en ControlEvent i tabellen EventMapping och listar attributets identifierare i kolumnen Attribut. Ange identifieraren för ControlEvent i kolumnen Händelse.
| Attributidentifierare | Hexadecimal bit | Beskrivning |
|---|---|---|
| IndirectPropertyName | Det här är namnet på en indirekt egenskap som är associerad med kontrollen. Om den indirekta attributbiten har angetts visar eller ändrar kontrollen värdet för egenskapen med det här namnet. Om biten Indirekt attribut anges är det här namnet också värdet för egenskapen som anges i kolumnen Egenskap i tabellen Control. | |
| position | Kontrollens position i dialogrutan. Ange kontrollens bredd, höjd och koordinater i kontrollens vänstra hörn i kolumnerna Width, Height, X och Y i tabellen Control. Använd installationsenheter för längd och avstånd. |
|
| PropertyName | Det här är namnet på egenskapen som är associerad med den här kontrollen. Om den indirekta attributbiten inte har angetts visar eller ändrar kontrollen värdet för egenskapen med det här namnet. Det här attributet anges i kolumnen Egenskap i tabellen Control. | |
| PropertyValue | Aktuellt värde för egenskapen som visas eller ändras av den här kontrollen. Om biten Indirect attribute inte har angetts är det värdet för PropertyName. Om biten Indirect attribute har angetts är det värdet indirectPropertyName. Om attributet ändras återspeglar kontrollen det nya värdet. | |
| Text | Om du vill visa text i skärmläsare anger du texten i kolumnen Text i tabellen Control. Se Hjälpmedel. | |
| synlig | 0x00000000 0x00000001 |
Dold kontroll. Synlig kontroll. Inkludera den här biten i bitordet i kolumnen Attribut i tabellen Control för att göra kontrollen synlig eller dold när den skapas. Du kan också dölja eller visa en kontroll med hjälp av tabellen ControlCondition. |
| aktiverat | 0x00000000 0x00000002 |
Kontroll i inaktiverat tillstånd. Kontroll i ett aktiverat tillstånd. Inkludera den här biten i bitordet i kolumnen Attribut i Control för att aktivera kontrollen när den skapas. Du kan också aktivera eller inaktivera en kontroll med hjälp av tabellen ControlCondition. |
| nedsänkt | 0x00000000 0x00000004 |
Visar standardformatet för visuella objekt. Visar kontrollen med en nedsänkt 3D-look. Inkludera dessa bitar i bitordet i kolumnen Attribut i tabellen Control. |
| Indirekt | 0x00000000 0x00000008 |
Kontrollen visar eller ändrar värdet för egenskapen i kolumnen Egenskap i tabellen Control. Kontrollen visar eller ändrar värdet för egenskapen som innehåller identifieraren i kolumnen Egenskap i tabellen Kontroll. Avgör om egenskapen som är associerad med den här kontrollen refereras indirekt. |
| Heltal | 0x00000000 0x00000010 |
Egenskapen som är associerad med kontrollen är ett strängvärde. Egenskapen som är associerad med kontrollen är ett heltalsvärde. Inkludera den här biten i bitordet i kolumnen Attribut i tabellen Control för att ange det här attributet när kontrollen skapas. |
| RTLRO- | 0x00000000 0x00000020 |
Text i kontrollen visas i läsordning från vänster till höger. Text i kontrollen visas i läsordning från höger till vänster. |
| RightAligned | 0x00000000 0x00000040 |
Texten i kontrollen är justerad till vänster. Texten i kontrollen är justerad till höger. |
| LeftScroll | 0x00000000 0x00000080 |
Rullningslisten finns till höger om kontrollen. Rullningslisten finns till vänster i kontrollen. |
| BiDi | 0x000000E0 | Ange det här värdet för en kombination av RTLRO, RightAlignedoch LeftScroll attribut. |
| Sorterade | 0x00000000 0x00010000 |
Objekt som visas i alfabetisk ordning. Objekt som visas i den ordning som anges i tabellen ListView. Ta med den här biten i bitordet i kolumnen Attribut för att visa objekt i den ordning som anges av kolumnen Order i ListView-tabellen. |
| FixedSize | 0x00000000 0x00100000 |
Sträcker ut ikonbilden så att den passar kontrollen. Beskär eller centrerar ikonbilden i kontrollen. Inkludera den här biten i bitordet i kolumnen Attribut i tabellen Control. |
| IconSize | 0x00000000 0x00200000 0x00400000 0x00600000 |
Läser in den första bilden. Läser in den första 16x16-avbildningen. Läser in den första 32x32-avbildningen. Läser in den första 48x48-avbildningen. En ikonfil kan innehålla olika storleksbilder av samma ikon. Inkludera värdet för lämpligt bitord i kolumnen Attribut i tabellen Control Om dessa bitar inte har angetts ignorerar installationsprogrammet attributet FixedSize och avbildningen sträcks ut så att den passar kontrollrektangeln. Om både IconSize-bitar och FixedSize-bitar har angetts är en bild som är mindre än kontrollen centrerad och en bild är större än den kontroll som den krymper för att passa. |
Anmärkningar
Den här kontrollen kan skapas från klassen WC_LISTVIEW med hjälp av funktionen CreateWindowEx. Den har formaten LVS_REPORT, LVS_NOCOLUMNHEADER, WS_VSCROLL, WS_HSCROLL, LVS_SHAREIMAGELISTS, LVS_SINGLESEL, LVS_SHOWSELALWAYS, WS_BORDERoch WS_TABSTOP. Om den sorterade formatbiten inte är på har kontrollen även LVS_SORTASCENDING formatmall.
För kompatibilitet med skärmläsare måste du när du redigerar en dialogruta med en ListView-kontroll som den första aktiva kontrollen göra textfältet som tillhör redigeringsfältet till den första aktiva kontrollen i tabellen Dialog. Eftersom den statiska texten inte kan fokuseras kommer redigeringsfältet att ha fokus från början som avsett, men om du gör det ser du till att skärmläsarna visar rätt information.