Método IViewObject::Freeze (oleidl.h)
Inmoviliza la representación dibujada de un objeto para que no cambie hasta que se llame al método IViewObject::Unfreeze . El uso más común de este método es para la impresión en bandas.
Sintaxis
HRESULT Freeze(
[in] DWORD dwDrawAspect,
[in] LONG lindex,
[in] void *pvAspect,
[out] DWORD *pdwFreeze
);
Parámetros
[in] dwDrawAspect
Especifica cómo se va a representar el objeto. Las representaciones incluyen contenido, un icono, una miniatura o un documento impreso. Los valores válidos se toman de la enumeración DVASPECT. Consulte la enumeración DVASPECT para obtener más información.
[in] lindex
Parte del objeto que es de interés para la operación de dibujo. Su interpretación varía con dwAspect. Consulte la enumeración DVASPECT para obtener más información.
[in] pvAspect
Puntero a información adicional sobre la vista del objeto especificado en dwAspect. Puesto que ninguno de los aspectos actuales admite información adicional, pvAspect siempre debe ser NULL.
[out] pdwFreeze
Puntero a donde se devuelve una clave DWORD de identificación. Esta clave única se usa más adelante para cancelar la inmovilización mediante una llamada a IViewObject::Unfreeze. Esta clave es un índice que usa la memoria caché predeterminada para realizar un seguimiento de qué objeto está inmovilizado.
Valor devuelto
Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.
| Código devuelto | Descripción |
|---|---|
|
La presentación ya se ha inmovilizado. El valor de pdwFreeze es la clave de identificación del objeto ya inmovilizado. |
|
Presentación no en caché. |
|
Valor no válido para lindex; Actualmente; solo se admite -1. |
|
Valor no válido para dwAspect. |
Comentarios
El método IViewObject::Freeze hace que el objeto de vista inmovilice su representación dibujada hasta que una llamada posterior a IViewObject::Unfreeze la libere . Después de llamar a IViewObject::Freeze, las llamadas sucesivas a IViewObject::D raw con los mismos parámetros producen la misma imagen hasta que se llama a IViewObject::Unfreeze .
IViewObject::Freeze no forma parte del estado persistente del objeto y no continúa entre descargas y recargas del objeto.
El uso más común de este método es para la impresión en bandas.
Mientras se encuentra en un estado inmovilizado, no se envían las notificaciones de vista. Las notificaciones de vista pendientes se aplazan a la llamada posterior a IViewObject::Unfreeze.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | oleidl.h |