_TableView.GetTable Méthode

Définition

Espace de noms:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

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

public:
 Microsoft::Office::Interop::Outlook::Table ^ GetTable();

public Microsoft.Office.Interop.Outlook.Table GetTable ();

Public Function GetTable () As Table

Retours

Table

Renvoie un objet Tabledont les lignes représentent des éléments dans la vue de table actuelle.

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 GetTable(Object, Object) méthode de l’objet Folder , qui obtient un objet table qui contient des éléments du même dossier.

L’objet TableView parent doit être basé sur le dossier actif de l’explorateur actif, comme indiqué par la CurrentFolder propriété de l’objet actif Explorer . 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 CurrentView propriété , n’est pas une vue de table, Outlook renvoie une erreur.

Le filtre de la table résultante est défini par la Filter propriété 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 Restrict(String) méthode 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 Filter.

GetTable renvoie un Table avec le jeu de colonnes par défaut. GetTable ne retourne pas de table qui contient des colonnes pour chaque champ de la ViewFields collection 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 l’ensemble de colonnes par défaut, utilisez les Add(String)méthodes , Remove(Object)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 de la table retournée par GetTable, utilisez la Sort(String, Object) méthode 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 Views collection et l’objet parent de la collection Views est l’objet Folder .