IAdviseSink::OnViewChange-Methode (objidl.h)

  • Artikel

Benachrichtigt die registrierten Hinweissenken eines Objekts, dass sich seine Ansicht geändert hat.

Syntax

void OnViewChange(
  [in] DWORD dwAspect,
  [in] LONG  lindex
);

Parameter

[in] dwAspect

Der Aspekt oder die Ansicht des Objekts. Enthält einen Wert aus der DVASPECT-Enumeration .

[in] lindex

Der Teil der Ansicht, die sich geändert hat. Derzeit ist nur -1 gültig.

Rückgabewert

Keine

Bemerkungen

Container registrieren sich, um benachrichtigt zu werden, wenn sich die Ansicht eines Objekts ändert, indem sie IViewObject::SetAdvise aufrufen. Nach der Registrierung ruft das Objekt ggf. die IAdviseSink::OnViewChange-Methode der Senke auf. OnViewChange kann aufgerufen werden, wenn sich das Objekt im geladenen oder ausgeführten Zustand befindet.

Auch wenn es sich bei DVASPECT-Werten um einzelne Flagbits handelt, kann dwAspect nur einen Wert darstellen. Das heißt, dwAspect kann nicht das Ergebnis eines OR-Vorgangs enthalten, der zwei oder mehr DVASPECT-Werte kombiniert.

Der lindex-Parameter stellt den Teil des Aspekts dar, der von Interesse ist. Der Wert von lindex hängt vom Wert von dwAspect ab. Wenn dwAspect entweder DVASPECT_THUMBNAIL oder DVASPECT_ICON ist, wird lindex ignoriert. Wenn dwAspect DVASPECT_CONTENT ist, muss lindex -1 sein, was angibt, dass die gesamte Ansicht von Interesse ist und der einzige aktuell gültige Wert ist.

Anforderungen

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

Weitere Informationen

Iadvisesink

IViewObject::SetAdvise