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.

Vedi anche

Grafico della gerarchia
Classe CFontHolder