Erstellen einer Ansicht
In diesem Beispiel wird die Verwendung der Add(String, OlViewType, OlViewSaveOption)-Methode der Views-Auflistung zum Erstellen einer Ansicht für ein Folder-Objekt veranschaulicht.
Beispiel
Hinweis
Das folgende Codebeispiel ist ein Auszug aus Programming Applications für Microsoft Office Outlook 2007.
Sie können anpassbare Ansichten erstellen, in denen Sie Daten aller Typen im Ansichtsbereich in einem Outlook Explorer-Fenster besser sortieren, gruppieren und anzeigen können. Sie können auch vordefinierte Ansichten programmgesteuert anpassen. Die folgende Tabelle enthält Objekte, die Outlook-Ansichten darstellen.
Objektname |
Beschreibung |
|---|---|
Daten werden als Folge von Bildern elektronischer Visitenkarten angezeigt. |
|
Daten werden in einem Kalenderformat angezeigt. |
|
Daten werden in einer Folge von Karten angezeigt. |
|
Daten werden als Symbole für Windows-Ordner oder Explorer-Symbole angezeigt. |
|
Daten werden in einer einfachen feldbasierten Tabelle angezeigt. |
|
Daten werden in einer anpassbaren linearen Zeitachse angezeigt. |
Sie können mithilfe des View-Objekts auf Eigenschaften und Methoden zugreifen, die für alle Ansichten gelten. Um jedoch auf bestimmte Eigenschaften zugreifen zu können, die nicht für alle Ansichten gelten, müssen Sie das View-Objekt in ein abgeleitetes View-Objekt umwandeln, zu dem die Eigenschaft gehört, auf die Sie zugreifen möchten. Für den Zugriff auf die HeadingsFont -Eigenschaft des Cardview-Objekts müssen Sie das View-Objekt in das CardView-Objekt umwandeln. Wenn Sie ermitteln möchten, welche Art von Ansicht von einem bestimmten View-Objekt dargestellt wird, verwenden Sie die ViewType-Eigenschaft.
Verwenden Sie zum Erstellen einer neuen Ansicht die Add-Methode der Views-Auflistung für ein Folder-Objekt. Legen Sie dann die Sichtbarkeit für die Ansicht zum Zeitpunkt der Erstellung oder zu einem beliebigen Zeitpunkt nach der Erstellung der Ansicht fest. Zum Angeben der Sichtbarkeit der Ansicht zum Zeitpunkt der Erstellung geben Sie eine OlViewSaveOption-Konstante im SaveOption-Parameter der Add-Methode an. Zum Angeben der Sichtbarkeit der Ansicht zu einem späteren Zeitpunkt nach der Erstellung geben Sie eine OlViewSaveOption-Konstante für die SaveOption -Eigenschaft des View-Objekts an.
Durch Hinzufügen einer neuen Ansicht wird das ViewAdd -Ereignis der Views-Auflistung ausgelöst. Passen Sie sie nach ihrer Erstellung programmgesteuert an, indem Sie das View-Objekt in eines der abgeleiteten Objekte umwandeln und dann die gewünschten Änderungen vornehmen. Verwenden Sie die Save-Methode des abgeleiteten View-Objekts oder das View-Objekt, um Änderungen an der Ansicht zu speichern. Verwenden Sie abschließend die Apply-Methode des abgeleiteten View-Objekts oder das View-Objekt, um die Ansicht auf das aktuelle Explorer-Objekt anzuwenden. Dadurch wird das ViewSwitch-Ereignis des Explorer-Objekts ausgelöst.
Im folgenden Codebeispiel fügt CreateMeetingRequestsView die neue Ansicht "Meeting Requests" dem Posteingang des Benutzers hinzu, indem das View-Objekt in ein TableView-Objekt umgewandelt wird. CreateMeetingRequestsView ruft dann die Add-Methode des Views-Objekts ab, dessen Name-Parameter auf "Meeting Requests" und ViewType-Parameter auf olTableView festgelegt ist. Die Filter-Eigenschaft des TableView-Objekts ist auf eine DASL-Zeichenfolge (DAV Searching and Locating) festgelegt, die bewirkt, dass die Ansicht nur angezeigt wird, wenn es Elemente gibt, die "IPM.Schedule" in der Nachrichtenklasse dieses Elements enthalten. Dann wird die neue Ansicht gespeichert und angewendet.
Wenn Sie Visual Studio verwenden, um dieses Codebeispiel zu testen, müssen Sie der Microsoft Outlook 15.0-Objektbibliothekkomponente zuerst einen Verweis hinzufügen und die Outlook-Variable angeben, wenn Sie den Microsoft.Office.Interop.Outlook-Namespace importieren. Die using-Anweisung darf im Codebeispiel nicht direkt vor den Funktionen stehen, sondern muss vor der öffentlichen Class-Deklaration hinzugefügt werden. Die folgende Codezeile zeigt, wie Sie den Import und die Zuweisung in C# vornehmen.
using Outlook = Microsoft.Office.Interop.Outlook;
private void CreateMeetingRequestsView()
{
const string PR_MESSAGE_CLASS =
"http://schemas.microsoft.com/mapi/proptag/0x001A001E";
Outlook.Views views =
Application.Session.GetDefaultFolder(
Outlook.OlDefaultFolders.olFolderInbox).Views;
Outlook.TableView tableView = (Outlook.TableView)
views.Add("Meeting Requests",
Outlook.OlViewType.olTableView,
Outlook.OlViewSaveOption.olViewSaveOptionThisFolderEveryone);
tableView.Filter = "\"" + PR_MESSAGE_CLASS + "\"" +
" like 'IPM.Schedule%'";
tableView.Save();
tableView.Apply();
}