Compartir a través de

Método IPicture::get_CurDC (ocidl.h)

  • Artículo

Recupera el identificador del contexto del dispositivo actual. Esta propiedad solo es válida para imágenes de mapa de bits.

Sintaxis

HRESULT get_CurDC(
  [out] HDC *phDC
);

Parámetros

[out] phDC

Puntero a una variable que recibe el contexto del dispositivo.

Valor devuelto

Este método admite el valor devuelto estándar E_FAIL, así como los siguientes valores.

Código devuelto Descripción
S_OK
 Los bits de atributo se devolvieron correctamente.
E_POINTER
 El valor de phDC no es válido. Por ejemplo, puede ser NULL.

Comentarios

La propiedad CurDC y el método IPicture::SelectPicture existen para eludir las restricciones en Windows; específicamente, que un objeto solo se puede seleccionar en exactamente un contexto de dispositivo a la vez. En algunos casos, un objeto de imagen puede seleccionarse permanentemente en un contexto de dispositivo determinado (por ejemplo, un control puede usar una imagen determinada para un fondo). Para usar esta propiedad de imagen en otro lugar, debe deseleccionarse temporalmente desde su contexto de dispositivo anterior, seleccionarlo en el nuevo contexto de dispositivo para la operación y, a continuación, volver a seleccionarlo en el contexto del dispositivo anterior. El método IPicture::get_CurDC devuelve el identificador de contexto del dispositivo en el que está seleccionada la imagen actualmente. El método IPicture::SelectPicture selecciona la imagen en un nuevo contexto de dispositivo, devolviendo el contexto del dispositivo antiguo y el identificador GDI de la imagen. El autor de la llamada debe seleccionar la imagen en el contexto del dispositivo antiguo cuando el autor de la llamada haya terminado con ella, como es normal para el código de Windows.

Notas a los autores de llamadas

El autor de la llamada siempre posee los contextos de dispositivo pasados entre él y el objeto de imagen. Dado que el objeto picture mantiene una copia de HDC, el autor de la llamada debe usar un contexto de dispositivo de memoria (creado con la función CreateCompatibleDC ) y no un contexto de dispositivo de pantalla (desde GetDC, CreateDC o BeginPaint), porque los contextos del dispositivo de pantalla son un recurso del sistema limitado.

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 ocidl.h

Consulte también

IPicture

IPicture::SelectPicture