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.

Siehe auch

IMAPIViewContext::GetViewStatus

IMAPIViewContext::SetAdviseSink

IMAPIForm : IUnknown

MFCMAPI (engl.) als ein Codebeispiel