IMAPIViewContext::ActivateNext

Artikel
04/04/2023

Gilt für: Outlook 2013 | Outlook 2016

Aktiviert die nächste oder vorherige Nachricht in der Ansichtsreihenfolge.

HRESULT ActivateNext(
ULONG ulDir,
LPCRECT prcPosRect
);

Parameter

ulDir

[in] Statusflags, die Informationen über die zu aktivierende Nachricht enthalten. Gültige Flageinstellungen sind:

VCDIR_CATEGORY: Der Viewer sollte eine Nachricht in einer anderen Kategorie der Ansicht aktivieren. Die zu aktivierende Nachricht lautet:
- Die erste Nachricht in der nächsten Ansichtskategorie, wenn dieses Flag ORmit VCDIR_NEXT ist.
- Die letzte Meldung in der vorherigen Ansichtskategorie, wenn dieses Flag ORmit VCDIR_PREV ist und die vorherige Kategorie erweitert wird.
- Die erste Meldung in der vorherigen Ansichtskategorie, wenn dieses Flag ORmit VCDIR_PREV ist und die vorherige Kategorie nicht erweitert ist. In diesem Fall wird die vorherige Kategorie automatisch erweitert.
VCDIR_DELETE: Der Viewer sollte die nächste oder vorherige Nachricht aktivieren, da die aktuelle Nachricht gelöscht wurde.
VCDIR_MOVE: Der Viewer sollte die nächste oder vorherige Nachricht aktivieren, da die aktuelle Nachricht verschoben wurde.
VCDIR_NEXT: Der Viewer sollte die nächste Nachricht in der Ansichtsreihenfolge aktivieren.
VCDIR_PREV: Der Viewer sollte die vorherige Meldung in der Ansichtsreihenfolge aktivieren.
VCDIR_UNREAD: Der Viewer sollte die nächste oder vorherige ungelesene Nachricht in der Ansichtsreihenfolge aktivieren.

prcPosRect

[in] Zeiger auf eine Windows RECT-Struktur , die die Größe und Position des Fensters enthält, das zum Anzeigen der aktivierten Meldung verwendet werden soll.

Rückgabewert

S_OK

Die Nachricht wurde erfolgreich aktiviert.

S_FALSE

Die Nachricht wurde erfolgreich aktiviert, aber im Prozess wurde ein anderer Formulartyp geöffnet.

Hinweise

Formularobjekte rufen die IMAPIViewContext::ActivateNext-Methode auf, um zu ändern, welche Meldung dem Benutzer angezeigt wird. Der im ulDir-Parameter übergebene Wert gibt an, welche Nachricht aktiviert werden soll und in einigen Fällen auch warum. Die flags VCDIR_NEXT und VCDIR_PREVIOUS entsprechen benutzern, die den Befehl Weiter bzw . Zurück in einer Ansicht auswählen. Diese Vorgänge entsprechen in der Regel dem Verschieben einer Nachricht in der Nachrichtenliste des Formular-Viewers nach oben oder unten.

Die flags VCDIR_DELETE und VCDIR_MOVE werden jeweils durch die Methoden IMAPIMessageSite::D eleteMessage und IMAPIMessageSite::MoveMessage festgelegt. Implementierungen dieser Methoden rufen ActivateNext mit der entsprechenden Richtung auf und führen dann den angeforderten Vorgang für die Nachricht aus, wenn der ActivateNext-Aufruf nicht fehlgeschlagen ist. Formularanzeigen ermöglichen es Benutzern in der Regel, die Richtung anzugeben, die in der Nachrichtenliste verschoben werden soll.

Hinweise für Implementierer

Ihre Implementierung von IMAPIViewContext::ActivateNext erstellt die nächste oder vorherige Nachricht im Ordner, abhängig vom Wert von ulDir, der aktuellen Nachricht. Rufen Sie nach der Rückgabe von ActivateNextIMAPIMessageSite::GetMessage auf, um einen Zeiger auf die neu aktivierte Nachricht zu erhalten.

Hinweise für Aufrufer

Wenn ActivateNext S_FALSE zurückgibt oder keine aktuelle Nachricht vorhanden ist, führen Sie ihre normale Herunterfahren-Prozedur aus, die den Aufruf der IMAPIForm::ShutdownForm-Methode Ihres Formulars umfassen sollte. Wenn eine nächste oder vorherige Meldung angezeigt wird, verwenden Sie das Fensterrechteck, das im prcPosRect-Parameter übergeben wird, um es anzuzeigen.

MFCMAPI-Referenz

Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.

Datei	Funktion	Kommentar
MyMAPIFormViewer.cpp	CMyMAPIFormViewer::ActivateNext	MFCMAPI implementiert die IMAPIViewContext::ActivateNext-Methode in dieser Funktion.

Freigeben über