CPictureHolder-Klasse

Implementiert eine Picture -Eigenschaft, mit der der Benutzer ein Bild in Ihrem Steuerelement anzeigen kann.

Syntax

class CPictureHolder

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Öffentliche Datenmember

Hinweise

CPictureHolder besitzt keine Basisklasse.

Mit der Stock Picture-Eigenschaft kann der Entwickler eine Bitmap, ein Symbol oder eine Metadatei für die Anzeige angeben.

Informationen zum Erstellen benutzerdefinierter Bildeigenschaften finden Sie im Artikel MFC ActiveX-Steuerelemente: Verwenden von Bildern in einem ActiveX-Steuerelement.

Vererbungshierarchie

CPictureHolder

Anforderungen

Kopfzeile: afxctl.h

CPictureHolder::CPictureHolder

Erstellt ein CPictureHolder-Objekt.

CPictureHolder();

CPictureHolder::CreateEmpty

Erstellt ein leeres CPictureHolder Objekt und verbindet es mit einer IPicture Schnittstelle.

BOOL CreateEmpty();

Rückgabewert

Nonzero, wenn das Objekt erfolgreich erstellt wurde; andernfalls 0.

CPictureHolder::CreateFromBitmap

Verwendet eine Bitmap zum Initialisieren des Bildobjekts in einem 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);

Parameter

idResource
Ressourcen-ID einer Bitmapressource.

pBitmap
Zeiger auf ein CBitmap-Objekt .

pPal
Zeiger auf ein CPalette-Objekt .

bTransferOwnership
Gibt an, ob das Bildobjekt den Besitz der Bitmap- und Palettenobjekte übernimmt.

Hbm
Behandeln Sie die Bitmap, aus der das CPictureHolder Objekt erstellt wird.

hpal
Behandeln sie die Palette, die zum Rendern der Bitmap verwendet wird.

Rückgabewert

Nonzero, wenn das Objekt erfolgreich erstellt wurde; andernfalls 0.

Hinweise

Wenn bTransferOwnership WAHR ist, sollte der Aufrufer das Bitmap- oder Palettenobjekt nicht auf irgendeine Weise verwenden, nachdem dieser Aufruf zurückgegeben wurde. Wenn bTransferOwnership FALSCH ist, ist der Aufrufer dafür verantwortlich, sicherzustellen, dass die Bitmap- und Palettenobjekte für die Lebensdauer des Bildobjekts gültig bleiben.

CPictureHolder::CreateFromIcon

Verwendet ein Symbol zum Initialisieren des Bildobjekts in einem CPictureHolder.

BOOL CreateFromIcon(
    UINT idResource);

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

Parameter

idResource
Ressourcen-ID einer Bitmapressource.

hIcon
Behandeln Sie das Symbol, aus dem das CPictureHolder Objekt erstellt wird.

bTransferOwnership
Gibt an, ob das Bildobjekt den Besitz des Symbolobjekts übernimmt.

Rückgabewert

Nonzero, wenn das Objekt erfolgreich erstellt wurde; andernfalls 0.

Hinweise

Wenn bTransferOwnership TRUE ist, sollte der Aufrufer das Symbolobjekt nicht auf irgendeine Weise verwenden, nachdem dieser Aufruf zurückgegeben wurde. Wenn bTransferOwnership FALSCH ist, ist der Aufrufer dafür verantwortlich, sicherzustellen, dass das Symbolobjekt für die Lebensdauer des Bildobjekts gültig bleibt.

CPictureHolder::CreateFromMetafile

Verwendet eine Metadatei zum Initialisieren des Bildobjekts in einem CPictureHolder.

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

Parameter

hmf
Behandeln Sie die Metadatei, die zum Erstellen des CPictureHolder Objekts verwendet wird.

xExt
X-Umfang des Bilds.

yExt
Y-Umfang des Bilds.

bTransferOwnership
Gibt an, ob das Bildobjekt den Besitz des Metadateiobjekts übernimmt.

Rückgabewert

Nonzero, wenn das Objekt erfolgreich erstellt wurde; andernfalls 0.

Hinweise

Wenn bTransferOwnership TRUE ist, sollte der Aufrufer das Metafile-Objekt nicht auf irgendeine Weise verwenden, nachdem dieser Aufruf zurückgegeben wurde. Wenn bTransferOwnership FALSCH ist, ist der Aufrufer dafür verantwortlich, sicherzustellen, dass das Metafile-Objekt für die Lebensdauer des Bildobjekts gültig bleibt.

CPictureHolder::GetDisplayString

Ruft die Zeichenfolge ab, die im Eigenschaftenbrowser eines Containers angezeigt wird.

BOOL GetDisplayString(CString& strValue);

Parameter

strValue
Verweis auf die CString , die die Anzeigezeichenfolge enthalten soll.

Rückgabewert

Nonzero, wenn die Zeichenfolge erfolgreich abgerufen wird; andernfalls 0.

CPictureHolder::GetPictureDispatch

Diese Funktion gibt einen Zeiger auf die Schnittstelle des CPictureHolder IPictureDisp Objekts zurück.

LPPICTUREDISP GetPictureDispatch();

Rückgabewert

Ein Zeiger auf die Schnittstelle des CPictureHolder IPictureDisp Objekts.

Hinweise

Der Anrufer muss diesen Zeiger aufrufen Release , wenn er damit fertig ist.

CPictureHolder::GetType

Gibt an, ob es sich bei dem Bild um eine Bitmap, eine Metadatei oder ein Symbol handelt.

short GetType();

Rückgabewert

Ein Wert, der den Typ des Bilds angibt. Mögliche Werte und ihre Bedeutungen sind wie folgt:

CPictureHolder::m_pPict

Ein Zeiger auf die Schnittstelle des CPictureHolder IPicture Objekts.

LPPICTURE m_pPict;

CPictureHolder::Render

Rendert das Bild im Rechteck, auf das von rcRender verwiesen wird.

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

Parameter

pDC
Zeigen Sie auf den Anzeigekontext, in dem das Bild gerendert werden soll.

rcRender
Rechteck, in dem das Bild gerendert werden soll.

rcWBounds
Ein Rechteck, das das umgebende Rechteck des Objekts darstellt, das das Bild rendert. Bei einem Steuerelement ist dieses Rechteck der rcBounds-Parameter, der an eine Außerkraftsetzung von COleControl::OnDraw übergeben wird.

CPictureHolder::SetPictureDispatch

Verbindet das CPictureHolder Objekt mit einer IPictureDisp Schnittstelle.

void SetPictureDispatch(LPPICTUREDISP pDisp);

Parameter

pDisp
Zeiger auf die neue IPictureDisp Schnittstelle.

Siehe auch

Hierarchiediagramm
CFontHolder-Klasse