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.