Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cette rubrique décrit les modèles de UI Automation personnalisés fournis dans Microsoft Excel pour Windows. Ces modèles peuvent être interrogés et utilisés à partir du nœud fournisseur pour une feuille de calcul Excel spécifique.
À des fins d’expérimentation, nous avons créé des scripts PowerShell spéciaux dans le PowerShell Gallery qui exercent chaque modèle personnalisé Excel. Celles-ci sont explicitement appelées avec chaque modèle, ou vous pouvez rechercher dans le PowerShell Gallery pour CustomPatternClient_Excel voir tous les scripts Excel. Ces scripts peuvent être exécutés dans une fenêtre PowerShell sur une instance d’Excel en cours d’exécution sur Windows 11 pour voir quelle sortie les modèles personnalisés produisent. Les scripts sont auto-documentés avec une aide basée sur les commentaires.
L’objectif main de ces modèles est de fournir des informations de feuille qui ne sont pas contraintes à la zone visible de la feuille. Les noms et les plages sont le mode de communication, plutôt que les objets d’accessibilité. Pour les cellules, le nom utilisé dans ces modèles est également disponible en tant que UIA_AutomationIdPropertyId.
Opérandes communs à toutes les méthodes
Il existe 3 opérandes d’entrée fixes pour chaque appel de méthode de modèle personnalisé.
| Opérande | Type | Description |
|---|---|---|
| 0 | ConnectBoundObject | Objet Pattern |
| 1 | GUID | Guid de la méthode |
| 2 | Int32 | Nombre total d’arguments d’entrée et de sortie |
Valeurs de retour
Chaque méthode décrite ici retourne un HRESULT pour callExtension afin d’indiquer la réussite ou l’échec. Une opération réussie retourne S_OK et une opération ayant échoué génère UIA_E_INVALIDOPERATON.
ISheetCellInventory
Description
Guid: {654823FE-A483-4915-8709-67266866E518}
Il s’agit d’un modèle dans une feuille de calcul qui collecte des cellules qui correspondent à certaines caractéristiques. Dans tous les cas, ils retournent une collection de chaînes qui sont des noms de cellules
PowerShell Script
CustomPatternClient_Excel_Cell_Inventory.ps1
Méthodes
GetCellsWithFormula
Guid: {24E137F2-4FFF-4F50-84AD-2ACD780E7E1F}
Retourne les noms des cellules de la feuille de calcul qui ont des formules
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Sortie | StringArray | Noms des cellules |
GetCellsWithHyperlink
Guid: {B640F40E-E51A-4CDD-9604-843AA5107C1C}
Retourne les noms des cellules qui ont des hyperlnks littéraux. En d’autres termes, les cellules avec une valeur qui est une URL.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Sortie | StringArray | Noms des cellules |
GetCellsWithFormulaHyperlink
Guid: {0AAF2B49-015B-4AB3-A093-21F055E8E0F5}
Retourne les noms des cellules qui ont des hyperlnks de formule. En d’autres termes, les cellules qui utilisent la fonction HYPERLINK dans leur formule.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Sortie | StringArray | Noms des cellules |
GetCellsWithNote
Guid: {8F171892-A3B1-4F92-9CE1-CE818B848F52}
Retourne les noms des cellules auxquelles une note ou un commentaire hérité nonthreaded leur est associé.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Sortie | StringArray | Noms des cellules |
GetCellsWithComment
Guid: {4D4E49BC-CE16-44CD-AC48-1DAA2E862C41}
Retourne les noms des cellules auxquelles sont associés des commentaires à threads.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Sortie | StringArray | Noms des cellules |
ISheetRangeInventory
Description
Guid: {62F8DBCE-13DC-4EF2-AF53-5247ED2A4980}
Ce modèle de feuille de calcul collecte des plages de cellules. Ces méthodes retournent une collection de chaînes qui représentent une plage de cellules. La plage peut être décrite par son nom (le cas échéant) et éventuellement par la référence de plage de cellules, séparée du nom par une chaîne de délimiteur d’entrée.
PowerShell Script
CustomPatternClient_Excel_Range_Inventory.ps1
Méthodes
GetTableNamesAndRanges
Guid: {3FB8E49A-BB4A-4B6C-8B25-CB7E612DA92E}
Obtient les noms des tables de liste et leurs plages si demandé. Les spécifications de plage sont séparées du nom de la table par la chaîne de délimiteur d’entrée.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Input | Boolean | Inclure des spécifications de plage |
| 4 | Input | String | Séparateur de champ de nom et de plage |
| 5 | Sortie | StringArray | Noms de plages et références si demandé |
GetPivotTableNamesAndRanges
Guid: {B22CD312-E265-49AE-9C73-11CE3D7B8526}
Obtient les noms des tableaux croisés dynamiques et leurs plages si demandé. Les spécifications de plage sont séparées du nom de la table par la chaîne de délimiteur d’entrée.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Input | Boolean | Inclure des spécifications de plage |
| 4 | Input | String | Séparateur de champ de nom et de plage |
| 5 | Sortie | StringArray | Noms de plages et références si demandé |
GetNamedRanges
Guid: {EFC59F27-E965-48A5-8C79-7BB9E70958FD}
Obtient les plages nommées et leurs spécifications de plage si demandé. Il s’agit de plages de cellules qui ont été nommées à l’aide du gestionnaire de noms et qui n’incluent pas celles qui proviennent de tables. Les spécifications de plage sont séparées du nom de la table par la chaîne de délimiteur d’entrée.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Input | Boolean | Inclure des spécifications de plage |
| 4 | Input | String | Séparateur de champ de nom et de plage |
| 5 | Sortie | StringArray | Noms de plages et références si demandé |
GetUnnamedDataRanges
Guid: {60EBB5D1-299D-471D-8DAB-00EE39EBA79E}
Obtient des plages de cellules avec des données qui ne font pas autrement partie d’une plage ou d’une table nommée.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Sortie | StringArray | Références de plage |
GetRowRangesOnPageBreaks
Guid: {2544B784-764D-4EAA-A72F-BABBF28B5504}
Obtient des références de plage de lignes uniques couvrant la zone imprimable de la feuille de calcul qui précède un saut de page horizontal.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Sortie | StringArray | Références de plage |
GetColumnRangesOnPageBreaks
Guid: {BEA372DC-2FD8-4852-A8BC-2DA34CEA5456}
Obtient des références de plage de colonnes uniques couvrant la zone imprimable de la feuille de calcul qui précède un saut de page vertical.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Sortie | StringArray | Références de plage |
ISheetObjectInventory
Description
Guid: {62F8DBCE-13DC-4EF2-AF53-5247ED2A4980}
Ce modèle de feuille de calcul renvoie une collection d’objets nommés sur la feuille d’un type spécifié.
PowerShell Script
CustomPatternClient_Excel_Object_Inventory.ps1
Méthodes
GetChartNames
Guid: {6D199DC0-7AF0-43CC-A572-8CF9EE556F75}
Obtient les noms des graphiques de la feuille.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Sortie | StringArray | Noms des graphiques |
GetSmartDiagramNames
Guid: {AF8706FA-6389-4F90-9EF8-F64AED618C4F}
Obtient les noms des diagrammes Smart Art sur la feuille.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Sortie | StringArray | Noms des diagrammes |
GetSlicerNames
Guid: {7D6295DF-E9CC-4B86-BE9F-60BACCB7289D}
Obtient les noms des objets de segment sur la feuille.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Sortie | StringArray | Noms des segments |
GetTimeSlicerNames
Guid: {F8768BF3-9733-4BD9-9251-507649FF3257}
Obtient les noms des objets de segment de temps sur la feuille.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Sortie | StringArray | Noms des segments de temps |
GetImageNames
Guid: {A2807141-BA1F-4088-85A1-4C00F140998C}
Obtient les noms des objets image sur la feuille.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Sortie | StringArray | Noms des images |
GetShapeNames
Guid: {C50C4B9E-2F62-4E47-993D-A961D0C6A03D}
Obtient les noms des formes de dessin sur la feuille.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Sortie | StringArray | Noms de formes |
ISheetContentSelect
Description
Guid: {5979E0BC-12AC-4105-B10A-2FD04546E9C2}
Ce modèle permet de sélectionner une cellule, une collection de cellules ou un objet sur la feuille, quel que soit l’état d’affichage actuel. Les cellules qui ne sont pas visibles n’ont aucun élément accessible sur lequel exercer un modèle d’élément de sélection. Ce modèle autorise donc la sélection par nom de cellule. Le nom de la cellule est également la propriété AutomationID si vous souhaitez revenir à une cellule précédemment visitée. Cette méthode permet également de spécifier une plage de cellules à sélectionner au format :. Les objets peuvent également être sélectionnés par leur nom, tel que retourné par ISheetObjectInventory.
PowerShell Script
CustomPatternClient_Excel_Selector.ps1
Méthodes
SelectRange
Guid: {BB66F5D4-795E-4B6E-9D62-F14804FC240C}
Sélectionne et rend visible une cellule ou une plage de cellules sur la feuille.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Input | String | Nom de la cellule, référence de plage ou nom de plage |
SelectObject
Guid: {E36D84D6-B003-47D2-9AC2-9A1B8BA6EB62}
Sélectionne et rend visible un objet sur la feuille.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Input | String | Nom d'objet |
ISheetCellValue
Description
Guid: {238037C4-BBA3-4C0E-9371-66046B81E957}
Ce modèle est utilisé pour récupérer la ou les valeurs actuelles d’une ou plusieurs cellules au sein d’une adresse de cellule, d’une plage ou d’une ligne/colonne de tableau sur la feuille, que la feuille soit visible ou non. La sortie est une chaîne avec la valeur de cellule actuelle ou un tableau de chaînes de paires adresse-valeur de cellule lors de l’interrogation d’une plage ou d’une ligne/colonne de table.
PowerShell Script
CustomPatternClient_Excel_Cell_Value.ps1
Méthodes
GetCellValue
Guid: {4C6CA843-D4F0-4CB6-B1AF-EF8DADEE9B2C}
Obtient la valeur actuelle de la cellule.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Input | String | Nom de la cellule |
| 4 | Sortie | String | Valeur actuelle de la cellule |
PowerShell Script
CustomPatternClient_Excel_Range_Values.ps1
Méthodes
GetRangeValues
Guid: {1D69601E-D934-472B-BDCD-13147EE5A3A9}
Configuration requise : Microsoft 365 version 2410 (build 18129.xxxxx)
Obtient des paires adresse-valeur de cellule non vides dans la plage d’entrée dans l’ordre spécifié. Les paires adresse-valeur de cellule sont séparées par le délimiteur d’entrée.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Input | String | Plage de cellules |
| 4 | Input | String | Délimiteur entre l’adresse de cellule et la valeur de cellule |
| 5 | Input | Boolean | Ordre principal de ligne ou de colonne |
| 6 | Sortie | StringArray | Paires adresse-valeur de cellule |
PowerShell Script
CustomPatternClient_Excel_Table_Values.ps1
Méthodes
GetTableColumnValues
Guid: {1F6DDBC5-F90E-4C07-BE5E-A7322AD3B737}
Configuration requise : Microsoft 365 version 2410 (build 18129.xxxxx)
Obtient les paires adresse-valeur de cellule pour la colonne ou la ligne de l’adresse de cellule d’entrée. La valeur d’en-tête de colonne peut être incluse comme spécifié dans l’entrée.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Input | String | Adresse de la cellule |
| 4 | Input | Boolean | Inclure l’en-tête |
| 5 | Sortie | StringArray | Valeurs de cellule dans la colonne de table contenant la cellule d’entrée |
GetTableRowValues
Guid: {03F8C2C6-C58A-4CDF-B8CB-54C198F7525D}
Configuration requise : Microsoft 365 version 2410 (build 18129.xxxxx)
Obtient les paires adresse-valeur de cellule pour la colonne ou la ligne de l’adresse de cellule d’entrée.
| Opérande | Role | Type | Description |
|---|---|---|---|
| 3 | Input | String | Adresse de la cellule |
| 4 | Sortie | StringArray | Valeurs de cellule dans la ligne du tableau contenant la cellule d’entrée |
Configuration requise
Sauf indication différente selon la méthode, la version requise est : Microsoft 365 Version 2107 (Build 14326.xxxxx)
Voir aussi
Propriétés, événements et modèles de contrôle personnalisés