IMAPIForm::SetViewContext
Gilt für: Outlook 2013 | Outlook 2016
Richtet einen Ansichtskontext für das Formular ein.
HRESULT SetViewContext(
LPMAPIVIEWCONTEXT pViewContext
);
Parameter
pViewContext
[in] Ein Zeiger auf den neuen Ansichtskontext für das Formular.
Rückgabewert
S_OK
Der Ansichtskontext wurde erfolgreich festgelegt.
Hinweise
Formular-Viewer rufen die IMAPIForm::SetViewContext-Methode auf, um einen bestimmten Formularansichtskontext als aktuell festzulegen. Ein Formular kann jeweils nur einen Ansichtskontext aufweisen.
Hinweise für Implementierer
Die meisten Formularserver implementieren SetViewContext mithilfe des folgenden Algorithmus:
Wenn bereits ein Ansichtskontext für das Formular vorhanden ist, brechen Sie die Registrierung des Formulars ab, indem Sie die IMAPIViewContext::SetAdviseSink-Methode mit null im pmnvs-Parameter aufrufen, und rufen Sie dann die IUnknown::Release-Methode des Ansichtskontexts auf, um die Verweisanzahl zu verringern.
Wenn der neue Ansichtskontext nicht NULL ist, rufen Sie IMAPIViewContext::SetAdviseSink auf, indem Sie den pViewContext-Parameter verwenden, um eine neue Ansichtssenke einzurichten.
Wenn der neue Ansichtskontext nicht NULL ist, rufen Sie die IMAPIViewContext::GetViewStatus-Methode auf, um zu bestimmen, welche status Flags festgelegt wurden.
Wenn der neue Ansichtskontext nicht NULL ist, speichern Sie ihn, und rufen Sie die IUnknown::AddRef-Methode auf, um die Verweisanzahl zu erhöhen.
Aktualisieren Sie alle Benutzeroberflächenelemente, die vom Ansichtskontext abhängen.
Abhängig von den status flags, die von IMAPIViewContext::GetViewStatus zurückgegeben werden, kann SetViewContext auch andere Aktionen ausführen. Wenn beispielsweise die Flags VCSTATUS_NEXT und VCSTATUS_PREV zurückgegeben werden, kann SetViewContext die Schaltflächen Weiter und Zurück für den neuen Ansichtskontext aktivieren.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MAPIFormFunctions.cpp |
CreateAndDisplayNewMailInFolder |
MFCMAPI verwendet die IMAPIForm::SetViewContext-Methode , um den MFCMAPI-Ansichtskontext auf dem Formular festzulegen, bevor das Formular angezeigt wird. |
Siehe auch
IMAPIViewContext::GetViewStatus