Edytowanie kontrolki (odwołanie do elementu interfejsu użytkownika MSAA)

Nuta

W tym temacie opisano obiekty kontrolki edycji na potrzeby odwołania do elementu interfejsu użytkownika MSAA. Sposób tworzenia obiektów kontrolki edycji w różnych strukturach interfejsu użytkownika nie jest opisany tutaj. Zapoznaj się z dokumentacją interfejsu API dotyczącą używanej platformy interfejsu użytkownika.

Kontrolki edycji umożliwiają użytkownikowi wyświetlanie i edytowanie tekstu. Kontrolki edycji są tworzone z wieloma różnymi stylami, takimi jak ES_MULTILINE. Ten styl tworzy wielowierszową kontrolkę edycji, taką jak obszar klienta Notatnika i ES_READONLY, która tworzy kontrolkę edycji tylko do odczytu.

Ułatwienia dostępu Microsoft Active nie rozróżnia kontrolek edycji utworzonych za pomocą nazwy klasy okna "EDIT" i formantów edycji wzbogaconych utworzonych za pomocą nazwy klasy okna "RichEdit" lub "RichEdit20A".

Metody IAccessible

Kontrolki edycji obsługują następujące metody IAccessible:

• accHitTest
• accLocation
• accNavigate
• accSelect

Właściwości funkcji IAccessible

Kontrolki edycji obsługują następujące właściwości IAccessible:

Własność	Komentarze
get_accChild
get_accChildCount
get_accDescription
get_accFocus
get_accKeyboardShortcut	Właściwość KeyboardShortcut jest kluczem dostępu kontrolki edycji, który jest podkreślony znakiem w tekście etykiety kontrolki edycji. Na przykład w standardowym oknie dialogowym Otwieranie pliku, takim jak w programie WordPad, KeyboardShortcut dla kontrolki edycji oznaczonej jako "Nazwa pliku:" to "Alt+n".
get_accName	Właściwość Name jest tekstem kontrolki tekstu statycznego, która etykietuje kontrolkę edycji. Na przykład w standardowym oknie dialogowym Otwieranie pliku, takim jak w programie WordPad, właściwość Nazwa dla kontrolki edycji to "Nazwa pliku:".
get_accParent	Właściwość Nadrzędna jest oknem (ROLE_SYSTEM_WINDOW ), które otacza kontrolkę i ma taką samą właściwość Name i nazwę klasy okna co kontrolka.
get_accRole	Właściwość roli jest ROLE_SYSTEM_TEXT.
get_accSelection
get_accState	Właściwość State jest kombinacją co najmniej jednej z następujących wartości :STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_READONLY | STATE_SYSTEM_PROTECTED | STATE_SYSTEM_NORMAL
get_accValue	Właściwość Value jest pojedynczym ciągiem zawierającym tekst w kontrolce edycji. Jeśli jednak kontrolka jest chroniona hasłem, właściwość Value zwraca E_ACCESSDENIED. W przypadku kontrolek edycji wielowierszowej ciąg zawiera znak powrotu karetki i znak nowego wiersza na końcu każdego wiersza.

Notatki

• Microsoft Active Accessibility nie obsługuje zaznaczenia tekstu zawartego w kontrolkach edycji i edycji sformatowanej, ponieważ tekst jest uwidoczniony jako ciąg we właściwości Value obiektu.

• Kontrolka edycji sformatowanej zapewniana przez Riched20.dll (która jest używana w edytorach tekstów, takich jak WordPad w systemie Windows 98) nie wysyła żadnych elementów WinEvents, gdy pozycja karetki zostanie zmieniona podczas zaznaczenia tekstu. Gdy użytkownicy naciskają SHIFT i strzałek, aby zaznaczyć tekst, obiekt daszka nie wyzwoli EVENT_OBJECT_LOCATIONCHANGE WinEvent. Po ustawieniu zaznaczenia programowo za pomocą komunikatów edycji sformatowanej obiekt karetki nie wysyła żadnych zdarzeń, aby wskazać jego nową pozycję.

  Wszystkie aplikacje korzystające z Riched20.dll wykazują ten problem. Aplikacje korzystające z wcześniejszych wersji kontrolki edycji wzbogaconej poprawnie wysyłają zdarzenia na podstawie zaznaczenia.

• Wartość stanu dla kontrolek edycji haseł zawsze zawiera flagę bitową STATE_SYSTEM_PROTECTED.

Tematy pokrewne

interfejs IAccessible