ListView vezérlő
A ListView vezérlő, amely egyetlen értékoszlopot jelenít meg az egyes elemek melletti ikonnal. Lehetővé teszi a felhasználó számára, hogy egy előre meghatározott listából egyetlen sztringet vagy egész számot válasszon ki egy tulajdonsághoz. A lehetséges értékek a ListView tábla. A vezérlőelemet egész számmal vagy sztringértékkel társíthatja, ha a tulajdonság nevét beírja a Control táblaTulajdonság oszlopába.
A ListView vezérlő soha nem jeleníti meg a Vezérlőtábla Szöveg mezőjének tartalmát,. Ez a mező a vezérlőelem által megjelenítendő szövegstílust adja meg, és tartalmazza a képernyő-felülvizsgálati segédprogramok által használt vezérlő leírását. Egy szöveges sztring betűtípusának és betűstílusának beállításához a megjelenített karakterek sztringjét {\style} vagy {&stílus} előtaggal adhatja meg. Ahol a stílus az TextStyle tábla TextStyle oszlopában szereplő azonosító,. Ha egyik sem található, de a DefaultUIFont tulajdonság érvényes szövegstílusként van definiálva, akkor a program ezt a betűtípust fogja használni. Az ezt követő információkat a vezérlő leírásaként a képernyő-ellenőrző segédprogramok olvassák fel. Lásd: Kisegítő lehetőségek.
Vezérlőattribútumok
Ezzel a vezérlővel az alábbi attribútumokat használhatja. Ha egy attribútum értékét esemény használatával szeretné módosítani, iratkozzon fel egy ControlEvent vezérlőre az EventMapping táblában, és sorolja fel az attribútum azonosítóját az Attribútum oszlopban. Adja meg a ControlEvent azonosítóját az Esemény oszlopban.
| Attribútumazonosító | Hexadecimális bit | Leírás |
|---|---|---|
| IndirectPropertyName | Ez a vezérlőelemhez társított közvetett tulajdonság neve. Ha a Közvetett attribútum bit be van állítva, a vezérlő megjeleníti vagy módosítja az ilyen nevű tulajdonság értékét. Ha a Közvetett attribútum bit be van állítva, akkor ez a név a Control táblaTulajdonság oszlopában felsorolt tulajdonság értéke is. | |
| pozíció | A vezérlő helye a párbeszédpanelen. Adja meg a vezérlőelem bal oldali sarkának szélességét, magasságát és koordinátáit a Control táblaSzélesség, Magasság, X és Y oszlopába. Használjon telepítőegységeket a hosszhoz és a távolsághoz. |
|
| PropertyName | Ez a vezérlőelemhez társított tulajdonság neve. Ha a Közvetett attribútum bit nincs beállítva, a vezérlő megjeleníti vagy módosítja az ilyen nevű tulajdonság értékét. Ez az attribútum a Control táblaTulajdonság oszlopában van megadva. | |
| PropertyValue | A vezérlőelem által megjelenített vagy módosított tulajdonság aktuális értéke. Ha a Közvetett attribútum bit nincs beállítva, akkor ez a PropertyName értéke. Ha a Közvetett attribútum bit be van állítva, akkor ez az IndirectPropertyName értéke. Ha az attribútum megváltozik, a vezérlő az új értéket tükrözi. | |
| Szöveg | Ha képernyőolvasókban szeretné megjeleníteni a szöveget, írja be a szöveget a VezérlőtáblaSzöveg oszlopába. Lásd: Kisegítő lehetőségek. | |
| Látható | 0x00000000 0x00000001 |
Rejtett vezérlő. Látható vezérlő. Ezt a bitet a Control tábla Attribútumok oszlopának bitszava belefoglalva láthatóvá vagy rejtettsé teheti a vezérlőt a létrehozásakor. A vezérlőelemeket a ControlCondition táblahasználatával is elrejtheti vagy megjelenítheti. |
| Engedélyezett | 0x00000000 0x00000002 |
Vezérlőelem letiltott állapotban. Vezérlőelem engedélyezett állapotban. A vezérlőelem létrehozásának engedélyezéséhez vegye fel ezt a bitet a bit szóba a Vezérlő Attribútumok oszlopában. A vezérlőelemeket a ControlCondition táblahasználatával is engedélyezheti vagy letilthatja. |
| elsüllyedt | 0x00000000 0x00000004 |
Megjeleníti az alapértelmezett vizuális stílust. A vezérlőt egy elsüllyedt, térhatású megjelenéssel jeleníti meg. Vegye fel ezeket a biteket a bit szóba a Control tábla Attribútumok oszlopában. |
| közvetett | 0x00000000 0x00000008 |
A vezérlő megjeleníti vagy módosítja a tulajdonság értékét a Control tábla Tulajdonság oszlopában. A vezérlő megjeleníti vagy módosítja annak a tulajdonságnak az értékét, amelynek azonosítója szerepel a Control tábla Tulajdonság oszlopában. Meghatározza, hogy a vezérlőhöz társított tulajdonságra közvetetten hivatkozik-e. |
| egész szám | 0x00000000 0x00000010 |
A vezérlőelemhez társított tulajdonság egy sztringérték. A vezérlőelemhez társított tulajdonság egész szám. Vegye fel ezt a bitet a Control tábla Attribútumok oszlopának bitszavaiba, az attribútum beállításához a vezérlő létrehozásakor. |
| RTLRO | 0x00000000 0x00000020 |
A vezérlőben lévő szöveg balról jobbra olvasási sorrendben jelenik meg. A vezérlőben lévő szöveg jobbról balra olvasási sorrendben jelenik meg. |
| RightAligned | 0x00000000 0x00000040 |
A vezérlőben lévő szöveg balra van igazítva. A vezérlőben lévő szöveg jobbra van igazítva. |
| LeftScroll | 0x00000000 0x00000080 |
A görgetősáv a vezérlő jobb oldalán található. A görgetősáv a vezérlő bal oldalán található. |
| BiDi | 0x000000E0 | Állítsa be ezt az értéket az RTLRO, RightAlignedés LeftScroll attribútumok kombinációjához. |
| Rendezett | 0x00000000 0x00010000 |
Betűrendben megjelenített elemek. A ListView táblában megadott sorrendben megjelenített elemek. Ezt a bitet az Attribútumok oszlopban a bit szóba belefoglalva megjelenítheti az elemeket a ListView tábla Rendelés oszlopában megadott sorrendben. |
| FixedSize | 0x00000000 0x00100000 |
Kinyújtja az ikonképet, hogy illeszkedjen a vezérlőhöz. Az ikon képének körülvetése vagy középre igazítása a vezérlőben. Adja meg ezt a bitet a Control tábla Attribútumok oszlopának bitszava. |
| IconSize | 0x00000000 0x00200000 0x00400000 0x00600000 |
Betölti az első képet. Betölti az első 16x16-os képet. Betölti az első 32x32-képet. Betölti az első 48x48-képet. Az ikonfájlok különböző méretű képeket tartalmazhatnak ugyanabból az ikonból. Adja meg a megfelelő bitszavat a Control tábla Attribútumok oszlopában Ha ezek a bitek nincsenek beállítva, a telepítő figyelmen kívül hagyja a FixedSize attribútumot, és a rendszerkép a vezérlő téglalapjának megfelelően van kifeszítve. Ha az IconSize bitek és a FixedSize bitek is be vannak állítva, a vezérlőelemnél kisebb kép középre van állítva, és a rendszerkép nagyobb, mint a vezérlőelem, amelyet elfér. |
Megjegyzések
Ez a vezérlő a WC_LISTVIEW osztályból hozható létre a CreateWindowEx függvénnyel. A LVS_REPORT, LVS_NOCOLUMNHEADER, WS_VSCROLL, WS_HSCROLL, LVS_SHAREIMAGELISTS, LVS_SINGLESEL, LVS_SHOWSELALWAYS, WS_BORDERés WS_TABSTOP stílussal rendelkezik. Ha a Rendezés stílus bit nincs bekapcsolva, a vezérlő LVS_SORTASCENDING stílust is tartalmazza.
A képernyőolvasókkal való kompatibilitás érdekében a ListView vezérlővel rendelkező párbeszédpanel első aktív vezérlőelemként való létrehozásakor a szerkesztési mezőhöz tartozó szövegmezőt a Párbeszédpanel táblaelső aktív vezérlőjének kell lennie. Mivel a statikus szöveg nem tudja fókuszba helyezni a fókuszt, a párbeszédpanel létrehozásakor a szerkesztési mező eredetileg a kívánt fókuszt fogja használni, de ezzel biztosítja, hogy a képernyőolvasók a megfelelő információkat jelenítsen meg.