{"id":55000305,"date":"2022-04-01T00:00:00","date_gmt":"2023-08-30T13:11:10","guid":{"rendered":"http:\/\/access-im-unternehmen.aix-dev.de\/aiu\/?p=305"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-30T00:00:00","slug":"Outlook_Die_ApplicationKlasse","status":"publish","type":"post","link":"https:\/\/vbentwickler.de\/Outlook_Die_ApplicationKlasse\/","title":{"rendered":"Outlook: Die Application-Klasse"},"content":{"rendered":"

\"\"<\/p>\n

Die Basisklasse einer jeden Office-Anwendung heißt “Application”. Diese stellt je nach Anwendung verschiedene Eigenschaften, Methoden und Ereignisse bereit. Das ist auch im Objektmodell von Outlook der Fall. Hier finden wir beispielsweise die Möglichkeit für den Zugriff auf die “Explorer”- und “Inspector”-Elemente von Outlook, auf die kompletten E-Mails, Kontakte, Termine et cetera über die “GetNamespace”-Funktion oder das wichtige Ereignis “Startup”, mit dem wir gleich beim Start von Outlook wichtige, selbst programmierte Aktionen ausführen können. Dieser Artikel stellt die verschiedenen Member der Application-Klasse vor und beschreibt, was wir mit diesen alles erledigen können.<\/b><\/p>\n

Application-Klasse im Objektkatalog ansehen<\/h2>\n

Einen ersten Überblick über die Member einer Klasse kann man sich immer im Objektkatalog des VBA-Editors veschaffen. Dazu wechseln wir von Outlook mit der Tastenkombination Alt + F11 <\/b>zum VBA-Editor und öffnen dort mit dem Menübefehl Ansicht|Objektkatalog <\/b>oder mit der Tastenkombination F2<\/b> den Objektkatalog. Hier finden wir in der linken Liste mit der Überschrift Klassen <\/b>den Eintrag Application<\/b> vor, den wir anklicken. Dies zeigt in der rechten Liste die Eigenschaften, Methoden und Ereignisse dieser Klasse an (siehe Bild 1).<\/p>\n

\"Der<\/p>\n

Bild 1: Der Objektkatalog des VBA-Editors von Outlook<\/span><\/b><\/p>\n

Wir beschreiben nachfolgend nur die Elemente, die im Rahmen der in diesem Magazin vorgestellten Lösungen sinnvoll einsetzbar sind.<\/p>\n

Eigenschaften der Application-Klasse<\/h2>\n

Die Application<\/b>-Klasse bietet die folgenden Eigenschaften an. Um diese auszuprobieren, öffnen wir einfach den VBA-Editor und wechseln dann mit Strg + G <\/b>zum Direktbereich, wo wir die Werte der Eigenschaften durch Voranstellen von Debug.Print <\/b>abfragen können:<\/p>\n

    \n
  • Application<\/b>: Liefert einen Verweis auf die Application<\/b>-Klasse selbst.<\/li>\n
  • Class<\/b>: Liefert einen Wert der Enumeration olObjectClass <\/b>für das jeweilige Objekt zurück, im Falle von Outlook.Application <\/b>den Wert 0 <\/b>(olApplication<\/b>).<\/li>\n
  • COMAddIns<\/b>: Auflistung der COM-Add-Ins, die aktuell für diese Outlook-Instanz installiert sind. Count <\/b>liefert die Anzahl der COM-Add-Ins, und mit der Item<\/b>-Eigenschaft können wir auf die einzelnen COM-Add-Ins zugreifen. Der Index ist dabei 1<\/b>-basiert.<\/li>\n
  • DefaultProfileName<\/b>: Diese Eigenschaft liefert den Namen des aktuell verwendeten Outlook-Profils zurück. Dieser wird in einem Dialog festgelegt, den wir über die Systemsteuerung öffnen, wenn wir dort Mail (Microsoft Outlook) <\/b>aufrufen und im nun erscheinenden Dialog Mail-Setup <\/b>auf Profile anzeigen… <\/b>klicken (siehe Bild 2).<\/li>\n

    \"Verwalten<\/p>\n

    Bild 2: Verwalten von Outlook-Profilen<\/span><\/b><\/p>\n

  • Explorers<\/b>: Auflistung der geöffneten Explorer<\/b>-Fenster. Ein Explorer<\/b>-Fenster ist das Fenster, in dem der Inhalt eines Outlook-Ordners angezeigt wird. Explorers <\/b>liefert mit Count <\/b>die Anzahl und mit Item (Index) <\/b>die jeweiligen Instanzen von Explorer<\/b>.<\/li>\n
  • Inspectors<\/b>: Auflistung der geöffneten Inspector<\/b>-Fenster. Ein Inspector<\/b>-Fenster öffnen wir beispielsweise, wenn wir doppelt auf eine E-Mail oder einen Termin in einem der Explorer<\/b>-Fenster klicken. Inspectors <\/b>liefert mit Count <\/b>die Anzahl und mit Item(Index) <\/b>einen Verweis auf das jeweilige Inspector<\/b>-Fenster.<\/li>\n
  • IsTrusted<\/b>: Gibt an, ob die abfragende Instanz als vertrauenswürdig eingestuft ist. Das ist nur der Fall, wenn der Aufruf vom Outlook-VBA-Projekt erfolgt oder aus einem dort registrierten COM-Add-In.<\/li>\n
  • LanguageSettings<\/b>: Dient der Prüfung, ob eine Sprache als Bearbeitungssprache verwendet wird (zum Beispiel durch Ausgabe von Application.LanguageSettings.LanguagePreferredForEditing(msoLanguageIDGerman) <\/b>zur Prüfung der deutschen Sprache) oder welche die aktuelle Sprache der Benutzeroberfläche ist (Application.LanguageSettings.LanguageID(msoLanguageIDUI)<\/b> liefert für die deutsche Sprache beispielsweise den Wert 1031 <\/b>gleich msoLanguageIDGerman<\/b>)<\/li>\n
  • Name<\/b>: Liefert im Falle von Outlook immer Outlook<\/b>.<\/li>\n
  • Parent<\/b>: Liefert einen Verweis auf das übergeordnete Objekt. Ist für Application.Parent <\/b>leer und liefert beim Versuch der Ausgabe einen Fehler. Deshalb vorher beispielsweise mit Application.Parent Is Nothing <\/b>prüfen.<\/li>\n
  • ProductCode<\/b>: Gibt den Produktcode für Outlook zurück, zum Beispiel {90160000-000F-0000-0000-0000000FF1CE}<\/b>.<\/li>\n
  • Reminders<\/b>: Auflistung aller offenen Erinnerungen. Diese werden durch Termine mit Erinnerung erstellt. Count <\/b>liefert die Anzahl, und über die Item(Index)<\/b>-Eigenschaft können wir auf die einzelnen Elemente zugreifen.<\/li>\n
  • Session<\/b>: Liefert einen Verweis auf die aktuelle Namespace<\/b>-Klasse, üblicherweise namens Mapi<\/b>. Diese erlaubt den Zugriff auf viele weitere Elemente wie die Folder<\/b>-Elemente mit E-Mails, Terminen, Aufgaben, Kontakten et cetera oder Methoden zum Erstellen neuer Objekte. Das Namespace<\/b>-Objekt sehen wir uns in einem eigenen Artikel an.<\/li>\n
  • TimeZones<\/b>: Auflistung der TimeZone<\/b>-Elemente, die Informationen über verschiedenen Zeitzonen liefern.<\/li>\n
  • Version<\/b>: Liefert die Version von Outlook, zum Beispiel 16.0.0.15505<\/b>.<\/li>\n<\/ul>\n

    Methoden der Application-Klasse<\/h2>\n

    Die Application<\/b>-Klasse bietet die folgenden Methoden an, die teils Function<\/b>– und teils Sub<\/b>-Methoden sind.<\/p>\n

    Teilweise liefern die Methoden also Ergebnisse als Rückgabewert, und einige wenige, wie Quit<\/b>, führen nur eine Aktion aus:<\/p>\n

      \n
    • ActiveExplorer<\/b>: Liefert einen Verweis auf das oberste Explorer<\/b>-Objekt auf dem Desktop. Liefert Nothing<\/b>, wenn kein Explorer<\/b>-Objekt geöffnet ist. Wir können uns beispielsweise mit der Caption<\/b>-Eigenschaft den Namen des aktuell angezeigten Folder-Elements ausgeben lassen: Debug.Print Application.ActiveExplorer.Caption<\/b>.<\/li>\n
    • ActiveInspector<\/b>: Liefert einen Verweis auf das aktuell aktive Inspector<\/b>-Element, sofern überhaupt eines geöffnet ist. Ein Inspector<\/b>-Element zeigt beispielsweise eine E-Mail, einen Termin oder einen Kontakt in einem eigenen Fenster an, nachdem wir diesen per Doppelklick im jeweiligen Explorer geöffnet haben. Anderenfalls liefert ActiveInspector <\/b>den Wert Nothing<\/b>.<\/li>\n
    • ActiveWindow<\/b>: Liefert einen Verweis auf das aktuell oberste Fenster von Outlook, unabhängig davon, ob es sich dabei um ein Explorer<\/b>– oder ein Inspector<\/b>-Element handelt. Um herauszufinden, ob es sich bei dem von ActiveWindow <\/b>gelieferten Fenster um eines des Typs Explorer <\/b>oder Inspector <\/b>handelt, können Sie beispielsweise mit TypeOf Application.ActiveWindow Is Explorer <\/b>auf den Typ Explorer <\/b>prüfen oder mit TypeOf Application.ActiveWindow Is Inspector <\/b>auf Inspector<\/b>.<\/li>\n
    • AdvancedSearch<\/b>: Erlaubt das Definieren und Ausführen einer Suche in den Objekten eines angegebenen Ordners gegebenenfalls samt Unterordnern nach dem gewünschten Suchbegriff. Liefert eine Results<\/b>-Auflistung durch, die alle Elemente entsprechend der Suchkriterien enthält. Ein Beispiel schauen wir uns weiter unten an.<\/li>\n
    • CopyFile<\/b>: Mit dieser Methode kopieren wir eine Datei, deren Pfad wir mit dem ersten Parameter angeben, in das mit dem zweiten Parameter angegebenen Outlook-Ordner. Die hineinkopierte Datei landet dann beispielsweise zusammen mit den vorhandenen E-Mails im Ordner Posteingang<\/b>, wenn wir diesen angebe.<\/li>\n
    • CreateItem<\/b>: Mit der CreateItem<\/b>-Methode erstellen wir neue Elemente, beispielsweise E-Mails, Kontakte et cetera. Mit dem Parameter, beispielsweise olMailItem<\/b>, geben wir den Typ des zu erstellenden Elements an. Die Funktion gibt einen Objektverweis auf das neu erstellte Objekt zurück. Wir zeigen dies weiter unten am Beispiel einer E-Mail. Für weitere zu erstellende Typen verwenden wir die folgenden Konstanten als Parameter: olAppointmentItem <\/b>(Termin), olContactItem <\/b>(Kontakt), olJournalItem <\/b>(Journaleintrag), olNoteItem <\/b>(Notiz), olPostItem <\/b>(Posting) oder olTaskItem <\/b>(Aufgabe).<\/li>\n
    • CreateItemFromTemplate<\/b>: Erstellt neue Elemente wie E-Mails, Kontakte et cetera auf Basis der angegebenen Vorlage. Der erste Parameter nimmt den Pfad zu der Vorlagendatei entgegen, der zweite den Ordner, in dem das neue Element abgelegt werden soll. Wird dieser Parameter nicht angegeben, landet das Element im Standardordner für dieses Element.<\/li>\n
    • CreateObject<\/b>: Erlaubt das Erstellen von Instanzen anderer Anwendungen, beispielsweise mit CreateObject(“Word.Application”)<\/b>. Das gelingt jedoch unter Verwendung von Early Binding auch mit New Word.Application<\/b>.<\/li>\n
    • GetNamespace<\/b>: Methode, um ein Namespace zu referenzieren. Normalerweise bezieht sich dies immer auf das Mapi-Namespace, wozu man diesen als Parameter angibt: GetNamespace(“MAPI”)<\/b>. Das Namespace<\/b>-Element liefert noch viele weitere Elemente für den Zugriff auf Outlook-Ordner und die darin enthaltenen Elemente wie E-Mails, Kontakte, Termine et cetera, die wir in einem eigenen Artikel untersuchen.<\/li>\n
    • Quit<\/b>: Beendet die aktuelle Outlook-Instanz.<\/li>\n<\/ul>\n

      Er<\/b>eignisse der Application-Klasse<\/h2>\n

      Die Application<\/b>-Klasse stellt die folgenden Ereignisse bereit, die durch Ereignisprozeduren implementiert werden können:<\/p>\n

        \n
      • AdvancedSearchComplete<\/b>: Wird ausgelöst, wenn eine Suche mit der Methode AdvancedSearch <\/b>gestartet wurde die Suche beendet ist. Wie dies mit AdvancedSearch <\/b>und auch mit dem nachfolgend beschriebenen Ereignis AdvancedSearchStopped<\/b> zusammenspielt, schauen wir uns in einem separaten Artikel namens Outlook: Elemente durchsuchen mit AdvancedSearch <\/b>(www.vbentwickler.de\/306<\/b>) an.<\/li>\n
      • AdvancedSearchStopped<\/b>: Wird ausgelöst, wenn eine mit AdvancedSearch <\/b>ausgelöste Suche gestoppt wird, bevor sie vollständig ist. Siehe auch das vorherige Ereignis AdvancedSearchComplete<\/b>.<\/li>\n
      • ItemLoad<\/b>: Wird ausgelöst, wenn ein Element geladen wird, beispielsweise weil es beim Anzeigen eines Ordners als erstes Element der Liste im Explorer automatisch markiert wird oder weil der Benutzer es im Explorer anklickt. Dieses Ereignis liefert mit dem Parameter Item <\/b>einen Verweis auf das geladene Element, welches aber noch nicht vollständig geladen ist. So können wir nur auf die beiden Eigenschaften Class <\/b>und MessageClass <\/b>zugreifen, wir können also gerade mal identifizieren, um was für ein Element es sich handelt. Das reicht jedoch, um es mit einer Objektvariablen zu referenzieren, die wir mit WithEvents <\/b>deklarieren und für die wir beispielsweise das Read<\/b>-Ereignis implementieren. Dieses wird augelöst, wenn der Explorer das Element zum Lesen anzeigt – und dann können wir auch weitere Eigenschaften wie Subject <\/b>oder Body <\/b>auslesen.<\/li>\n
      • ItemSend<\/b>: Wird immer ausgelöst, wenn ein Outlook-Element gesendet wird, entweder durch Betätigen der Senden<\/b>-Schaltfläche einer E-Mail über die Benutzeroberfläche oder auch durch Verwenden der Send<\/b>-Methode eines MailItem<\/b>-Elements unter VBA. Es bietet zwei Parameter: Der erste namens Item <\/b>liefert einen Verweis auf das zu sendende MailItem<\/b>-Element und der zweite namens Cancel <\/b>erwartet einen Boolean<\/b>-Wert, der angibt, ob das Senden abgebrochen werden soll. Damit können wir beispielsweise noch prüfen, ob alle notwendigen Daten angegeben wurden und gegebenenfalls den Benutzer per Meldung über fehlende Informationen benachrichtigen und den Versand abbrechen.<\/li>\n
      • NewMail<\/b>: Wird ausgelöst, wenn eine oder mehrere neue E-Mails im Posteingang landen und bevor vom Benutzer definierte Regeln zur Weiterleitung von E-Mails in andere Ordner greifen. Dieses Ereignis hat jedoch nur geringen Wert, da es keinerlei Parameter mit Informationen über die eingegangenen E-Mails enthält. Wie wir eingegangene E-Mails weiterverarbeiten können, liest Du im Artikel Outlook: E-Mails nach Eingang verarbeiten <\/b>(www.vbentwickler.de\/308<\/b>).<\/li>\n
      • NewMailEx<\/b>: Wird für jede einzelne E-Mail ausgelöst, die im Posteingang landet. Dieses Ereignis liefert mit dem Parameter EntryIDCollection <\/b>eine Zeichenkette mit dem Werte der Eigenschaft EntryID <\/b>der eingegangenen E-Mails. Damit erlaubt dieses Ereignis, die E-Mails vor der Verarbeitung durch Regeln et cetera zu untersuchen. Wie wir eingegangene E-Mails weiterverarbeiten können, liest Du im Artikel Outlook: E-Mails nach Eingang verarbeiten <\/b>(www.vbentwickler.de\/308<\/b>).<\/li>\n
      • Quit<\/b>: Wird beim Schließen von Outlook ausgelöst. Für dieses Ereignis könnten wir Anweisungen für abschließende Arbeiten implementieren. Es bietet keinen Cancel<\/b>-Parameter, um das Beenden abzubrechen.<\/li>\n
      • Reminder<\/b>: Der Reminder-Ereignis wird immer ausgelöst, bevor dem Benutzer eine Erinnerung von Outlook angezeigt wird.<\/li>\n
      • Startup<\/b>: Dies ist eines der wichtigsten Ereignisse von Outlook. Es wird direkt beim Start der Outlook-Anwendung ausgelöst und wir können es beispielsweise dazu verwenden, verschiedene Outlook-Elemente mit entsprechenden Variablen und dem Schlüsselwort WithEvents <\/b>zu referenzieren, um dann Ereignisprozeduren für diese Elemente zu implementieren. Eine Menge Beispiele dazu findest Du im Artikel Outlook: Explorer automatisieren <\/b>(www.vbentwickler.de\/307<\/b>).<\/li>\n<\/ul>\n

        Zusammenfassung und Ausblick<\/h2>\n

        Bereits das Application<\/b>-Objekt von Outlook bietet einige wichtige Eigenschaften, Methoden und Ereignisse. Viele davon liefern jedoch erst die Elemente mit den wirklich interessanten Features. Deshalb beschreiben wir diese in eigenen Artikeln. <\/p>\n

        Zum Beispiel schauen wir uns im Artikel Outlook: Explorer automatisieren <\/b>(www.vbentwickler.de\/307<\/b>) an, wie wir die einzelnen Elemente der Benutzeroberfläche von Outlook wie die Explorer- oder Inspector<\/b>-Elemente sowie die durch die Explorer<\/b>-Elemente dargestellten Folder<\/b>-Elemente und die in den Ordnern enthaltenen Elemente referenzieren und programmieren können.<\/p>\n

        In einem weiteren Artikel namens Outlook: Elemente durchsuchen mit AdvancedSearch <\/b>(www.vbentwickler.de\/306<\/b>) zeigen wir, wie die zuvor vorgestellte Methode AdvancedSearch<\/b> und die dadurch ausgelösten Ereignisse AdvancedSearchComplete<\/b> und AdvancedSearchStopped <\/b>verwendet werden können.<\/p>\n

        Spannend ist auch der Artikel Outlook: E-Mails nach Eingang verarbeiten <\/b>(www.vbentwickler.de\/308<\/b>), in dem wir die Ereignisse NewMail und NewMailEx des Application-Objekts beschreiben sowie alternativ das Ereignis ItemAdded <\/b>der Items<\/b>-Auflistung eines Outlook-Ordners, in diesem Fall des Posteingangs.<\/p>\n

        Und im Artikel E-Mails per VBA erstellen mit CreateItem <\/b>(www.vbentwickler.de\/309<\/b>) zeigen wir, wie wir neue E-Mails per Code erstellen und diese dann entweder zur weiteren Bearbeitung anzeigen oder direkt versenden.<\/p>\n","protected":false},"excerpt":{"rendered":"

        Die Basisklasse einer jeden Office-Anwendung heißt “Application”. Diese stellt je nach Anwendung verschiedene Eigenschaften, Methoden und Ereignisse bereit. Das ist auch im Objektmodell von Outlook der Fall. Hier finden wir beispielsweise die Möglichkeit für den Zugriff auf die “Explorer”- und “Inspector”-Elemente von Outlook, auf die kompletten E-Mails, Kontakte, Termine et cetera über die “GetNamespace”-Funktion oder das wichtige Ereignis “Startup”, mit dem wir gleich beim Start von Outlook wichtige, selbst programmierte Aktionen ausführen können. Dieser Artikel stellt die verschiedenen Member der Application-Klasse vor und beschreibt, was wir mit diesen alles erledigen können.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_uf_show_specific_survey":0,"_uf_disable_surveys":false,"footnotes":""},"categories":[66022022,662022,44000027,44000026,44000028],"tags":[],"yst_prominent_words":[],"class_list":["post-55000305","post","type-post","status-publish","format-standard","hentry","category-66022022","category-662022","category-Excel_programmieren","category-Outlook_programmieren","category-Word_programmieren"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/vbentwickler.de\/data\/wp\/v2\/posts\/55000305","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vbentwickler.de\/data\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/vbentwickler.de\/data\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/vbentwickler.de\/data\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/vbentwickler.de\/data\/wp\/v2\/comments?post=55000305"}],"version-history":[{"count":0,"href":"https:\/\/vbentwickler.de\/data\/wp\/v2\/posts\/55000305\/revisions"}],"wp:attachment":[{"href":"https:\/\/vbentwickler.de\/data\/wp\/v2\/media?parent=55000305"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/vbentwickler.de\/data\/wp\/v2\/categories?post=55000305"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/vbentwickler.de\/data\/wp\/v2\/tags?post=55000305"},{"taxonomy":"yst_prominent_words","embeddable":true,"href":"https:\/\/vbentwickler.de\/data\/wp\/v2\/yst_prominent_words?post=55000305"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}