IMAPIFormAdviseSink::OnChange
Gilt für: Outlook 2013 | Outlook 2016
Gibt an, dass eine Änderung im status des Formular-Viewers aufgetreten ist.
HRESULT OnChange(
ULONG ulDir
);
Parameter
ulDir
[in] Eine Bitmaske von Flags, die Informationen über die Änderung im Viewer und die erwartete Antwort im Formular bereitstellt. Die folgenden Flags können festgelegt werden:
VCSTATUS_CATEGORY
Es gibt eine nächste oder vorherige Meldung in einer anderen Kategorie.
VCSTATUS_INTERACTIVE
Das Formular sollte eine Benutzeroberfläche anzeigen. Wenn dieses Flag nicht festgelegt ist, sollte das Formular die Anzeige einer Benutzeroberfläche unterdrücken, auch als Reaktion auf ein Verb, das normalerweise dazu führt, dass eine Benutzeroberfläche angezeigt wird.
VCSTATUS_MODAL
Das Formular muss für den Formular-Viewer modal sein.
VCSTATUS_NEXT
Im Formular-Viewer wird eine nächste Meldung angezeigt.
VCSTATUS_PREV
Es gibt eine vorherige Meldung im Formular-Viewer.
VCSTATUS_READONLY
Lösch-, Übermittlungs- und Verschiebungsvorgänge sollten deaktiviert sein.
VCSTATUS_UNREAD
Es gibt eine nächste oder vorherige ungelesene Nachricht im Formular-Viewer.
Rückgabewert
S_OK
Die Benachrichtigung war erfolgreich.
Hinweise
Formularanzeiger rufen die IMAPIFormAdviseSink::OnChange-Methode auf, um das Formular über eine Änderung der status eines Viewers zu benachrichtigen. Normalerweise besteht die einzige Änderung darin, das VCSTATUS_NEXT- oder VCSTATUS_PREVIOUS-Flag basierend auf dem Vorhandensein oder Fehlen einer nächsten oder vorherigen Nachricht im Viewer festzulegen oder zu löschen. Entsprechend aktiviert oder deaktiviert das Formularobjekt dann alle nächsten oder vorherigen Aktionen, die es unterstützt.
Die Einstellungen von VCSTATUS_MODAL und VCSTATUS_INTERACTIVE können in einem Ansichtskontext nach der Erstellung nicht mehr geändert werden.
Hinweise für Implementierer
Die spezifische Implementierung dieser Methode hängt vollständig von den Besonderheiten des Formulars ab. Die meisten Formularobjekte verwenden diese Methode, um ihre Benutzeroberfläche zu ändern (z. B. um Menübefehle oder Schaltflächen zu aktivieren oder zu deaktivieren, die dem Viewer status Flags-Parameter entsprechen).