Classe CPictureHolder
Implementa una proprietà Picture, che consente all'utente di visualizzare un'immagine nel controllo.
Sintassi
class CPictureHolder
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| CPictureHolder::CPictureHolder | Costruisce un oggetto CPictureHolder. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CPictureHolder::CreateEmpty | Crea un oggetto CPictureHolder vuoto. |
| CPictureHolder::CreateFromBitmap | Crea un CPictureHolder oggetto da una bitmap. |
| CPictureHolder::CreateFromIcon | Crea un CPictureHolder oggetto da un'icona. |
| CPictureHolder::CreateFromMetafile | Crea un CPictureHolder oggetto da un metafile. |
| CPictureHolder::GetDisplayString | Recupera la stringa visualizzata nel browser delle proprietà di un contenitore di controlli. |
| CPictureHolder::GetPictureDispatch | Restituisce l'interfaccia CPictureHolder dell'oggetto IDispatch . |
| CPictureHolder::GetType | Indica se l'oggetto CPictureHolder è una bitmap, un metafile o un'icona. |
| CPictureHolder::Render | Esegue il rendering dell'immagine. |
| CPictureHolder::SetPictureDispatch | Imposta l'interfaccia CPictureHolder dell'oggetto IDispatch . |
Membri dati pubblici
| Nome | Descrizione |
|---|---|
| CPictureHolder::m_pPict | Puntatore a un oggetto immagine. |
Osservazioni:
CPictureHolder non dispone di una classe di base.
Con la proprietà Stock Picture, lo sviluppatore può specificare una bitmap, un'icona o un metafile per la visualizzazione.
Per informazioni sulla creazione di proprietà di immagini personalizzate, vedere l'articolo Controlli ActiveX MFC: Uso di immagini in un controllo ActiveX.
Gerarchia di ereditarietà
CPictureHolder
Requisiti
Intestazione: afxctl.h
CPictureHolder::CPictureHolder
Costruisce un oggetto CPictureHolder.
CPictureHolder();
CPictureHolder::CreateEmpty
Crea un oggetto vuoto CPictureHolder e lo connette a un'interfaccia IPicture .
BOOL CreateEmpty();
Valore restituito
Diverso da zero se l'oggetto viene creato correttamente; in caso contrario, 0.
CPictureHolder::CreateFromBitmap
Usa una bitmap per inizializzare l'oggetto immagine in un oggetto 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);
Parametri
idResource
ID risorsa di una risorsa bitmap.
pBitmap
Puntatore a un oggetto CBitmap .
pPal
Puntatore a un oggetto CPalette .
bTransferOwnership
Indica se l'oggetto immagine assumerà la proprietà degli oggetti bitmap e tavolozza.
Hbm
Handle per la bitmap da cui viene creato l'oggetto CPictureHolder .
hpal
Handle nella tavolozza utilizzata per il rendering della bitmap.
Valore restituito
Diverso da zero se l'oggetto viene creato correttamente; in caso contrario, 0.
Osservazioni:
Se bTransferOwnership è TRUE, il chiamante non deve usare l'oggetto bitmap o palette in alcun modo dopo la restituzione della chiamata. Se bTransferOwnership è FALSE, il chiamante è responsabile di garantire che gli oggetti bitmap e tavolozza rimangano validi per la durata dell'oggetto immagine.
CPictureHolder::CreateFromIcon
Usa un'icona per inizializzare l'oggetto immagine in un oggetto CPictureHolder.
BOOL CreateFromIcon(
UINT idResource);
BOOL CreateFromIcon(
HICON hIcon,
BOOL bTransferOwnership = FALSE);
Parametri
idResource
ID risorsa di una risorsa bitmap.
hIcon
Handle per l'icona da cui viene creato l'oggetto CPictureHolder .
bTransferOwnership
Indica se l'oggetto immagine assumerà la proprietà dell'oggetto icona.
Valore restituito
Diverso da zero se l'oggetto viene creato correttamente; in caso contrario, 0.
Osservazioni:
Se bTransferOwnership è TRUE, il chiamante non deve usare l'oggetto icona in alcun modo dopo la restituzione di questa chiamata. Se bTransferOwnership è FALSE, il chiamante è responsabile della validità dell'oggetto icona per la durata dell'oggetto immagine.
CPictureHolder::CreateFromMetafile
Usa un metafile per inizializzare l'oggetto immagine in un oggetto CPictureHolder.
BOOL CreateFromMetafile(
HMETAFILE hmf,
int xExt,
int yExt,
BOOL bTransferOwnership = FALSE);
Parametri
hmf
Handle per il metafile usato per creare l'oggetto CPictureHolder .
xExt
X extent dell'immagine.
yExt
Y extent dell'immagine.
bTransferOwnership
Indica se l'oggetto immagine assumerà la proprietà dell'oggetto metafile.
Valore restituito
Diverso da zero se l'oggetto viene creato correttamente; in caso contrario, 0.
Osservazioni:
Se bTransferOwnership è TRUE, il chiamante non deve usare l'oggetto metafile in alcun modo dopo la restituzione di questa chiamata. Se bTransferOwnership è FALSE, il chiamante è responsabile di garantire che l'oggetto metafile rimanga valido per la durata dell'oggetto immagine.
CPictureHolder::GetDisplayString
Recupera la stringa visualizzata nel browser delle proprietà di un contenitore.
BOOL GetDisplayString(CString& strValue);
Parametri
strValue
Riferimento a CString che deve contenere la stringa di visualizzazione.
Valore restituito
Diverso da zero se la stringa viene recuperata correttamente; in caso contrario, 0.
CPictureHolder::GetPictureDispatch
Questa funzione restituisce un puntatore all'interfaccia CPictureHolder dell'oggetto IPictureDisp .
LPPICTUREDISP GetPictureDispatch();
Valore restituito
Puntatore all'interfaccia CPictureHolder dell'oggetto IPictureDisp .
Osservazioni:
Il chiamante deve chiamare Release su questo puntatore al termine dell'operazione.
CPictureHolder::GetType
Indica se l'immagine è una bitmap, un metafile o un'icona.
short GetType();
Valore restituito
Valore che indica il tipo di immagine. I valori possibili e i relativi significati sono i seguenti:
| Valore | Significato |
|---|---|
| PICTYPE_UNINITIALIZED | CPictureHolder l'oggetto è unititializzato. |
| PICTYPE_NONE | CPictureHolder l'oggetto è vuoto. |
| PICTYPE_BITMAP | L'immagine è una bitmap. |
| PICTYPE_METAFILE | L'immagine è un metafile. |
| PICTYPE_ICON | L'immagine è un'icona. |
CPictureHolder::m_pPict
Puntatore all'interfaccia CPictureHolder dell'oggetto IPicture .
LPPICTURE m_pPict;
CPictureHolder::Render
Esegue il rendering dell'immagine nel rettangolo a cui fa riferimento rcRender.
void Render(
CDC* pDC,
const CRect& rcRender,
const CRect& rcWBounds);
Parametri
pDC
Puntatore al contesto di visualizzazione in cui deve essere eseguito il rendering dell'immagine.
rcRender
Rettangolo in cui deve essere eseguito il rendering dell'immagine.
rcWBounds
Rettangolo che rappresenta il rettangolo di delimitazione dell'oggetto che esegue il rendering dell'immagine. Per un controllo, questo rettangolo è il parametro rcBounds passato a un override di COleControl::OnDraw.
CPictureHolder::SetPictureDispatch
Connette l'oggetto a un'interfaccia CPictureHolder IPictureDisp .
void SetPictureDispatch(LPPICTUREDISP pDisp);
Parametri
pDisp
Puntatore alla nuova IPictureDisp interfaccia.