Тип элемента управления "Панель"

  • Статья

В этом разделе содержатся сведения о поддержке microsoft модель автоматизации пользовательского интерфейса для типа элемента управления Pane.

Тип элемента управления "Панель" предназначен для потенциально прокручиваемых областей с разнородным содержимым. Он используется для представления объекта в рамке или окне документа. Пользователи могут перемещаться между элементами управления панели и внутри содержимого текущей панели. Элементы управления панелью представляют уровень группировки ниже, чем окна или документы, но выше отдельных элементов управления. Пользователь переходит между панелями, нажимая клавишу TAB, F6 или CTRL+TAB, в зависимости от контекста.

В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса древовидной структуры, свойств, шаблонов элементов управления и событий для типа элемента управления Pane. Требования к модель автоматизации пользовательского интерфейса применяются ко всем элементам управления панели, где платформа или платформа пользовательского интерфейса интегрируются модель автоматизации пользовательского интерфейса поддержку типов элементов управления и шаблонов элементов управления.

В этом разделе содержатся следующие подразделы.

Типичная древовидная структура

В следующей таблице представлен типичный элемент управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, которое относится к элементам управления панели и описывает, что может содержаться в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в разделе Общие сведения о дереве модель автоматизации пользовательского интерфейса.

Представление элемента управления Представление содержимого
  • Панель
  • Панель

 

Элемент управления панелью всегда отображается в представлении элемента управления и содержимого. Не предоставляйте объект макета в виде панели в элементе управления или представлении содержимого, если объект используется только для визуального представления.

Соответствующие свойства

В следующей таблице перечислены модель автоматизации пользовательского интерфейса свойства, значение или определение которых особенно важно для элементов управления панели. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе Извлечение свойств из элементов модель автоматизации пользовательского интерфейса.

Свойство модели автоматизации пользовательского интерфейса Значение Примечания
UIA_AccessKeyPropertyId См. примечания. Если определенная комбинация клавиш передает фокус на панель, эта информация должна предоставляться через это свойство.
UIA_AutomationIdPropertyId См. примечания. Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева модель автоматизации пользовательского интерфейса.
UIA_BoundingRectanglePropertyId См. примечания. Внешний прямоугольник, содержащий весь элемент управления.
UIA_ClickablePointPropertyId См. примечания. Это свойство предоставляет активную точку элемента управления "Панель", при щелчке в которой эта панель получает фокус.
UIA_ControlTypePropertyId Панель
UIA_HelpTextPropertyId См. примечания. В тексте справки для элементов управления панелью должно объясняться назначение кадра и его связь с другими кадрами. Описание необходимо, если назначение и связь кадров не ясны из значения свойства UIA_NamePropertyId .
UIA_IsContentElementPropertyId TRUE Элемент управления панелью всегда включается в представление содержимого дерева модель автоматизации пользовательского интерфейса.
UIA_IsControlElementPropertyId TRUE Элемент управления панелью всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса.
UIA_IsKeyboardFocusablePropertyId См. примечания. Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство.
UIA_LabeledByPropertyId См. примечания. Элементы управления "Панель" обычно не имеют статических меток. Если метка со статическим текстом присутствует, она должна предоставляться через это свойство.
UIA_LocalizedControlTypePropertyId См. примечания. Локализованная строка, соответствующая типу элемента управления Pane . Значение по умолчанию — pane для en-US или english (США).
UIA_NamePropertyId См. примечания. Значение этого свойства всегда должно быть четким, кратким и понятным заголовком.

 

Обязательные шаблоны элементов управления

В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться элементами управления панели. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.

Шаблон элемента управления Поддержка Примечания
IDockProvider Зависит Реализуйте шаблон элемента управления Dock , если элемент управления панели можно закрепить.
IScrollProvider Зависит Реализуйте шаблон элемента управления Прокрутка , если элемент управления панелью можно прокрутить.
ITransformProvider Зависит Реализуйте шаблон элемента управления Преобразование , если элемент управления панели можно перемещать, изменять размер или поворачивать на экране.
IWindowProvider Никогда Если элементу необходимо реализовать шаблон элемента управления Window , он должен основываться на типе элемента управления Window .

 

Обязательные события

В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые требуются для поддержки элементов управления панели. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.

Событие модель автоматизации пользовательского интерфейса Примечания
UIA_AsyncContentLoadedEventId
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId событие изменения свойства.
UIA_IsOffscreenPropertyId событие изменения свойства. Если элемент управления поддерживает свойство IsOffscreen , он должен поддерживать это событие.
UIA_ScrollHorizontallyScrollablePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления Scroll , он должен поддерживать это событие.
UIA_ScrollHorizontalScrollPercentPropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления Scroll , он должен поддерживать это событие.
UIA_ScrollHorizontalViewSizePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления Scroll , он должен поддерживать это событие.
UIA_ScrollVerticallyScrollablePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления Scroll , он должен поддерживать это событие.
UIA_ScrollVerticalScrollPercentPropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления Scroll , он должен поддерживать это событие.
UIA_ScrollVerticalViewSizePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления Scroll , он должен поддерживать это событие.
UIA_StructureChangedEventId

 

Пример типа элемента управления Pane

На следующем рисунке показан элемент управления, реализующий тип элемента управления Pane .

Снимок экрана, показывающий пример элемента управления панелью

Дерево модель автоматизации пользовательского интерфейса — представление элемента управления Дерево модель автоматизации пользовательского интерфейса — представление содержимого
  • Панель
    • Tree (шаблон Scroll)
      • TreeItem
      • ...
  • Панель
    • Изменить (шаблон прокрутки)
  • Панель
    • Tree (шаблон Scroll)
      • TreeItem
      • ...
    • Панель
      • Изменить (шаблон прокрутки)

 

Основные понятия

Общие сведения о типах элементов управления автоматизации пользовательского интерфейса

Общие сведения о модели автоматизации пользовательского интерфейса