IMAPIViewContext::GetViewStatus
Gilt für: Outlook 2013 | Outlook 2016
Ruft den aktuellen Viewer-status ab.
HRESULT GetViewStatus(
ULONG FAR * lpulStatus
);
Parameter
lpulStatus
[out] Zeiger auf eine Bitmaske von Flags, die die status des Viewers bereitstellen. Die folgenden Flags können festgelegt werden:
VCSTATUS_CATEGORY
Es gibt eine nächste oder vorherige Meldung in einer anderen Kategorie.
VCSTATUS_DELETE
Das Formular ermöglicht das Entfernen von Nachrichten.
VCSTATUS_INTERACTIVE
Das Formular sollte eine Benutzeroberfläche anzeigen. Wenn dieses Flag nicht festgelegt ist, sollte das Formular die Anzeige einer Benutzeroberfläche selbst als Reaktion auf ein Verb unterdrücken, das normalerweise dazu führt, dass eine Benutzeroberfläche angezeigt wird.
VCSTATUS_MODAL
Das Formular ist modal für den Viewer.
VCSTATUS_NEXT
Die Ansicht enthält eine nächste Meldung.
VCSTATUS_PREV
Es gibt eine vorherige Meldung in der Ansicht.
VCSTATUS_READONLY
Die Nachricht soll im schreibgeschützten Modus geöffnet werden. Lösch-, Übermittlungs- und Verschiebungsvorgänge sollten deaktiviert sein.
VCSTATUS_UNREAD
Die Ansicht enthält eine nächste oder vorherige ungelesene Nachricht.
Rückgabewert
S_OK
Die status des Viewers wurde erfolgreich zurückgegeben.
Hinweise
Form-Objekte rufen die IMAPIViewContext::GetViewStatus-Methode auf, um zu bestimmen, ob in einer Formularansicht in einer oder beiden Richtungen weitere Nachrichten aktiviert werden sollen, d. h. in der Richtung, in der ein Next-Befehl Nachrichten aktiviert, in der Richtung, in der ein Vorheriger Befehl Nachrichten aktiviert, oder in beide Richtungen. Der Wert, auf den der lpulStatus-Parameter verweist, wird verwendet, um zu bestimmen, ob die Flags VCSTATUS_NEXT und VCSTATUS_PREV für IMAPIViewContext::ActivateNext gültig sind. Wenn das VCSTATUS_DELETE-Flag festgelegt ist, aber nicht das VCSTATUS_READONLY-Flag, kann die Nachricht mithilfe der IMAPIMessageSite::D eleteMessage-Methode gelöscht werden.
In der Regel deaktivieren Formulare Menübefehle und Schaltflächen, wenn sie für den Kontext des Viewers nicht gültig sind. Ein Viewer kann ein Formular auf eine Änderung in status warnen, indem er seine IMAPIFormAdviseSink::OnChange-Methode aufruft.
Das VCSTATUS_MODAL-Flag wird festgelegt, wenn das Formular modal für das Fenster sein muss, dessen Handle im früheren IMAPIForm::D oVerb-Aufruf übergeben wird. Wenn VCSTATUS_MODAL festgelegt ist, kann das Formular den Thread verwenden, in dem der DoVerb-Aufruf erfolgt ist, bis das Formular geschlossen wird. Wenn VCSTATUS_MODAL nicht festgelegt ist, sollte das Formular für dieses Fenster nicht modal sein und darf den Thread nicht verwenden.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::GetViewStatus |
MFCMAPI implementiert die IMAPIViewContext::GetViewStatus-Methode in dieser Funktion. |