Freigeben über

SemanticZoom-Steuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Benutzeroberflächenautomatisierungsunterstützung für den SemanticZoom-Steuerelementtyp .

Der semantische Zoom ist eine in Windows 8 eingeführte Technik zum Anzeigen und Navigieren großer Mengen verwandter Daten oder Inhalte in einer einzelnen Ansicht, z. B. einem Fotoalbum, einer App-Liste oder einem Adressbuch. Der semantische Zoom verwendet zwei verschiedene Klassifizierungsmodi oder Zoomstufen, um den Inhalt zu organisieren und darzustellen. Im Modus "Low-Level" (oder "Verkleinert") werden Elemente in einer flachen Struktur angezeigt. und der allgemeine (oder verkleinerte) Modus zeigt Elemente in Gruppen an, sodass der Benutzer schnell durch den Inhalt navigieren und durchsuchen kann. Wenn Sie z. B. eine Liste von Städten vergrößern, kann sich dies in eine Liste von Bundesstaaten ändern, die diese Städte enthalten. Das Vergrößern einer Liste von Programmen kann sich in eine Liste logischer Programmgruppen ändern.

Weitere Informationen zum semantischen Zoom, der speziell für Windows Store-Apps verwendet wird, finden Sie unter Richtlinien für den semantischen Zoom.

Das Verwendungsmodell für den SemanticZoom-Steuerelementtyp ist insofern ungewöhnlich, als es hauptsächlich für den programmgesteuerten Zugriff vorhanden ist. Microsoft UI Automation-Clients können das Semantische Zoom-Steuerelement überwachen und bearbeiten, um den verkleinerten Status der Liste zu steuern. Benutzer, die keine Hilfstechnologie verwenden, würden das Semantische Zoom-Steuerelement in der Regel direkt über Touchgesten oder Tastenkombinationen bearbeiten.

In den folgenden Abschnitten werden die erforderliche Struktur, Eigenschaften, Steuerelementmuster und Ereignisse der Benutzeroberflächenautomatisierung für den SemanticZoom-Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle semantischen Zoom-Steuerelemente, bei denen das Benutzeroberflächenframework bzw. die Plattform benutzeroberflächenautomatisierungsunterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Ui Automation-Struktur, die sich auf den SemanticZoom-Steuerelementtyp bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.

Steuerelementansicht Inhaltsansicht
  • List
    • [SemanticZoom]
      • ListItem (beliebige Anzahl)
  • List
    • ListItem (beliebige Anzahl)

Oder:

Steuerelementansicht Inhaltsansicht
  • [SemanticZoom]
    • List
      • ListItem (beliebige Anzahl)
  • List
    • ListItem (beliebige Anzahl)

Relevante Eigenschaften

In der folgenden Tabelle sind die Ui Automation-Eigenschaften aufgeführt, deren Wert oder Definition besonders für die Steuerelemente relevant ist, die den SemanticZoom-Steuerelementtyp implementieren. Weitere Informationen zu Ui Automation-Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Ui Automation-Elementen.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Hinweise
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der Rohansicht der Ui Automation-Struktur eindeutig sein.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußere Rechteck, das das gesamte Steuerelement enthält.
UIA_ClickablePointPropertyId Siehe Hinweise. Wenn das Listensteuerelement über einen klickbaren Punkt verfügt (ein Punkt, auf den geklickt werden kann, damit die Liste den Fokus erhält), muss dieser Punkt über diese Eigenschaft verfügbar gemacht werden. Wenn der Wert der UIA_IsOffscreenPropertyId-EigenschaftTRUE ist, führt der Versuch, diese Eigenschaft abzurufen, zum UIA_E_NOCLICKABLEPOINT Fehler.
UIA_ControlTypePropertyId SemanticZoom
UIA_IsContentElementPropertyId true
UIA_IsControlElementPropertyId true
UIA_IsKeyboardFocusablePropertyId false
UIA_LabeledByPropertyId Siehe Hinweise. Wenn eine statische Textbeschriftung vorhanden ist, muss diese Eigenschaft einen Verweis auf dieses Steuerelement verfügbar machen.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Eine lokalisierte Zeichenfolge, die dem SemanticZoom-Steuerelementtyp entspricht. Der Standardwert ist "semantischer Zoom" für en-US oder Englisch (USA). Hinweis: Einige Frameworks verketteten dies als "semanticzoom".
UIA_NamePropertyId Siehe Hinweise. Eine leere Zeichenfolge ist akzeptabel, oder ein nützlicherer Name könnte angegeben werden, solange er nicht den Begriff semantischen Zoom enthält, was die Kombination aus Steuerelementtyp und Name verwirrend machen würde.

Erforderliche Steuerelementmuster und -eigenschaften

In der folgenden Tabelle sind die Ui Automation-Steuerelementmuster aufgeführt, die von allen semantischen Zoomsteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Steuerelementmuster/Mustereigenschaft Unterstützung/Wert Hinweise
IToggleProvider Depends (Abhängig) Semantische Zoomsteuerelemente unterstützen das Steuerelementmuster umschalten , damit der Zoom aktiviert oder deaktiviert werden kann. ToggleState_Off entspricht dem flachen, all-up-Zustand, und ToggleState_On entspricht der ansicht auf hoher Ebene, verkleinert.

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die semantische Zoomsteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Ereignis der Benutzeroberflächenautomatisierung Hinweise
UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis.
UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsOffscreenPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_ToggleToggleStatePropertyId Eigenschaftsänderungsereignis.

Bemerkungen

Wenn eine Benutzeroberfläche über eine sichtbare Schaltfläche zum Umschalten des Verhaltens des semantischen Zoomsteuerelements verfügt, sollte diese Schaltfläche keinen SemanticZoom-Steuerelementtyp aufweisen. Dies ist gegen intuitiv, aber der SemanticZoom-Steuerelementtyp kennzeichnet den Container des zoomenden Inhalts, nicht eine Schaltfläche, die den Zoom steuert. (Eine solche Schaltfläche kann einfach als Button-Steuerelementtyp mit dem Umschalter-Steuerelementmuster dargestellt werden.)

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung