CPictureHolder – třída

Implementuje vlastnost Picture, která uživateli umožňuje zobrazit obrázek ve vašem ovládacím prvku.

Syntaxe

class CPictureHolder

Členové

Veřejné konstruktory

Jméno	popis
CPictureHolder::CPictureHolder	CPictureHolder Vytvoří objekt.

Veřejné metody

Jméno	popis
CPictureHolder::CreateEmpty	Vytvoří prázdný CPictureHolder objekt.
CPictureHolder::CreateFromBitmap	CPictureHolder Vytvoří objekt z rastrového obrázku.
CPictureHolder::CreateFromIcon	CPictureHolder Vytvoří objekt z ikony.
CPictureHolder::CreateFromMetafile	CPictureHolder Vytvoří objekt z metasouboru.
CPictureHolder::GetDisplayString	Načte řetězec zobrazený v prohlížeči vlastností kontejneru ovládacího prvku.
CPictureHolder::GetPictureDispatch	CPictureHolder Vrátí rozhraní objektuIDispatch.
CPictureHolder::GetType	Určuje, jestli CPictureHolder je objekt rastrovým obrázkem, metasouborem nebo ikonou.
CPictureHolder::Render	Vykreslí obrázek.
CPictureHolder::SetPictureDispatch	CPictureHolder Nastaví rozhraní objektuIDispatch.

Veřejné datové členy

Jméno	popis
CPictureHolder::m_pPict	Ukazatel na objekt obrázku.

Poznámky

CPictureHolder nemá základní třídu.

Pomocí vlastnosti Stock Picture může vývojář zadat rastrový obrázek, ikonu nebo metasoubor pro zobrazení.

Informace o vytváření vlastních vlastností obrázku naleznete v článku MFC technologie ActiveX ovládací prvky: Použití obrázků v ovládacím prvku technologie ActiveX.

Hierarchie dědičnosti

CPictureHolder

Požadavky

Záhlaví: afxctl.h

CPictureHolder::CPictureHolder

CPictureHolder Vytvoří objekt.

CPictureHolder();

CPictureHolder::CreateEmpty

Vytvoří prázdný CPictureHolder objekt a připojí ho IPicture k rozhraní.

BOOL CreateEmpty();

Vrácená hodnota

Nenulové, pokud je objekt úspěšně vytvořen; jinak 0.

CPictureHolder::CreateFromBitmap

Používá rastrový obrázek k inicializaci objektu obrázku v objektu 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);

Parametry

idResource
ID prostředku rastrového obrázku

pBitmap
Ukazatel na objekt CBitmap .

pPal
Ukazatel na objekt CPalette .

bTransferOwnership
Určuje, zda objekt obrázku převezme vlastnictví rastrového obrázku a objekty palety.

Hbm
Úchyt rastrového obrázku CPictureHolder , ze kterého je objekt vytvořen.

hpal
Úchyt pro paletu použitou k vykreslení rastrového obrázku.

Vrácená hodnota

Nenulové, pokud je objekt úspěšně vytvořen; jinak 0.

Poznámky

Pokud bTransferOwnership je PRAVDA, volající by neměl používat rastrový nebo paletový objekt žádným způsobem po vrácení tohoto volání. Pokud bTransferOwnership je FALSE, volající je zodpovědný za zajištění, že rastrové a paletové objekty zůstanou platné po dobu životnosti objektu obrázku.

CPictureHolder::CreateFromIcon

Pomocí ikony inicializuje objekt obrázku v objektu CPictureHolder.

BOOL CreateFromIcon(
    UINT idResource);

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

Parametry

idResource
ID prostředku rastrového obrázku

hIcon
Popisovač ikony, ze které CPictureHolder je objekt vytvořen.

bTransferOwnership
Určuje, jestli objekt obrázku převezme vlastnictví objektu ikony.

Vrácená hodnota

Nenulové, pokud je objekt úspěšně vytvořen; jinak 0.

Poznámky

Pokud bTransferOwnership je PRAVDA, volající by neměl používat objekt ikony žádným způsobem po vrácení tohoto volání. Pokud bTransferOwnership je FALSE, volající je zodpovědný za zajištění, že objekt ikony zůstane platný po celou dobu života objektu obrázku.

CPictureHolder::CreateFromMetafile

Používá metasoubor k inicializaci objektu obrázku v objektu CPictureHolder.

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

Parametry

hmf
Popisovač metasouboru použitého k vytvoření objektu CPictureHolder .

xExt
X rozsah obrázku.

yExt
Rozsah obrázku Y.

bTransferOwnership
Určuje, zda objekt obrázku převezme vlastnictví objektu metasouboru.

Vrácená hodnota

Nenulové, pokud je objekt úspěšně vytvořen; jinak 0.

Poznámky

Pokud bTransferOwnership je PRAVDA, volající by neměl používat metasoubor objektu žádným způsobem po vrácení tohoto volání. Pokud bTransferOwnership je FALSE, volající je zodpovědný za zajištění, že objekt metasouboru zůstane platný po dobu životnosti objektu obrázku.

CPictureHolder::GetDisplayString

Načte řetězec zobrazený v prohlížeči vlastností kontejneru.

BOOL GetDisplayString(CString& strValue);

Parametry

strValue
Odkaz na řetězec CString , který má obsahovat zobrazovaný řetězec.

Vrácená hodnota

Nenulové, pokud je řetězec úspěšně načten; jinak 0.

CPictureHolder::GetPictureDispatch

Tato funkce vrátí ukazatel na rozhraní objektu CPictureHolderIPictureDisp .

LPPICTUREDISP GetPictureDispatch();

Vrácená hodnota

Ukazatel na rozhraní objektu CPictureHolderIPictureDisp .

Poznámky

Volající musí po dokončení zavolat Release na tento ukazatel.

CPictureHolder::GetType

Určuje, zda je obrázek rastrovým obrázkem, metasouborem nebo ikonou.

short GetType();

Vrácená hodnota

Hodnota označující typ obrázku. Možné hodnoty a jejich významy jsou následující:

Hodnota	Význam
PICTYPE_UNINITIALIZED	CPictureHolder objekt je jednotně inicializován.
PICTYPE_NONE	CPictureHolder objekt je prázdný.
PICTYPE_BITMAP	Obrázek je rastrový obrázek.
PICTYPE_METAFILE	Obrázek je metasoubor.
PICTYPE_ICON	Obrázek je ikona.

CPictureHolder::m_pPict

Ukazatel na rozhraní objektu CPictureHolderIPicture .

LPPICTURE m_pPict;

CPictureHolder::Render

Vykreslí obrázek v obdélníku, na který odkazuje rcRender.

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

Parametry

Pdc
Ukazatel na kontext zobrazení, ve kterém se má obrázek vykreslit.

rcRender
Obdélník, ve kterém se má obrázek vykreslit.

RcWBounds
Obdélník představující ohraničující obdélník objektu vykreslující obrázek. Pro ovládací prvek je tento obdélník rcBounds parametr předán přepsání COleControl::OnDraw.

CPictureHolder::SetPictureDispatch

CPictureHolder Připojení objekt do IPictureDisp rozhraní.

void SetPictureDispatch(LPPICTUREDISP pDisp);

Parametry

pDisp
Ukazatel na nové IPictureDisp rozhraní.

Viz také

Graf hierarchie
CFontHolder – třída