Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
Opmerking
De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.
Hiermee wordt een afbeeldingseigenschap geïmplementeerd, waarmee de gebruiker een afbeelding in uw besturingselement kan weergeven.
Syntaxis
class CPictureHolder
Leden
Openbare constructors
| Naam | Description |
|---|---|
| CPictureHolder::CPictureHolder | Maakt een CPictureHolder object. |
Openbare methoden
| Naam | Description |
|---|---|
| CPictureHolder::CreateEmpty | Hiermee maakt u een leeg CPictureHolder object. |
| CPictureHolder::CreateFromBitmap | Hiermee maakt u een CPictureHolder object op basis van een bitmap. |
| CPictureHolder::CreateFromIcon | Hiermee maakt u een CPictureHolder object op basis van een pictogram. |
| CPictureHolder::CreateFromMetafile | Hiermee maakt u een CPictureHolder object op basis van een metabestand. |
| CPictureHolder::GetDisplayString | Hiermee wordt de tekenreeks opgehaald die wordt weergegeven in de eigenschapsbrowser van een besturingscontainer. |
| CPictureHolder::GetPictureDispatch | Retourneert de interface van IDispatch het CPictureHolder object. |
| CPictureHolder::GetType | Hiermee wordt aangegeven of het CPictureHolder object een bitmap, een metabestand of een pictogram is. |
| CPictureHolder::Render | Geeft de afbeelding weer. |
| CPictureHolder::SetPictureDispatch | Hiermee stelt u de interface van IDispatch het CPictureHolder object in. |
Leden van openbare gegevens
| Naam | Description |
|---|---|
| CPictureHolder::m_pPict | Een aanwijzer naar een afbeeldingsobject. |
Opmerkingen
CPictureHolder heeft geen basisklasse.
Met de eigenschap Stock Picture kan de ontwikkelaar een bitmap, pictogram of metabestand opgeven voor weergave.
Zie het artikel MFC ActiveX-besturingselementen: Afbeeldingen gebruiken in een ActiveX-besturingselement voor meer informatie over het maken van aangepaste afbeeldingseigenschappen.
Overnamehiërarchie
CPictureHolder
Requirements
Koptekst: afxctl.h
CPictureHolder::CPictureHolder
Maakt een CPictureHolder object.
CPictureHolder();
CPictureHolder::CreateEmpty
Hiermee maakt u een leeg CPictureHolder object en verbindt u het met een IPicture interface.
BOOL CreateEmpty();
Retourwaarde
Niet-nul als het object is gemaakt; anders 0.
CPictureHolder::CreateFromBitmap
Gebruikt een bitmap om het afbeeldingsobject in een CPictureHolderte initialiseren.
BOOL CreateFromBitmap(
UINT idResource);
BOOL CreateFromBitmap(
CBitmap* pBitmap,
CPalette* pPal = NULL,
BOOL bTransferOwnership = TRUE);
BOOL CreateFromBitmap(
HBITMAP hbm,
HPALETTE hpal = NULL,
BOOL bTransferOwnership = FALSE);
Parameterwaarden
idResource
Resource-id van een bitmapresource.
pBitmap
Aanwijzer naar een CBitmap-object .
pPal
Aanwijzer naar een CPalette-object .
bTransferOwnership
Hiermee wordt aangegeven of het afbeeldingsobject eigenaar wordt van de bitmap- en paletobjecten.
hbm
Greep naar de bitmap van waaruit het CPictureHolder object is gemaakt.
Hpal
Greep naar het palet dat wordt gebruikt voor het weergeven van de bitmap.
Retourwaarde
Niet-nul als het object is gemaakt; anders 0.
Opmerkingen
Als bTransferOwnership TRUE is, mag de beller het bitmap- of paletobject niet op enigerlei wijze gebruiken nadat deze aanroep is geretourneerd. Als bTransferOwnership ONWAAR is, is de aanroeper verantwoordelijk om ervoor te zorgen dat de bitmap- en paletobjecten geldig blijven voor de levensduur van het afbeeldingsobject.
CPictureHolder::CreateFromIcon
Gebruikt een pictogram om het afbeeldingsobject in een CPictureHolderte initialiseren.
BOOL CreateFromIcon(
UINT idResource);
BOOL CreateFromIcon(
HICON hIcon,
BOOL bTransferOwnership = FALSE);
Parameterwaarden
idResource
Resource-id van een bitmapresource.
hIcon
Greep naar het pictogram van waaruit het CPictureHolder object is gemaakt.
bTransferOwnership
Hiermee wordt aangegeven of het afbeeldingsobject eigenaar wordt van het pictogramobject.
Retourwaarde
Niet-nul als het object is gemaakt; anders 0.
Opmerkingen
Als bTransferOwnership TRUE is, mag de aanroeper het pictogramobject niet op enigerlei wijze gebruiken nadat deze aanroep is geretourneerd. Als bTransferOwnership FALSE is, is de aanroeper verantwoordelijk voor het controleren of het pictogramobject geldig blijft voor de levensduur van het afbeeldingsobject.
CPictureHolder::CreateFromMetafile
Gebruikt een metabestand om het afbeeldingsobject in een CPictureHolderte initialiseren.
BOOL CreateFromMetafile(
HMETAFILE hmf,
int xExt,
int yExt,
BOOL bTransferOwnership = FALSE);
Parameterwaarden
hmf
Greep naar het metabestand dat wordt gebruikt om het CPictureHolder object te maken.
Xext
X-omvang van de afbeelding.
yExt
Y-omvang van de afbeelding.
bTransferOwnership
Hiermee wordt aangegeven of het afbeeldingsobject eigenaar wordt van het metafile-object.
Retourwaarde
Niet-nul als het object is gemaakt; anders 0.
Opmerkingen
Als bTransferOwnership TRUE is, mag de aanroeper het metabestandobject niet op enigerlei wijze gebruiken nadat deze aanroep is geretourneerd. Als bTransferOwnership ONWAAR is, is de aanroeper verantwoordelijk voor het controleren of het metafile-object geldig blijft voor de levensduur van het afbeeldingsobject.
CPictureHolder::GetDisplayString
Haalt de tekenreeks op die wordt weergegeven in de eigenschapsbrowser van een container.
BOOL GetDisplayString(CString& strValue);
Parameterwaarden
strValue
Verwijzing naar de CString die de weergavetekenreeks bevat.
Retourwaarde
Niet-nul als de tekenreeks is opgehaald; anders 0.
CPictureHolder::GetPictureDispatch
Deze functie retourneert een aanwijzer naar de interface van IPictureDisp het CPictureHolder object.
LPPICTUREDISP GetPictureDispatch();
Retourwaarde
Een aanwijzer naar de interface van IPictureDisp het CPictureHolder object.
Opmerkingen
De beller moet deze aanwijzer aanroepen Release wanneer deze klaar is.
CPictureHolder::GetType
Geeft aan of de afbeelding een bitmap, metabestand of pictogram is.
short GetType();
Retourwaarde
Een waarde die het type afbeelding aangeeft. Mogelijke waarden en betekenissen zijn als volgt:
| Waarde | Meaning |
|---|---|
| PICTYPE_UNINITIALIZED |
CPictureHolder object is geïnitialiseerd. |
| PICTYPE_NONE |
CPictureHolder object is leeg. |
| PICTYPE_BITMAP | Afbeelding is een bitmap. |
| PICTYPE_METAFILE | Afbeelding is een metabestand. |
| PICTYPE_ICON | Afbeelding is een pictogram. |
CPictureHolder::m_pPict
Een aanwijzer naar de interface van IPicture het CPictureHolder object.
LPPICTURE m_pPict;
CPictureHolder::Render
Geeft de afbeelding weer in de rechthoek waarnaar wordt verwezen door rcRender.
void Render(
CDC* pDC,
const CRect& rcRender,
const CRect& rcWBounds);
Parameterwaarden
Pdc
Wijs de weergavecontext aan waarin de afbeelding moet worden weergegeven.
rcRender
Rechthoek waarin de afbeelding moet worden weergegeven.
rcWBounds
Een rechthoek die de begrenzingsrechthoek van het object aangeeft dat de afbeelding weergeeft. Voor een besturingselement is deze rechthoek de rcBounds-parameter die wordt doorgegeven aan een onderdrukking van COleControl::OnDraw.
CPictureHolder::SetPictureDispatch
Hiermee wordt het CPictureHolder object verbonden met een IPictureDisp interface.
void SetPictureDispatch(LPPICTUREDISP pDisp);
Parameterwaarden
pDisp
Aanwijzer naar de nieuwe IPictureDisp interface.