CPictureHolder-Klasse

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

Syntax

class CPictureHolder

Member

Öffentliche Konstruktoren

Name	Beschreibung
CPictureHolder::CPictureHolder	Erstellt ein CPictureHolder-Objekt.

Öffentliche Methoden

Name	Beschreibung
CPictureHolder::CreateEmpty	Erstellt ein leeres CPictureHolder-Objekt.
CPictureHolder::CreateFromBitmap	Erstellt ein CPictureHolder Objekt aus einer Bitmap.
CPictureHolder::CreateFromIcon	Erstellt ein CPictureHolder Objekt aus einem Symbol.
CPictureHolder::CreateFromMetafile	Erstellt ein CPictureHolder Objekt aus einer Metadatei.
CPictureHolder::GetDisplayString	Ruft die Zeichenfolge ab, die im Eigenschaftenbrowser eines Steuerelementcontainers angezeigt wird.
CPictureHolder::GetPictureDispatch	Gibt die Schnittstelle des CPictureHolderIDispatch Objekts zurück.
CPictureHolder::GetType	Gibt an, ob das CPictureHolder Objekt eine Bitmap, eine Metadatei oder ein Symbol ist.
CPictureHolder::Render	Rendert das Bild.
CPictureHolder::SetPictureDispatch	Legt die Schnittstelle des CPictureHolderIDispatch Objekts fest.

Öffentliche Datenmember

Name	Beschreibung
CPictureHolder::m_pPict	Ein Zeiger auf ein Bildobjekt.

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 Palette Standard nobjekte für die Lebensdauer des Bildobjekts erneut gültig sind.

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 ist Standard.

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 ist Standard.

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 CPictureHolderIPictureDisp Objekts zurück.

LPPICTUREDISP GetPictureDispatch();

Rückgabewert

Ein Zeiger auf die Schnittstelle des CPictureHolderIPictureDisp 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:

Wert	Bedeutung
PICTYPE_UNINITIALIZED	CPictureHolder -Objekt wird unititialisiert.
PICTYPE_NONE	CPictureHolder -Objekt ist leer.
PICTYPE_BITMAP	Bild ist eine Bitmap.
PICTYPE_METAFILE	Bild ist eine Metadatei.
PICTYPE_ICON	Das Bild ist ein Symbol.

CPictureHolder::m_pPict

Ein Zeiger auf die Schnittstelle des CPictureHolderIPicture 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

Verbinden das CPictureHolder Objekt auf eine IPictureDisp Schnittstelle.

void SetPictureDispatch(LPPICTUREDISP pDisp);

Parameter

pDisp
Zeiger auf die neue IPictureDisp Schnittstelle.

Siehe auch

Hierarchiediagramm
CFontHolder-Klasse