Veraltete Steuerelementmusterfunktionen

Hinweis

Die in diesem Abschnitt beschriebenen Steuerelementmusterfunktionen sind veraltet. Clientanwendungen sollten die COM-Schnittstellen (Component Object Model) verwenden, die in den folgenden Abschnitten beschrieben werden:

• Benutzeroberflächenautomatisierungselementschnittstellen für Clients
• Eigenschaftenbedingungsschnittstelle für Clients
• Steuerelementmusterschnittstellen für Clients
• Ereignisbehandlungsschnittstellen für Clients
• Proxy Factory-Schnittstellen für Clients

In diesem Abschnitt

Funktion	BESCHREIBUNG
DockPattern_SetDockPosition	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen von Microsoft UI Automation verwenden. Dockt das UI Automation-Element an der angeforderten dockPosition in einem Andockcontainer an.
ExpandCollapsePattern_Collapse	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Blendet alle untergeordneten Knoten, Steuerelemente oder Inhalte des UI Automation-Elements aus.
ExpandCollapsePattern_Expand	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Erweitert ein Steuerelement auf dem Bildschirm, sodass weitere Informationen angezeigt werden.
GridPattern_GetItem	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Ruft den Knoten für ein Element in einem Raster ab.
InvokePattern_Invoke	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Sendet eine Anforderung zum Aktivieren eines Steuerelements und Initiieren der einzelnen eindeutigen Aktion.
ItemContainerPattern_FindItemByProperty	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Ruft einen Knoten innerhalb eines enthaltenden Knotens basierend auf einem angegebenen Eigenschaftswert ab.
LegacyIAccessiblePattern_DoDefaultAction	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Führt die Microsoft Active Accessibility-Standardaktion für das -Element aus.
LegacyIAccessiblePattern_GetIAccessible	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Ruft ein IAccessible-Objekt ab, das dem Ui Automation-Element entspricht.
LegacyIAccessiblePattern_Select	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Führt eine Microsoft Active Accessibility-Auswahl aus.
LegacyIAccessiblePattern_SetValue	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Legt die Microsoft Active Accessibility Value-Eigenschaft für den Knoten fest.
MultipleViewPattern_GetViewName	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Ruft den Namen einer steuerelementspezifischen Ansicht ab.
MultipleViewPattern_SetCurrentView	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Legt ein Steuerelement auf ein anderes Layout fest.
RangeValuePattern_SetValue	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Legt den Wert eines Steuerelements fest, das über einen numerischen Bereich verfügt.
ScrollItemPattern_ScrollIntoView	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Scrollt im Inhaltsbereich eines Containerobjekts, um das UI Automation-Element innerhalb der sichtbaren Region (Viewport) des Containers anzuzeigen.
ScrollPattern_Scroll	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Scrollt den aktuell sichtbaren Bereich des Inhaltsbereichs mit dem angegebenen ScrollAmount, horizontal, vertikal oder beides.
ScrollPattern_SetScrollPercent	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Scrollt einen Container horizontal, vertikal oder beides zu einer bestimmten Position.
SelectionItemPattern_AddToSelection	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Fügt einer Auswahl in einem Steuerelement ein nicht ausgewähltes Element hinzu.
SelectionItemPattern_RemoveFromSelection	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Entfernt ein Element aus der Auswahl in einem Auswahlcontainer.
SelectionItemPattern_Select	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Wählt ein Element in einem Auswahlcontainer aus.
SynchronizedInputPattern_Cancel	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Bewirkt, dass der Benutzeroberflächenautomatisierungsanbieter nicht mehr auf Maus- oder Tastatureingaben lauscht.
SynchronizedInputPattern_StartListening	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen für die Benutzeroberflächenautomatisierung verwenden. Bewirkt, dass der Benutzeroberflächenautomatisierungsanbieter mit der Überwachung der Maus- oder Tastatureingabe beginnt.
TextPattern_get_DocumentRange	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Ruft den Textbereich für das gesamte Dokument ab.
TextPattern_get_SupportedTextSelection	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Ermittelt, ob der Inhalt des Textcontainers ausgewählt und deaktiviert werden kann.
TextPattern_GetSelection	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Ruft den aktuellen Bereich des markierten Texts aus einem Textcontainer ab, der das Textmuster unterstützt.
TextPattern_GetVisibleRanges	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Ruft ein Array von nicht zusammenhängenden Textbereichen aus einem Textcontainer ab, wobei jeder Textbereich mit der ersten teilweise sichtbaren Zeile beginnt und mit dem Ende der letzten teilweise sichtbaren Zeile endet. Beispielsweise ein mehrspaltiges Layout, bei dem die Spalten teilweise aus dem sichtbaren Bereich des Viewports herausgescrollt werden und der Inhalt vom unteren Rand einer Spalte zum oberen Rand der nächsten fließt.
TextPattern_RangeFromChild	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Ruft den Textbereich ab, den ein bestimmter Knoten umfasst.
TextPattern_RangeFromPoint	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Ruft den entarteten (leeren) Textbereich ab, der den angegebenen Bildschirmkoordinaten am nächsten liegt.
TextRange_AddToSelection	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Fügt der vorhandenen Auflistung von hervorgehobenem Text in einem Textcontainer hinzu, der mehrere, getrennte Auswahlen unterstützt, indem ergänzender Text hervorgehoben wird, der den aufrufenden Textbereichsendpunkten Start und Ende entspricht.
TextRange_Clone	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Kopiert einen Textbereich.
TextRange_Compare	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Vergleicht zwei Textbereiche.
TextRange_CompareEndpoints	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Gibt einen Wert zurück, der angibt, ob zwei Textbereiche identische Endpunkte aufweisen.
TextRange_ExpandToEnclosingUnit	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Erweitert den Textbereich auf eine größere oder kleinere Einheit, z. B. Character, Word, Line oder Page.
TextRange_FindAttribute	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Sucht in einer angegebenen Richtung nach dem ersten Textabschnitt, der ein angegebenes Textattribute unterstützt.
TextRange_FindText	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Gibt den ersten Textbereich in der angegebenen Richtung zurück, der den Vom Client gesuchten Text enthält.
TextRange_GetAttributeValue	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Ruft den Wert eines Textattributes für einen Textbereich ab.
TextRange_GetBoundingRectangles	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Ruft die Mindestanzahl von begrenzungsbasierten Rechtecke ab, die den Bereich einschließen können( ein Rechteck pro Zeile).
TextRange_GetChildren	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Gibt alle Benutzeroberflächenautomatisierungselemente zurück, die innerhalb des angegebenen Textbereichs enthalten sind.
TextRange_GetEnclosingElement	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Gibt den Knoten für den nächstkleinsten Anbieter zurück, der den Bereich abdeckt.
TextRange_GetText	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Gibt den Text in einem Textbereich bis zu einer angegebenen Anzahl von Zeichen zurück.
TextRange_Move	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Verschiebt den Textbereich um die angegebene Anzahl von Einheiten, die vom Client angefordert werden.
TextRange_MoveEndpointByRange	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Verschiebt einen Endpunkt eines Bereichs an den Endpunkt eines anderen Bereichs.
TextRange_MoveEndpointByUnit	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Verschiebt einen Endpunkt des Bereichs um die angegebene Anzahl von Einheiten.
TextRange_RemoveFromSelection	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Entfernt den markierten Text, der dem aufrufenden Textbereich TextPatternRangeEndpoint_Start und TextPatternRangeEndpoint_End Endpunkten entspricht, aus einer vorhandenen Auflistung von ausgewähltem Text in einem Textcontainer, der mehrere, getrennte Auswahlen unterstützt.
TextRange_ScrollIntoView	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Scrollt den Text, sodass der angegebene Bereich im Viewport sichtbar ist.
TextRange_Select	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Markiert einen Textbereich.
TogglePattern_Toggle	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Schaltet ein Steuerelement in den nächsten unterstützten Zustand um.
TransformPattern_Move	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Verschiebt ein Element an eine angegebene Position auf dem Bildschirm.
TransformPattern_Resize	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Ändert die Größe eines Elements auf dem Bildschirm.
TransformPattern_Rotate	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Dreht ein Element auf dem Bildschirm.
ValuePattern_SetValue	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Legt den Textwert eines Elements fest.
VirtualizedItemPattern_Realize	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Ermöglicht den vollständigen Zugriff auf das virtuelle Element als Benutzeroberflächen-Automatisierungselement.
WindowPattern_Close	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Schließt ein geöffnetes Fenster.
WindowPattern_SetWindowVisualState	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Legt den visuellen Zustand eines Fensters fest. beispielsweise, um ein Fenster zu maximieren.
WindowPattern_WaitForInputIdle	Hinweis: Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die BENUTZERoberflächenautomatisierungs-COM-Schnittstellen verwenden. Bewirkt, dass der aufrufende Code für die angegebene Zeitspanne oder solange blockiert wird, bis der zugeordnete Prozess in den Leerlauf wechselt, je nachdem, was zuerst zutrifft.

Zugehörige Themen

Benutzeroberflächenautomatisierungsclients