IViewObject::Freeze-Methode (oleidl.h)

  • Artikel

Friert die gezeichnete Darstellung eines Objekts ein, sodass sie sich erst ändert, wenn die IViewObject::Unfreeze-Methode aufgerufen wird. Diese Methode wird am häufigsten zum Banddruck verwendet.

Syntax

HRESULT Freeze(
  [in]  DWORD dwDrawAspect,
  [in]  LONG  lindex,
  [in]  void  *pvAspect,
  [out] DWORD *pdwFreeze
);

Parameter

[in] dwDrawAspect

Gibt an, wie das Objekt dargestellt werden soll. Darstellungen umfassen Inhalt, ein Symbol, eine Miniaturansicht oder ein gedrucktes Dokument. Gültige Werte werden der Enumeration DVASPECT entnommen. Weitere Informationen finden Sie in der DVASPECT-Enumeration .

[in] lindex

Der Teil des Objekts, der für den Ziehvorgang relevant ist. Seine Interpretation variiert je nach dwAspect. Weitere Informationen finden Sie in der DVASPECT-Enumeration .

[in] pvAspect

Zeiger auf zusätzliche Informationen zur Ansicht des in dwAspect angegebenen Objekts. Da keiner der aktuellen Aspekte zusätzliche Informationen unterstützt, muss pvAspect immer NULL sein.

[out] pdwFreeze

Zeiger auf den Ort, an dem ein identifizierender DWORD-Schlüssel zurückgegeben wird. Dieser eindeutige Schlüssel wird später verwendet, um das Einfrieren durch Aufrufen von IViewObject::Unfreeze abzubrechen. Dieser Schlüssel ist ein Index, den der Standardcache verwendet, um nachzuverfolgen, welches Objekt eingefroren ist.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode Beschreibung
VIEW_S_ALREADY_FROZEN
 Die Präsentation wurde bereits eingefroren. Der Wert von pdwFreeze ist der Identifizierende Schlüssel des bereits eingefrorenen Objekts.
OLE_E_BLANK
 Präsentation nicht im Cache.
DV_E_LINDEX
 Ungültiger Wert für lindex; Derzeit; Nur -1 wird unterstützt.
DV_E_DVASPECT
 Ungültiger Wert für dwAspect.

Hinweise

Die IViewObject::Freeze-Methode bewirkt, dass das Ansichtsobjekt seine gezeichnete Darstellung einfriert, bis es durch einen nachfolgenden Aufruf von IViewObject::Unfreeze freigegeben wird. Nach dem Aufrufen von IViewObject::Freeze erzeugen nachfolgende Aufrufe von IViewObject::D raw mit denselben Parametern das gleiche Bild, bis IViewObject::Unfreeze aufgerufen wird.

IViewObject::Freeze ist nicht Teil des persistenten Zustands des Objekts und wird nicht fortgesetzt, wenn das Objekt entladen und neu geladen wird.

Diese Methode wird am häufigsten zum Banddruck verwendet.

In einem eingefrorenen Zustand werden keine Ansichtsbenachrichtigungen gesendet. Ausstehende Ansichtsbenachrichtigungen werden auf den nachfolgenden Aufruf von IViewObject::Unfreeze zurückgestellt.

Anforderungen

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

Weitere Informationen

DVASPECT

IViewObject

IViewObject::Unfreeze