IOleDocument::EnumViews-Methode (docobj.h)

  • Artikel

Erstellt ein -Objekt, das die von einem Dokumentobjekt unterstützten Ansichten aufzählt, oder gibt, wenn nur eine Ansicht unterstützt wird, einen Zeiger auf diese Ansicht zurück.

Syntax

HRESULT EnumViews(
  [out] IEnumOleDocumentViews **ppEnum,
  [out] IOleDocumentView      **ppView
);

Parameter

[out] ppEnum

Ein Zeiger auf eine IEnumOleDocumentViews-Zeigervariable , die den Schnittstellenzeiger auf das Enumeratorobjekt empfängt.

[out] ppView

Ein Zeiger auf eine IOleDocumentView-Zeigervariable , die den Schnittstellenzeiger auf ein einzelnes Ansichtsobjekt empfängt.

Rückgabewert

Diese Methode gibt S_OK zurück, wenn das Objekt mehrere Sichten unterstützt, dann enthält ppEnum einen Zeiger auf das Enumeratorobjekt, und ppView ist NULL. Andernfalls ist ppEnumNULL, und ppView enthält einen Schnittstellenzeiger für die einzelne Ansicht.

Weitere mögliche Rückgabewerte:

Rückgabecode Beschreibung
E_OUTOFMEMORY
 Unzureichender Arbeitsspeicher für den Vorgang.
E_POINTER
 Die Adresse in ppEnum oder ppView ist ungültig. Der Aufrufer muss gültige Zeiger für beide Argumente übergeben.

Hinweise

Wenn ein Dokumentobjekt mehrere Sichten seiner Daten unterstützt, muss es auch IEnumOleDocumentViews implementieren und den Zeiger dieser Schnittstelle im out-Parameter ppEnum übergeben. Mithilfe dieses Zeigers kann der Container die vom Dokumentobjekt unterstützten Ansichten auflisten.

Wenn das Dokumentobjekt nur eine einzelne Ansicht unterstützt, übergibt IOleDocument::EnumViews den IOleDocumentView-Zeiger dieser Ansicht im out-Parameter ppView.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile docobj.h

Weitere Informationen

IEnumOleDocumentViews

IOleDocument

IOleDocumentView