CPictureHolder 類別

實作 Picture 屬性，讓使用者能夠在控制項中顯示圖片。

語法

class CPictureHolder

成員

公用建構函式

名稱	描述
CPictureHolder：：CPictureHolder	建構 CPictureHolder 物件。

公用方法

名稱	描述
CPictureHolder：：CreateEmpty	建立空的 CPictureHolder 物件。
CPictureHolder：：CreateFromBitmap	從點陣圖建立 CPictureHolder 物件。
CPictureHolder：：CreateFromIcon	從圖示建立 CPictureHolder 物件。
CPictureHolder：：CreateFromMetafile	CPictureHolder從中繼檔建立 物件。
CPictureHolder：：GetDisplayString	擷取控制項容器之屬性瀏覽器中顯示的字串。
CPictureHolder：：GetPictureDispatch	傳 CPictureHolder 回物件的 IDispatch 介面。
CPictureHolder：：GetType	CPictureHolder指出物件是否為點陣圖、中繼檔或圖示。
CPictureHolder：：Render	呈現圖片。
CPictureHolder：：SetPictureDispatch	CPictureHolder設定物件的 IDispatch 介面。

公用資料成員

名稱	描述
CPictureHolder：：m_pPict	圖片物件的指標。

備註

CPictureHolder 沒有基類。

使用 stock Picture 屬性，開發人員可以指定點陣圖、圖示或中繼檔來顯示。

如需建立自訂圖片屬性的詳細資訊，請參閱 MFC ActiveX 控制項：在 ActiveX 控制項 中使用圖片一文 。

繼承階層架構

CPictureHolder

需求

標頭： afxctl.h

CPictureHolder：：CPictureHolder

建構 CPictureHolder 物件。

CPictureHolder();

CPictureHolder：：CreateEmpty

建立空 CPictureHolder 的 物件，並將它 IPicture 連接到介面。

BOOL CreateEmpty();

傳回值

如果成功建立物件，則為非零;否則為 0。

CPictureHolder：：CreateFromBitmap

使用點陣圖來初始化 中的 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);

參數

idResource
點陣圖資源的資源識別碼。

pBitmap
CBitmap 物件的指標。

pPal
CPalette 物件的指標。

bTransferOwnership
指出圖片物件是否會取得點陣圖和調色盤物件的擁有權。

Hbm
要從中 CPictureHolder 建立物件的點陣圖控制碼。

hpal
用於轉譯點陣圖的調色盤控制碼。

傳回值

如果成功建立物件，則為非零;否則為 0。

備註

如果 bTransferOwnership 為 TRUE，則呼叫端不應該在此呼叫傳回之後以任何方式使用點陣圖或調色盤物件。 如果 bTransferOwnership 為 FALSE，呼叫端會負責確保點陣圖和調色盤物件在圖片物件的存留期內保持有效。

CPictureHolder：：CreateFromIcon

使用圖示來初始化 中的 CPictureHolder 圖片物件。

BOOL CreateFromIcon(
    UINT idResource);

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

參數

idResource
點陣圖資源的資源識別碼。

hIcon
處理建立物件的圖示 CPictureHolder 。

bTransferOwnership
指出圖片物件是否會取得圖示物件的擁有權。

傳回值

如果成功建立物件，則為非零;否則為 0。

備註

如果 bTransferOwnership 為 TRUE，則呼叫端不應在此呼叫傳回之後以任何方式使用圖示物件。 如果 bTransferOwnership 為 FALSE，呼叫端會負責確保圖示物件在圖片物件的存留期內保持有效。

CPictureHolder：：CreateFromMetafile

使用中繼檔來初始化 中的 CPictureHolder 圖片物件。

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

參數

hmf
用來建立 CPictureHolder 物件的中繼檔控制碼。

xExt
圖片的 X 範圍。

yExt
圖片的 Y 範圍。

bTransferOwnership
指出圖片物件是否會取得中繼檔物件的擁有權。

傳回值

如果成功建立物件，則為非零;否則為 0。

備註

如果 bTransferOwnership 為 TRUE，則呼叫端不應該在此呼叫傳回之後以任何方式使用中繼檔物件。 如果 bTransferOwnership 為 FALSE，呼叫端會負責確保中繼檔物件在圖片物件的存留期內保持有效。

CPictureHolder：：GetDisplayString

擷取顯示在容器之屬性瀏覽器中的字串。

BOOL GetDisplayString(CString& strValue);

參數

strValue
要保存顯示字串之 CString 的參考。

傳回值

如果成功擷取字串，則為非零;否則為 0。

CPictureHolder：：GetPictureDispatch

此函式會傳回物件介面的 IPictureDisp 指標 CPictureHolder 。

LPPICTUREDISP GetPictureDispatch();

傳回值

物件的 IPictureDisp 介面指標 CPictureHolder 。

備註

呼叫端在完成時，必須在此指標上呼叫 Release 。

CPictureHolder：：GetType

指出圖片是否為點陣圖、中繼檔或圖示。

short GetType();

傳回值

值，表示圖片的類型。 可能的值及其意義如下：

值	意義
PICTYPE_UNINITIALIZED	CPictureHolder 物件已單位化。
PICTYPE_NONE	CPictureHolder 物件是空的。
PICTYPE_BITMAP	圖片是點陣圖。
PICTYPE_METAFILE	圖片是中繼檔。
PICTYPE_ICON	圖片是圖示。

CPictureHolder：：m_pPict

物件的 IPicture 介面指標 CPictureHolder 。

LPPICTURE m_pPict;

CPictureHolder：：Render

轉譯 rcRender 所參考 之矩形中的圖片。

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

參數

pDC
要轉譯圖片之顯示內容的指標。

rcRender
要轉譯圖片的矩形。

rcWBounds
矩形，表示呈現圖片之物件的周框。 對於控制項，這個矩形是 傳遞至 COleControl：：OnDraw 覆寫的 rcBounds 參數。

CPictureHolder：：SetPictureDispatch

連線 CPictureHolder 物件到 IPictureDisp 介面。

void SetPictureDispatch(LPPICTUREDISP pDisp);

參數

pDisp
新 IPictureDisp 介面的指標。

另請參閱

階層架構圖表
CFontHolder 類別