IViewObject::Freeze-Methode (oleidl.h)
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 |
|---|---|
|
Die Präsentation wurde bereits eingefroren. Der Wert von pdwFreeze ist der Identifizierende Schlüssel des bereits eingefrorenen Objekts. |
|
Präsentation nicht im Cache. |
|
Ungültiger Wert für lindex; Derzeit; Nur -1 wird unterstützt. |
|
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 |