TableView.GetTable, méthode (Outlook)

Renvoie un objet Table qui représente tous les éléments Microsoft Outlook contenus dans un objet TableView .

Syntaxe

expression. GetTable

Expression Variable qui représente un objet TableView .

Valeur renvoyée

Objet Table dont les lignes représentent les éléments de l’affichage Tableau actuel.

Remarques

La méthode GetTable de l’objet TableView renvoie une table d’éléments d’un ou de plusieurs dossiers du même magasin ou couvrant plusieurs magasins, dans une vue agrégée. Par exemple, une vue agrégée obtenue par une recherche sur tous les éléments du courrier à l’aide de Recherche instantanée. Ce comportement diffère de la méthode GetTable de l’objet Folder , qui obtient un objet table qui contient des éléments du même dossier.

L’objet parent TableView doit être basé sur le dossier actif de l’explorateur actif, comme indiqué par la propriété CurrentFolder de l’objet Explorer actif. Si le dossier n’est pas un dossier actif d’un explorateur visible, ou si l’affichage de ce dossier, qui est indiqué par la propriété Folder.CurrentView , n’est pas une vue de table, Outlook renvoie une erreur.

Le filtre de la table résultante est défini par la propriété Filter de l’objet TableView . Si la propriété Filter de l’objet TableView n’est pas vide, GetTable renvoie un objet Table avec des lignes qui représentent le sous-ensemble filtré des éléments disponibles dans la vue. Si par la suite, la méthode Table.Restrict est appelée sur la table résultante, l’application de la méthode Restrict équivaut à une opération AND logique avec le filtre représenté par TableView.Filter.

GetTable renvoie un Table avec le jeu de colonnes par défaut. GetTable ne renvoie pas un objet Table qui contient les colonnes de chaque champ de la collection ViewFields de l’affichage actuel. Pour plus d’informations sur le jeu de colonnes par défaut d’un tableau basé sur le type de dossier, voir Propriétés par défaut affichées dans un objet Table. Pour modifier le jeu de colonnes par défaut, utilisez les méthodes Add, Remove ou RemoveAll de l’objet de collection Columns . Les propriétés que vous ne pouvez pas ajouter à une table, car les colonnes sont répertoriées dans Propriétés non prises en charge dans un objet table ou un filtre de table.

L’ordre des lignes dans le tableau obtenu n’est pas garanti être le même que celui des éléments de l’affichage actuel sur lequel repose GetTable. Par exemple, GetTable ne renvoie pas un tableau avec une ligne représentant un en-tête Grouper par de l’affichage. Pour trier les lignes du tableau retourné par GetTable, utilisez la méthode Sort de l’objet Table.

L’objet parent de l’objet Table retourné par GetTable est l’objet TableView. L’objet parent de l’objet TableView est la collection Views, et l’objet parent de la collection Views est l’objet Folder.

Exemple

Le code managé suivant est écrit dans C#. Pour exécuter un exemple de code managé .NET Framework qui doit appeler un modèle COM (Component Object Model), vous devez utiliser un assembly d’interopérabilité qui définit et mappe des interfaces managées avec des objets COM dans la bibliothèque de types de modèle objet. Pour Outlook, vous pouvez utiliser Visual Studio et l’assembly d’interopérabilité de base (PIA) d’Outlook. Avant d’exécuter des exemples de code managé pour Outlook 2013, assurez-vous que vous avez installé le PIA d’Outlook 2013 et que vous avez ajouté une référence au composant Bibliothèque d’objets Microsoft Outlook 15.0 dans Visual Studio. Vous devez utiliser le code suivant dans la ThisAddIn classe d’un complément Outlook (à l’aide des Outils de développement Office pour Visual Studio). L'objet Application dans le code doit être un objet Application Outlook approuvé fourni par ThisAddIn.Globals. Pour plus d’informations sur l’utilisation de l’assembly PIA Outlook pour développer des solutions Outlook managées, consultez bienvenue dans la référence de l’assembly d’interopérabilité principal Outlook sur MSDN.

L'exemple de code suivant obtient un objet Table à partir de l'affichage actuel du dossier Boîte de réception. L’exemple de code définit le dossier actif de l’explorateur actif comme Boîte de réception, puis vérifie que l’affichage actuel de la Boîte de réception soit un affichage Tableau. Après s’être assuré de ces deux conditions, l’exemple de code appelle la méthode TableView.GetTable et affiche chaque élément représenté par chaque dans l’objet Table renvoyé.

private void DemoViewGetTable() 
{ 
 // Obtain the Inbox folder. 
 Outlook.Folder inbox = 
 Application.Session.GetDefaultFolder( 
 Outlook.OlDefaultFolders.olFolderInbox) 
 as Outlook.Folder; 
 
 // Set ActiveExplorer.CurrentFolder to Inbox. 
 // Inbox must be the current folder 
 // for TableView.GetTable to work correctly. 
 Application.ActiveExplorer().CurrentFolder = inbox; 
 
 // Ensure that the current view is a table view. 
 if (inbox.CurrentView.ViewType == 
 Outlook.OlViewType.olTableView) 
 { 
 Outlook.TableView view = 
 inbox.CurrentView as Outlook.TableView; 
 
 // No arguments are needed for View.GetTable. 
 Outlook.Table table = view.GetTable(); 
 
 Debug.WriteLine("View Count=" 
 + table.GetRowCount().ToString()); 
 while (!table.EndOfTable) 
 { 
 // First row in Table. 
 Outlook.Row nextRow = table.GetNextRow(); 
 Debug.WriteLine(nextRow["Subject"] 
 + " Modified: " 
 + nextRow["LastModificationTime"]); 
 } 
 } 
} 

Voir aussi

TableView, objet

Procédure : rechercher et obtenir des éléments dans une vue agrégée

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.