ovládací prvek List-View (referenční dokumentace elementu uživatelského rozhraní MSAA)
Poznámka
Toto téma popisuje List-View Ovládací prvek objekty pro účely msaa UI Element Reference. Postup vytvoření List-View ovládacích prvků objektů v různých architekturách uživatelského rozhraní není zde popsán. Prohlédni si referenční dokumentace k rozhraní API pro architekturu uživatelského rozhraní, kterou používáte.
Ovládací prvek zobrazení seznamu zobrazuje kolekci položek, které se skládají z ikony a popisku, a nabízí několik způsobů zobrazení a uspořádání položek. Například další informace o každé položce se zobrazí ve sloupcích napravo od ikony a popisku. Průzkumník Windows používá ovládací prvek zobrazení seznamu k zobrazení souborů.
Název třídy okna pro ovládací prvek list-view je WC_LISTVIEW, který je definován jako "SysListView" v Commctrl.h.
IAccessible Methods
Ovládací prvek zobrazení seznamu podporuje následující metody IAccessible:
| Metoda | Komentáře |
|---|---|
| accDoDefaultAction | Samotný objekt zobrazení seznamu nemá vlastnost DefaultAction; ale accDoDefaultAction metoda dvakrát klikne na položky seznamu zobrazení. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
Nepřístupné vlastnosti
Ovládací prvek zobrazení seznamu podporuje následující vlastnosti IAccessible:
| Vlastnost | Komentáře |
|---|---|
| get_accChild | |
| get_accChildCount | Vlastnost ChildCount je počet položek v seznamu. |
| get_accDefaultAction | Samotný objekt zobrazení seznamu nemá vlastnost DefaultAction; vlastnost DefaultAction pro každou položku zobrazení seznamu je však "Double Click". |
| get_accDescription | Samotný objekt zobrazení seznamu nepodporuje vlastnost Popis; Vlastnost popis popis pro každou položku zobrazení seznamu je text obsažený ve druhém a následném sloupci položky. Mezi text pro každý sloupec se vloží čárka. |
| get_accFocus | |
| get_accHelp | |
| get_accHelpTopic | |
| get_accKeyboardShortcut | Objekty zobrazení seznamu nemají klávesové zkratky. Pokud však text okna pro ovládací prvek zobrazení seznamu obsahuje znak ampersand (&), vrátí funkce Microsoft Active Accessibility řetězec, který není null jako vlastnost KeyboardShortcut. |
| get_accName | Název objektu zobrazení seznamu se získá z textu okna ovládacího prvku (nebo titulku). Tento text se nezobrazuje pomocí ovládacího prvku list-view, takže vývojáři serveru musí poskytnout smysluplný text v příkazu definice prostředku ovládacího prvku, aby uživatelé klientských nástrojů mohli ovládací prvek identifikovat. U položek zobrazení seznamu je vlastnost Název text položky seznamu. |
| get_accParent | Nadřazená objektu zobrazení seznamu je okno (ROLE_SYSTEM_WINDOW), které obklopuje ovládací prvek a má stejný Název vlastnost a název třídy okna jako ovládací prvek. Vlastnost Parent položek seznamu je objekt list-view. |
| get_accRole | Role ROLE_SYSTEM_LISTa každá položka v ovládacím prvku zobrazení seznamu má vlastnost RoleROLE_SYSTEM_LISTITEM. |
| get_accSelection | |
| get_accState | Vlastnost State objektu zobrazení seznamu je kombinací jedné nebo více následujících hodnot : STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_OFFSCREEN Vlastnost State položek zobrazení seznamu je kombinací jedné nebo více následujících hodnot: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_MULTISELECTABLE | STATE_SYSTEM_HOTTRACKED | STATE_SYSTEM_OFFSCREEN | STATE_SYSTEM_NORMAL Kromě toho, zaškrtávací políčko zobrazit položky mají také stav STATE_SYSTEM_CHECKED. |
Poznámky
- Microsoft Active Accessibility nezpřístupňuje text položky zobrazení seznamu v aplikacích, které k přidání textu do položky používají funkci zpětného volání.
- Položky zobrazení seznamu, které jsou oříznuté, nemají nastavenou STATE_SYSTEM_INVISIBLE. Pokud chcete zjistit, jestli je položka seznamu oříznutá, můžou klienti porovnat souřadnice položky vrácené accLocation s oblastí výřezu okna.
- Microsoft Active Accessibility nepodporuje použití metody accNavigate k přechodu na ovládací prvek záhlaví v ovládacím prvku zobrazení seznamu, který je v zobrazení Podrobností. Klienti však používají funkci AccessibleObjectFromPoint pro přístup k ovládacímu prvku záhlaví.
- U ne obdélníkových objektů, jako jsou položky zobrazení seznamu v zobrazení Podrobností, souřadnice ohraničujícího obdélníku položky načteného accLocation selžou, pokud jsou testovány s accHitTest, protože accHitTest určuje hranice objektu na pixel-by-pixel.