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 CPictureHolder IDispatch 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 CPictureHolder IDispatch 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 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:
| 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 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.