Benutzerdefinierte Excel-Muster

In diesem Thema werden die in Microsoft Excel für Windows bereitgestellten benutzerdefinierten Benutzeroberflächenautomatisierung-Muster beschrieben. Diese Muster können vom Anbieterknoten für ein bestimmtes Excel-Arbeitsblatt abgefragt und verwendet werden.

Zu Experimentierzwecken haben wir spezielle PowerShell-Skripts im PowerShell-Katalog erstellt, die jedes benutzerdefinierte Excel-Muster ausführen. Diese werden bei jedem Muster explizit hervorgehoben, oder Sie können im PowerShell-Katalog nach CustomPatternClient_Excel suchen, um alle Excel-Skripts anzuzeigen. Diese Skripts können in einem PowerShell-Fenster für eine ausgeführte instance von Excel auf Windows 11 ausgeführt werden, um zu sehen, welche Ausgabe die benutzerdefinierten Muster erzeugen. Die Skripts sind mit kommentarbasierter Hilfe selbst dokumentiert.

Das Standard Ziel dieser Muster besteht darin, Blattinformationen bereitzustellen, die nicht auf den sichtbaren Bereich des Blatts verengt sind. Namen und Bereiche sind der Kommunikationsmodus und nicht Barrierefreiheitsobjekte. Für Zellen steht der in diesen Mustern verwendete Name auch als UIA_AutomationIdPropertyId zur Verfügung.

Operanden, die für alle Methoden gemeinsam sind

Für jeden Aufruf einer benutzerdefinierten Mustermethode gibt es drei feste Eingabeopernden.

Operand	Typ	Beschreibung
0	ConnectBoundObject	Pattern-Objekt
1	GUID	Die Methoden-GUID
2	Int32	Gesamtanzahl der Eingabe- und Ausgabeargumente

Rückgabewerte

Jede hier beschriebene Methode gibt ein HRESULT für die CallExtension zurück, um Erfolg oder Fehler anzuzeigen. Ein erfolgreicher Vorgang gibt S_OK zurück, und ein fehlgeschlagener Vorgang führt zu UIA_E_INVALIDOPERATON.

ISheetCellInventory

Beschreibung

Guid: {654823FE-A483-4915-8709-67266866E518}

Dies ist ein Muster auf einem Arbeitsblatt, das Zellen sammelt, die bestimmten Merkmalen entsprechen. In allen Fällen geben sie eine Auflistung von Zeichenfolgen zurück, die Zellnamen sind.

PowerShell-Skript

CustomPatternClient_Excel_Cell_Inventory.ps1

Methoden

GetCellsWithFormula

Guid: {24E137F2-4FFF-4F50-84AD-2ACD780E7E1F}

Gibt die Namen von Zellen im Arbeitsblatt zurück, die Formeln enthalten.

Operand	Rolle	Typ	Beschreibung
3	Ausgabe	StringArray	Zellnamen

GetCellsWithHyperlink

Guid: {B640F40E-E51A-4CDD-9604-843AA5107C1C}

Gibt die Namen von Zellen zurück, die literale Hyperlnks aufweisen. Mit anderen Worten, Zellen mit einem Wert, der eine URL ist.

Operand	Rolle	Typ	Beschreibung
3	Ausgabe	StringArray	Zellnamen

GetCellsWithFormulaHyperlink

Guid: {0AAF2B49-015B-4AB3-A093-21F055E8E0F5}

Gibt die Namen von Zellen zurück, die Formel-Hyperlnks aufweisen. Mit anderen Worten, Zellen, die die HYPERLINK-Funktion in ihrer Formel verwenden.

Operand	Rolle	Typ	Beschreibung
3	Ausgabe	StringArray	Zellnamen

GetCellsWithNote

Guid: {8F171892-A3B1-4F92-9CE1-CE818B848F52}

Gibt die Namen von Zellen zurück, denen eine Notiz oder ein nicht gereadter Legacykommentar zugeordnet ist.

Operand	Rolle	Typ	Beschreibung
3	Ausgabe	StringArray	Zellnamen

GetCellsWithComment

Guid: {4D4E49BC-CE16-44CD-AC48-1DAA2E862C41}

Gibt die Namen von Zellen zurück, denen Kommentarthreads zugeordnet sind.

Operand	Rolle	Typ	Beschreibung
3	Ausgabe	StringArray	Zellnamen

ISheetRangeInventory

Beschreibung

Guid: {62F8DBCE-13DC-4EF2-AF53-5247ED2A4980}

Dieses Arbeitsblattmuster sammelt Zellbereiche. Diese Methoden geben eine Auflistung von Zeichenfolgen zurück, die einen Zellbereich darstellen. Der Bereich kann durch seinen Namen (falls zutreffend) und optional den Zellbereichsbezug beschrieben werden, der durch eine Eingabetrennzeichenzeichenfolge vom Namen getrennt ist.

PowerShell-Skript

CustomPatternClient_Excel_Range_Inventory.ps1

Methoden

GetTableNamesAndRanges

Guid: {3FB8E49A-BB4A-4B6C-8B25-CB7E612DA92E}

Ruft die Namen von Listentabellen und deren Bereiche ab, falls angefordert. Die Bereichsspezifikationen werden durch die Eingabetrennzeichenzeichenfolge vom Tabellennamen getrennt.

Operand	Rolle	Typ	Beschreibung
3	Input	Boolescher Wert	Einschließen von Bereichsspezifikationen
4	Input	Zeichenfolge	Feldtrennzeichen für Name und Bereich
5	Ausgabe	StringArray	Bereichsnamen und Verweise bei Bedarf

GetPivotTableNamesAndRanges

Guid: {B22CD312-E265-49AE-9C73-11CE3D7B8526}

Ruft die Namen von PivotTables und deren Bereiche ab, falls angefordert. Die Bereichsspezifikationen werden durch die Eingabetrennzeichenzeichenfolge vom Tabellennamen getrennt.

Operand	Rolle	Typ	Beschreibung
3	Input	Boolescher Wert	Einschließen von Bereichsspezifikationen
4	Input	Zeichenfolge	Feldtrennzeichen für Name und Bereich
5	Ausgabe	StringArray	Bereichsnamen und Verweise bei Bedarf

GetNamedRanges

Guid: {EFC59F27-E965-48A5-8C79-7BB9E70958FD}

Ruft die benannten Bereiche und deren Bereichsspezifikationen ab, falls angefordert. Dabei handelt es sich um Zellbereiche, die mithilfe des Namens-Managers benannt wurden, und nicht diejenigen, die aus Tabellen stammen. Die Bereichsspezifikationen werden durch die Eingabetrennzeichenzeichenfolge vom Tabellennamen getrennt.

Operand	Rolle	Typ	Beschreibung
3	Input	Boolescher Wert	Einschließen von Bereichsspezifikationen
4	Input	Zeichenfolge	Feldtrennzeichen für Name und Bereich
5	Ausgabe	StringArray	Bereichsnamen und Verweise bei Bedarf

GetUnnamedDataRanges

Guid: {60EBB5D1-299D-471D-8DAB-00EE39EBA79E}

Ruft Zellbereiche mit Daten ab, die andernfalls nicht Teil eines benannten Bereichs oder einer benannten Tabelle sind.

Operand	Rolle	Typ	Beschreibung
3	Ausgabe	StringArray	Bereichsverweise

GetRowRangesOnPageBreaks

Guid: {2544B784-764D-4EAA-A72F-BABBF28B5504}

Ruft einzelne Zeilenbereichsbezüge ab, die sich über den druckbaren Bereich des Arbeitsblatts erstrecken, der einem horizontalen Seitenumbruch vorausgeht.

Operand	Rolle	Typ	Beschreibung
3	Ausgabe	StringArray	Bereichsverweise

GetColumnRangesOnPageBreaks

Guid: {BEA372DC-2FD8-4852-A8BC-2DA34CEA5456}

Ruft einzelspaltige Bereichsbezüge ab, die sich über den druckbaren Bereich des Arbeitsblatts erstrecken, der einem vertikalen Seitenumbruch vorausgeht.

Operand	Rolle	Typ	Beschreibung
3	Ausgabe	StringArray	Bereichsverweise

ISheetObjectInventory

Beschreibung

Guid: {62F8DBCE-13DC-4EF2-AF53-5247ED2A4980}

Dieses Arbeitsblattmuster gibt eine Auflistung benannter Objekte auf dem Blatt eines angegebenen Typs zurück.

PowerShell-Skript

CustomPatternClient_Excel_Object_Inventory.ps1

Methoden

GetChartNames

Guid: {6D199DC0-7AF0-43CC-A572-8CF9EE556F75}

Ruft die Namen von Diagrammen auf dem Blatt ab.

Operand	Rolle	Typ	Beschreibung
3	Ausgabe	StringArray	Diagrammnamen

GetSmartDiagramNames

Guid: {AF8706FA-6389-4F90-9EF8-F64AED618C4F}

Ruft die Namen von Smart Art-Diagrammen auf dem Blatt ab.

Operand	Rolle	Typ	Beschreibung
3	Ausgabe	StringArray	Diagrammnamen

GetSlicerNames

Guid: {7D6295DF-E9CC-4B86-BE9F-60BACCB7289D}

Ruft die Namen der Slicerobjekte auf dem Blatt ab.

Operand	Rolle	Typ	Beschreibung
3	Ausgabe	StringArray	Slicernamen

GetTimeSlicerNames

Guid: {F8768BF3-9733-4BD9-9251-507649FF3257}

Ruft die Namen der Zeitslicerobjekte auf dem Blatt ab.

Operand	Rolle	Typ	Beschreibung
3	Ausgabe	StringArray	Zeitslicernamen

GetImageNames

Guid: {A2807141-BA1F-4088-85A1-4C00F140998C}

Ruft die Namen von Bildobjekten auf dem Blatt ab.

Operand	Rolle	Typ	Beschreibung
3	Ausgabe	StringArray	Bildnamen

GetShapeNames

Guid: {C50C4B9E-2F62-4E47-993D-A961D0C6A03D}

Ruft die Namen der Zeichnungs-Shapes auf dem Blatt ab.

Operand	Rolle	Typ	Beschreibung
3	Ausgabe	StringArray	Shape-Namen

ISheetContentSelect

Beschreibung

Guid: {5979E0BC-12AC-4105-B10A-2FD04546E9C2}

Dieses Muster ermöglicht die Auswahl beliebiger Zellen, Zellenauflistungen oder Objekte auf dem Blatt, unabhängig vom aktuellen Ansichtszustand. Zellen, die nicht sichtbar sind, verfügen über kein barrierefreies Element zum Ausführen eines Auswahlelementmusters, sodass dieses Muster die Auswahl nach Zellenname zulässt. Der Zellname ist auch die AutomationID-Eigenschaft, wenn Sie zu einer zuvor besuchten Zelle zurückkehren möchten. Diese Methode ermöglicht auch das Angeben eines Zellbereichs zum Auswählen des Formulars :. Objekte können auch anhand ihres Namens ausgewählt werden, wie von ISheetObjectInventory zurückgegeben.

PowerShell-Skript

CustomPatternClient_Excel_Selector.ps1

Methoden

SelectRange

Guid: {BB66F5D4-795E-4B6E-9D62-F14804FC240C}

Wählt eine Zelle oder einen Zellbereich auf dem Blatt aus und macht sie sichtbar.

Operand	Rolle	Typ	Beschreibung
3	Input	Zeichenfolge	Zellenname, Bereichsbezug oder Bereichsname

SelectObject

Guid: {E36D84D6-B003-47D2-9AC2-9A1B8BA6EB62}

Wählt ein Objekt auf dem Blatt aus und macht es sichtbar.

Operand	Rolle	Typ	Beschreibung
3	Input	Zeichenfolge	Objektname

ISheetCellValue

Beschreibung

Guid: {238037C4-BBA3-4C0E-9371-66046B81E957}

Dieses Muster wird verwendet, um die aktuellen Werte einer Zelle oder Zellen innerhalb einer Zelladresse, eines Bereichs oder einer Tabellenzeile bzw. -spalte auf dem Blatt abzurufen, unabhängig davon, ob das Blatt sichtbar ist oder nicht. Die Ausgabe ist eine Zeichenfolge mit dem aktuellen Zellwert oder ein Zeichenfolgenarray von Zelladressen-Wert-Paaren beim Abfragen einer Zeile/Spalte in einem Bereich oder einer Tabelle.

PowerShell-Skript

CustomPatternClient_Excel_Cell_Value.ps1

Methoden

GetCellValue

Guid: {4C6CA843-D4F0-4CB6-B1AF-EF8DADEE9B2C}

Ruft den aktuellen Wert der Zelle ab.

Operand	Rolle	Typ	Beschreibung
3	Input	Zeichenfolge	Zellenname
4	Ausgabe	Zeichenfolge	Aktueller Wert der Zelle

PowerShell-Skript

CustomPatternClient_Excel_Range_Values.ps1

Methoden

GetRangeValues

Guid: {1D69601E-D934-472B-BDCD-13147EE5A3A9}

Anforderung: Microsoft 365 Version 2410 (Build 18129.xxxxx)

Ruft nicht leere Zelladress-Wert-Paare innerhalb des Eingabebereichs in der angegebenen Reihenfolge ab. Zelladress-Wert-Paare werden durch das Eingabetrennzeichen getrennt.

Operand	Rolle	Typ	Beschreibung
3	Input	Zeichenfolge	Zellbereich
4	Input	Zeichenfolge	Trennzeichen zwischen Zelladresse und Zellwert
5	Input	Boolescher Wert	Zeilen- oder Spaltenhauptreihenfolge
6	Ausgabe	StringArray	Zelladress-Wert-Paare

PowerShell-Skript

CustomPatternClient_Excel_Table_Values.ps1

Methoden

GetTableColumnValues

Guid: {1F6DDBC5-F90E-4C07-BE5E-A7322AD3B737}

Anforderung: Microsoft 365 Version 2410 (Build 18129.xxxxx)

Ruft Zelladress-Wert-Paare für die Spalte oder Zeile der Eingabezellenadresse ab. Der Spaltenheaderwert kann wie in der Eingabe angegeben enthalten sein.

Operand	Rolle	Typ	Beschreibung
3	Input	Zeichenfolge	Zelladresse
4	Input	Boolescher Wert	Includeheader
5	Ausgabe	StringArray	Zellenwerte in der Tabellenspalte, die die Eingabezelle enthält

GetTableRowValues

Guid: {03F8C2C6-C58A-4CDF-B8CB-54C198F7525D}

Anforderung: Microsoft 365 Version 2410 (Build 18129.xxxxx)

Ruft Zelladress-Wert-Paare für die Spalte oder Zeile der Eingabezellenadresse ab.

Operand	Rolle	Typ	Beschreibung
3	Input	Zeichenfolge	Zelladresse
4	Ausgabe	StringArray	Zellenwerte in der Tabellenzeile, die die Eingabezelle enthält

Anforderungen

Sofern nicht pro Methode anders angegeben, ist die erforderliche Version: Microsoft 365 Version 2107 (Build 14326.xxxxx)

Siehe auch

UIA_AutomationIdPropertyId

Benutzerdefinierte Eigenschaften, Ereignisse und Steuerelementmuster

Implementieren von benutzerdefinierten Steuerelementmustern

Benutzerdefinierte Excel-Musterclientskripts