Константы SELFLAG

В этом разделе описываются значения констант, используемые для указания того, как объект со специальными возможностями выбирается или принимает фокус. Константы определяются в oleacc.h и используются с методом IAccessible::accSelect .

Следующие сочетания не допускаются:

  • SELFLAG_ADDSELECTION | SELFLAG_REMOVESELECTION
  • SELFLAG_ADDSELECTION | SELFLAG_TAKESELECTION
  • SELFLAG_REMOVESELECTION | SELFLAG_TAKESELECTION
  • SELFLAG_EXTENDSELECTION | SELFLAG_TAKESELECTION

Обратите внимание на клиенты: Microsoft Active Accessibility не поддерживает выделение текста, содержащегося в элементах управления редактированием и форматированным редактированием, так как текст предоставляется в виде строки в свойстве Value объекта.

Сведения о выполнении сложных операций выбора см. в разделе Выбор дочерних объектов.

Констант/значение Описание
SELFLAG_NONE
0
Не выполняет никаких действий. Microsoft Active Accessibility не изменяет выбор или фокус.
SELFLAG_TAKEFOCUS
0x1
Устанавливает фокус на объект и делает его привязкой выбора. Этот флаг, используемый сам по себе, не изменяет выбор. Эффект аналогичен перемещению фокуса вручную путем нажатия клавиши СО СТРЕЛКОЙ, удерживая нажатой клавишу CTRL в Windows Обозреватель или в любом списке с множественным выбором.
С объектами, имеющими STATE_SYSTEM_MULTISELECTABLE, SELFLAG_TAKEFOCUS объединяется со следующими значениями:
  • SELFLAG_TAKESELECTION
  • SELFLAG_EXTENDSELECTION
  • SELFLAG_ADDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_ADDSELECTION
  • SELFLAG_EXTENDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_EXTENDSELECTION
При вызове метода IAccessible::accSelect с флагом SELFLAG_TAKEFOCUS для объекта, имеющего HWND, флаг вступит в силу, только если родительский объект объекта уже имеет фокус.
SELFLAG_TAKESELECTION
0x2
Выбирает объект и удаляет выделенный фрагмент из всех остальных объектов в контейнере.
Если он не объединен с SELFLAG_TAKEFOCUS, этот флаг не изменяет фокус или привязку выбора. Сочетание SELFLAG_TAKESELECTION и SELFLAG_TAKEFOCUS эквивалентно щелчку элемента одним щелчком в Windows Обозреватель.
Этот флаг не должен сочетаться со следующими флагами:
  • SELFLAG_ADDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_EXTENDSELECTION
SELFLAG_EXTENDSELECTION
0x4
Изменяет выделение таким образом, чтобы все объекты между привязкой выделения и этим объектом переключились на состояние выделения объекта привязки. Если объект точки привязки не выделен, объекты удаляются из выделения. Если выбран объект привязки, выделение расширяется, чтобы включить этот объект и все объекты между ними. Задайте состояние выбора, объединив этот флаг с SELFLAG_ADDSELECTION или SELFLAG_REMOVESELECTION.
Если он не объединен с SELFLAG_TAKEFOCUS, этот флаг не изменяет фокус или привязку выбора. Сочетание SELFLAG_EXTENDSELECTION и SELFLAG_TAKEFOCUS эквивалентно добавлению элемента к выделенному фрагменту вручную путем удерживания нажатой клавиши SHIFT и щелчка невыбранного объекта в Windows Обозреватель.
Этот флаг не сочетается с SELFLAG_TAKESELECTION.
SELFLAG_ADDSELECTION
0x8
Добавляет объект к текущему выделенному фрагменту; возможный результат — несмежный выбор.
Если он не объединен с SELFLAG_TAKEFOCUS, этот флаг не изменяет фокус или привязку выбора. Сочетание SELFLAG_ADDSELECTION и SELFLAG_TAKEFOCUS эквивалентно добавлению элемента к выделенному фрагменту вручную, удерживая нажатой клавишу CTRL и щелкнув невыбранный объект в Windows Обозреватель.
Этот флаг не сочетается с SELFLAG_REMOVESELECTION или SELFLAG_TAKESELECTION.
SELFLAG_REMOVESELECTION
0x10
Удаляет объект из текущего выделенного фрагмента; возможный результат — несмежный выбор.
Если он не объединен с SELFLAG_TAKEFOCUS, этот флаг не изменяет фокус или привязку выбора. Сочетание SELFLAG_REMOVESELECTION и SELFLAG_TAKEFOCUS эквивалентно удалению элемента из выделенного фрагмента вручную, удерживая нажатой клавишу CTRL при выборе выбранного объекта в Windows Обозреватель.
Этот флаг не сочетается с SELFLAG_ADDSELECTION или SELFLAG_TAKESELECTION.

Требования

Требование Значение
Заголовок
Oleacc.h

См. также раздел

IAccessible::accSelect

Выбор дочерних объектов