COlePasteSpecialDialog 類別
用於 OLE 的 [選擇性貼上] 對話方塊。
語法
class COlePasteSpecialDialog : public COleDialog
成員
公用建構函式
| 名稱 | 描述 |
|---|---|
| COlePasteSpecialDialog：：COlePasteSpecialDialog | 建構 COlePasteSpecialDialog 物件。 |
公用方法
| 名稱 | 描述 |
|---|---|
| COlePasteSpecialDialog：：AddFormat | 將自訂格式新增至應用程式可貼上的格式清單。 |
| COlePasteSpecialDialog：：AddLinkEntry | 將新專案新增至支援的剪貼簿格式清單。 |
| COlePasteSpecialDialog：：AddStandardFormats | 將CF_BITMAP、CF_DIB、CF_METAFILEPICT，以及選擇性地CF_LINKSOURCE新增至應用程式可以貼上的格式清單。 |
| COlePasteSpecialDialog：：CreateItem | 使用指定的格式，在容器檔中建立專案。 |
| COlePasteSpecialDialog：:D oModal | 顯示 [OLE 貼上特殊] 對話框。 |
| COlePasteSpecialDialog：：GetDrawAspect | 指出是否要將項目繪製為圖示。 |
| COlePasteSpecialDialog：：GetIconicMetafile | 取得與這個專案之圖示形式相關聯的元檔句柄。 |
| COlePasteSpecialDialog：：GetPasteIndex | 取得使用者所選取貼上選項的索引。 |
| COlePasteSpecialDialog：：GetSelectionType | 取得選擇的選取類型。 |
公用資料成員
| 名稱 | 描述 |
|---|---|
| COlePasteSpecialDialog：：m_ps | OLEUIPASTESPECIAL 類型的結構，可控制對話框的函式。 |
備註
當您要呼叫此對話框時，請建立 類別 COlePasteSpecialDialog 的物件。 COlePasteSpecialDialog建構物件之後，您可以使用 AddFormat 和 AddStandardFormats 成員函式，將剪貼簿格式新增至對話方塊。 您也可以使用 m_ps 結構來初始化對話框中控件的值或狀態。 結構 m_ps 的類型為 OLEUIPASTESPECIAL。
如需詳細資訊，請參閱 Windows SDK 中的 OLEUIPASTESPECIAL 結構。
如需 OLE 特定對話框的詳細資訊，請參閱 OLE 中的對話框一文。
繼承階層架構
COlePasteSpecialDialog
需求
標頭： afxodlgs.h
COlePasteSpecialDialog：：AddFormat
呼叫此函式，將新的格式新增至應用程式可在 [貼上特殊] 作業中支援的格式清單。
void AddFormat(
const FORMATETC& formatEtc,
LPTSTR lpszFormat,
LPTSTR lpszResult,
DWORD flags);
void AddFormat(
UINT cf,
DWORD tymed,
UINT nFormatID,
BOOL bEnableIcon,
BOOL bLink);
參數
fmt
要加入之數據類型的參考。
lpszFormat
描述使用者格式的字串。
lpszResult
在對話框中選擇此格式時描述結果的字串。
flags
此格式可用的不同連結和內嵌選項。 這個旗標是 OLEUIPASTEFLAG 列舉型別中一或多個不同值的位元組合。
cf
要新增的剪貼簿格式。
tymed
此格式可用的媒體類型。 這是 TYMED 列舉型別中一或多個值的位元組合。
nFormatID
識別此格式之字串的識別碼。 此字串的格式是兩個不同的字串，並以 『\n' 字元分隔。 第一個字串與在 lpstrFormat 參數中傳遞的字串相同，而第二個字串與 lpstrResult 參數相同。
bEnableIcon
旗標，決定在清單框中選擇此格式時，是否啟用 [顯示身分圖示] 複選框。
眨眼
旗標，決定在清單框中選擇此格式時，是否啟用 [貼上連結] 單選按鈕。
備註
您可以呼叫此函式來新增標準格式，例如CF_TEXT或CF_TIFF或應用程式向系統註冊的自定義格式。 如需將數據物件貼入應用程式的詳細資訊，請參閱數據對象和數據源：操作一文。
如需詳細資訊，請參閱 Windows SDK 中的 TYMED 列舉類型和 FORMATETC 結構。
如需詳細資訊，請參閱 Windows SDK 中的 OLEUIPASTEFLAG 列舉類型。
COlePasteSpecialDialog：：AddLinkEntry
將新專案新增至支援的剪貼簿格式清單。
OLEUIPASTEFLAG AddLinkEntry(UINT cf);
參數
cf
要新增的剪貼簿格式。
傳回值
包含 新連結項目資訊的 OLEUIPASTEFLAG 結構。
COlePasteSpecialDialog：：AddStandardFormats
呼叫此函式，將下列剪貼簿格式新增至應用程式可在 [貼上特殊] 作業中支援的格式清單：
void AddStandardFormats(BOOL bEnableLink = TRUE);
參數
bEnableLink
旗標，判斷是否要將CF_LINKSOURCE新增至應用程式可以貼上的格式清單。
備註
CF_BITMAP
CF_DIB
CF_METAFILEPICT
“Embedded 物件”
（選擇性） 連結來源”
這些格式可用來支援內嵌和連結。
COlePasteSpecialDialog：：COlePasteSpecialDialog
建構 COlePasteSpecialDialog 物件。
COlePasteSpecialDialog(
DWORD dwFlags = PSF_SELECTPASTE,
COleDataObject* pDataObject = NULL,
CWnd* pParentWnd = NULL);
參數
dwFlags
建立旗標，包含使用 bitwise-OR 運算子結合的下列任何數目旗標：
PSF_SELECTPASTE 指定呼叫對話框時，一開始會核取 [貼上] 單選按鈕。 無法與PSF_SELECTPASTELINK搭配使用。 這是預設值。
PSF_SELECTPASTELINK 指定呼叫對話框時，一開始會核取 [貼上連結] 單選按鈕。 無法與PSF_SELECTPASTE搭配使用。
PSF_CHECKDISPLAYASICON 指定呼叫對話框時，一開始會核取 [顯示為圖示] 複選框。
PSF_SHOWHELP 指定呼叫對話框時，會顯示 [說明] 按鈕。
pDataObject
指向要貼上的 COleDataObject 。 如果此值為 NULL，則會從剪貼簿取得 COleDataObject 。
pParentWnd
指向對話框物件所屬的父視窗對象或擁有者視窗物件（屬於類型 CWnd）。 如果是 NULL，對話框的父視窗會設定為主要應用程式視窗。
備註
此函式只會建構 COlePasteSpecialDialog 物件。 若要顯示對話框，請呼叫 DoModal 函 式。
如需詳細資訊，請參閱 Windows SDK 中的 OLEUIPASTEFLAG 列舉類型。
COlePasteSpecialDialog：：CreateItem
建立 [貼上特殊專案] 對話框中選擇的新專案。
BOOL CreateItem(COleClientItem* pNewItem);
參數
pNewItem
COleClientItem指向 實例。 不可以是 NULL。
傳回值
如果成功建立專案，則為非零;否則為 0。
備註
只有在 DoModal 傳回 IDOK 之後，才應該呼叫此函式。
COlePasteSpecialDialog：:D oModal
顯示 [OLE 貼上特殊] 對話框。
virtual INT_PTR DoModal();
傳回值
對話框的完成狀態。 下列其中一個值：
如果對話框已成功顯示，則為IDOK。
如果使用者取消對話框，IDCANCEL。
如果發生錯誤，則為IDABORT。 如果傳回 IDABORT，請呼叫
COleDialog::GetLastError成員函式以取得所發生錯誤類型的詳細資訊。 如需可能錯誤的清單，請參閱 Windows SDK 中的 OleUIPasteSpecial 函式。
備註
如果您要藉由設定 m_ps 結構的成員來初始化各種對話框控制件，您應該先執行此動作，再呼叫 DoModal，但在建構對話框對象之後。
如果 DoModal 傳回 IDOK，您可以呼叫其他成員函式，將使用者的設定或資訊輸入擷取到對話框中。
COlePasteSpecialDialog：：GetDrawAspect
判斷使用者是否選擇將選取的項目顯示為圖示。
DVASPECT GetDrawAspect() const;
傳回值
轉譯物件所需的方法。
DVASPECT_CONTENT如果對話框關閉時未核取 [顯示為圖示] 複選框，則傳回 。
DVASPECT_ICON關閉對話框時，如果核取 [顯示為圖示] 複選框，則會傳回 。
備註
只有在 DoModal 傳回 IDOK 之後，才呼叫此函式。
如需繪圖層面的詳細資訊，請參閱 Windows SDK 中的 FORMATETC 結構。
COlePasteSpecialDialog：：GetIconicMetafile
取得與用戶選取之專案相關聯的元檔。
HGLOBAL GetIconicMetafile() const;
傳回值
如果選取對話框關閉時選取 [顯示為圖示] 複選框，則為包含所選項目的圖示層面之元檔句柄，否則為 NULL。
COlePasteSpecialDialog：：GetPasteIndex
取得與用戶選取之專案相關聯的索引值。
int GetPasteIndex() const;
傳回值
用戶所選取結構陣列中的 OLEUIPASTEENTRY 索引。 執行貼上作業時，應該使用對應至所選索引的格式。
備註
如需詳細資訊，請參閱 Windows SDK 中的 OLEUIPASTEENTRY 結構。
COlePasteSpecialDialog：：GetSelectionType
決定使用者所做的選取類型。
UINT GetSelectionType() const;
傳回值
傳回所建立之選取範圍的型別。
備註
傳回型別值是由 Selection 類別中宣告的 COlePasteSpecialDialog 列舉型別所指定。
enum Selection {
pasteLink,
pasteNormal,
pasteOther,
pasteStatic
};
這些值的簡短描述如下：
COlePasteSpecialDialog::pasteLink已核取 [貼上連結] 單選按鈕，而選擇的格式是標準 OLE 格式。COlePasteSpecialDialog::pasteNormal已核取 [貼上] 單選按鈕，而選擇的格式為標準 OLE 格式。COlePasteSpecialDialog::pasteOther選取的格式不是標準 OLE 格式。COlePasteSpecialDialog::pasteStatic選擇的格式是元檔。
COlePasteSpecialDialog：：m_ps
OLEUIPASTESPECIAL 類型的結構，用來控制 [貼上特殊] 對話框的行為。
OLEUIPASTESPECIAL m_ps;
備註
您可以直接或透過成員函式修改此結構的成員。
如需詳細資訊，請參閱 Windows SDK 中的 OLEUIPASTESPECIAL 結構。