Clase CPictureHolder

Implementa una propiedad de imagen que permite al usuario mostrar una imagen en el control.

Sintaxis

class CPictureHolder

Miembros

Constructores públicos

Nombre	Descripción
CPictureHolder::CPictureHolder	Construye un objeto CPictureHolder.

Métodos públicos

Nombre	Descripción
CPictureHolder::CreateEmpty	Crea un objeto CPictureHolder vacío.
CPictureHolder::CreateFromBitmap	Crea un objeto CPictureHolder a partir de un mapa de bits.
CPictureHolder::CreateFromIcon	Crea un objeto CPictureHolder a partir de un icono.
CPictureHolder::CreateFromMetafile	Crea un objeto CPictureHolder a partir de un metarchivo.
CPictureHolder::GetDisplayString	Recupera la cadena que se muestra en el explorador de propiedades de un contenedor de controles.
CPictureHolder::GetPictureDispatch	Devuelve la interfaz IDispatch del objeto CPictureHolder.
CPictureHolder::GetType	Indica si el objet CPictureHolder es un mapa de bits, un metarchivo o un icono.
CPictureHolder::Render	Representa la imagen.
CPictureHolder::SetPictureDispatch	Establece la interfaz IDispatch del objeto CPictureHolder.

Miembros de datos públicos

Nombre	Descripción
CPictureHolder::m_pPict	Puntero a un objeto de imagen.

Comentarios

CPictureHolder no tiene una clase base.

Con la propiedad de imagen estándar, el desarrollador puede especificar un mapa de bits, un icono o un metarchivo para su visualización.

Para información sobre cómo crear propiedades de imagen personalizadas, consulte el artículo Controles ActiveX MFC: Usar imágenes en un control ActiveX.

Jerarquía de herencia

CPictureHolder

Requisitos

Encabezado: afxctl.h

CPictureHolder::CPictureHolder

Construye un objeto CPictureHolder.

CPictureHolder();

CPictureHolder::CreateEmpty

Crea un objeto CPictureHolder vacío y lo conecta a una interfaz IPicture.

BOOL CreateEmpty();

Valor devuelto

Distinto de cero si se crea correctamente el objeto; de lo contrario, 0.

CPictureHolder::CreateFromBitmap

Usa un mapa de bits para inicializar el objeto de imagen en CPictureHolder.

BOOL CreateFromBitmap(
    UINT idResource);

BOOL CreateFromBitmap(
    CBitmap* pBitmap,
    CPalette* pPal = NULL,
    BOOL bTransferOwnership = TRUE);

BOOL CreateFromBitmap(
    HBITMAP hbm,
    HPALETTE hpal = NULL,
    BOOL bTransferOwnership = FALSE);

Parámetros

idResource
Identificador de recurso de un recurso de mapa de bits.

pBitmap
Puntero a un objeto CBitmap.

pPal
Puntero a un objeto CPalette.

bTransferOwnership
Indica si el objeto de imagen asumirá la propiedad de los objetos de mapa de bits y paleta.

hbm
Identificador del mapa de bits desde el que se crea el objeto CPictureHolder.

hpal
Identificador de la paleta que se usa para representar el mapa de bits.

Valor devuelto

Distinto de cero si se crea correctamente el objeto; de lo contrario, 0.

Comentarios

Si bTransferOwnership es TRUE, el autor de llamada no debe usar el objeto de mapa de bits o paleta de ninguna manera después de que se devuelva esta llamada. Si bTransferOwnership es FALSE, el autor de llamada es responsable de garantizar que los objetos de mapa de bits y paleta sigan siendo válidos durante la vigencia del objeto de imagen.

CPictureHolder::CreateFromIcon

Usa un icono para inicializar el objeto de imagen en CPictureHolder.

BOOL CreateFromIcon(
    UINT idResource);

BOOL CreateFromIcon(
    HICON hIcon,
    BOOL bTransferOwnership = FALSE);

Parámetros

idResource
Identificador de recurso de un recurso de mapa de bits.

hIcon
Identificador del icono desde el que se crea el objeto CPictureHolder.

bTransferOwnership
Indica si el objeto de imagen asumirá la propiedad del objeto de icono.

Valor devuelto

Distinto de cero si se crea correctamente el objeto; de lo contrario, 0.

Comentarios

Si bTransferOwnership es TRUE, el autor de llamada no debe usar el objeto de icono de ninguna manera después de que se devuelva esta llamada. Si bTransferOwnership es FALSE, el autor de llamada es responsable de garantizar que el objeto de icono siga siendo válido durante la vigencia del objeto de imagen.

CPictureHolder::CreateFromMetafile

Usa un metarchivo para inicializar el objeto de imagen en CPictureHolder.

BOOL CreateFromMetafile(
    HMETAFILE hmf,
    int xExt,
    int yExt,
    BOOL bTransferOwnership = FALSE);

Parámetros

hmf
Identificador del metarchivo que se usa para crear el objeto CPictureHolder.

xExt
Extensión X de la imagen.

yExt
Extensión Y de la imagen.

bTransferOwnership
Indica si el objeto de imagen asumirá la propiedad del objeto de metarchivo.

Valor devuelto

Distinto de cero si se crea correctamente el objeto; de lo contrario, 0.

Comentarios

Si bTransferOwnership es TRUE, el autor de llamada no debe usar el objeto de metarchivo de ninguna manera después de que se devuelva esta llamada. Si bTransferOwnership es FALSE, el autor de llamada es responsable de garantizar que el objeto de metarchivo siga siendo válido durante la vigencia del objeto de imagen.

CPictureHolder::GetDisplayString

Recupera la cadena que se muestra en el explorador de propiedades de un contenedor.

BOOL GetDisplayString(CString& strValue);

Parámetros

strValue
Referencia a CString que va a contener la cadena de presentación.

Valor devuelto

Distinto de cero si la cadena se recupera correctamente; de lo contrario, 0.

CPictureHolder::GetPictureDispatch

Esta función devuelve un puntero a la interfaz IPictureDisp del objeto CPictureHolder.

LPPICTUREDISP GetPictureDispatch();

Valor devuelto

Puntero a la interfaz IPictureDisp del objeto CPictureHolder.

Comentarios

El autor de llamada debe llamar a Release en este puntero cuando termine con él.

CPictureHolder::GetType

Indica si la imagen es un mapa de bits, un metarchivo o un icono.

short GetType();

Valor devuelto

Valor que indica el tipo de la imagen. A continuación, se indican los valores posibles y el significado de cada uno de ellos:

Valor	Significado
PICTYPE_UNINITIALIZED	No se inicializó el objeto CPictureHolder.
PICTYPE_NONE	El objeto CPictureHolder está vacío.
PICTYPE_BITMAP	La imagen es un mapa de bits.
PICTYPE_METAFILE	La imagen es un metarchivo.
PICTYPE_ICON	La imagen es un icono.

CPictureHolder::m_pPict

Puntero a la interfaz IPicture del objeto CPictureHolder.

LPPICTURE m_pPict;

CPictureHolder::Render

Representa la imagen en el rectángulo al que rcRender hace referencia.

void Render(
    CDC* pDC,
    const CRect& rcRender,
    const CRect& rcWBounds);

Parámetros

pDC
Puntero al contexto de presentación en el que se va a representar la imagen.

rcRender
Rectángulo en el que se va a representar la imagen.

rcWBounds
Rectángulo que representa el rectángulo delimitador del objeto que representa la imagen. En el caso de un control, este rectángulo es el parámetro rcBounds pasado a una invalidación de COleControl::OnDraw.

CPictureHolder::SetPictureDispatch

Conecta el objeto CPictureHolder a una interfaz IPictureDisp.

void SetPictureDispatch(LPPICTUREDISP pDisp);

Parámetros

pDisp
Puntero a la nueva interfaz IPictureDisp.

Consulte también

Gráfico de jerarquías
CFontHolder (clase)