COleChangeIconDialog 類別
用於 OLE 的 [變更圖示] 對話方塊。
語法
class COleChangeIconDialog : public COleDialog
成員
公用建構函式
| 名稱 | 描述 |
|---|---|
| COleChangeIconDialog：：COleChangeIconDialog | 建構 COleChangeIconDialog 物件。 |
公用方法
| 名稱 | 描述 |
|---|---|
| COleChangeIconDialog：:D oChangeIcon | 執行對話框中指定的變更。 |
| COleChangeIconDialog：:D oModal | 顯示 [OLE 2 變更圖示] 對話框。 |
| COleChangeIconDialog：：GetIconicMetafile | 取得與這個專案之圖示形式相關聯的元檔句柄。 |
公用資料成員
| 名稱 | 描述 |
|---|---|
| COleChangeIconDialog：：m_ci | 結構，控制對話框的行為。 |
備註
當您要呼叫此對話框時，請建立 類別 COleChangeIconDialog 的物件。 COleChangeIconDialog建構 物件之後，您可以使用 m_ci 結構，初始化對話框中控件的值或狀態。 結構 m_ci 的類型為 OLEUICHANGEICON。 如需使用此對話框類別的詳細資訊，請參閱 DoModal 成員函式。
如需詳細資訊，請參閱 Windows SDK 中的 OLEUICHANGEICON 結構。
如需 OLE 特定對話框的詳細資訊，請參閱 OLE 中的對話框一文。
繼承階層架構
COleChangeIconDialog
需求
標頭： afxodlgs.h
COleChangeIconDialog：：COleChangeIconDialog
此函式只會 COleChangeIconDialog 建構物件。
explicit COleChangeIconDialog(
COleClientItem* pItem,
DWORD dwFlags = CIF_SELECTCURRENT,
CWnd* pParentWnd = NULL);
參數
pItem
指向要轉換的專案。
dwFlags
建立旗標，其中包含使用位或運算子結合的下列任何數目值：
CIF_SELECTCURRENT 指定呼叫對話框時，一開始會選取 [目前] 單選按鈕。 這是預設值。
CIF_SELECTDEFAULT 指定呼叫對話框時，一開始會選取 [預設] 單選按鈕。
CIF_SELECTFROMFILE 指定呼叫對話框時，一開始會選取 [從檔案] 單選按鈕。
CIF_SHOWHELP 指定呼叫對話框時，會顯示 [說明] 按鈕。
CIF_USEICONEXE 指定應該從 m_ci 欄位中指定的
szIconExe可執行檔擷取圖示，而不是從 類型擷取。 這對於內嵌或連結至非 OLE 檔案很有用。
pParentWnd
指向對話框物件所屬的父視窗對象或擁有者視窗物件（屬於類型 CWnd）。 如果是 NULL，對話框的父視窗將會設定為主要應用程式視窗。
備註
若要顯示對話框，請呼叫 DoModal 函 式。
如需詳細資訊，請參閱 Windows SDK 中的 OLEUICHANGEICON 結構。
COleChangeIconDialog：:D oChangeIcon
呼叫此函式，將代表專案之圖示變更為 DoModal 傳回 IDOK 之後對話框中選取的圖示。
BOOL DoChangeIcon(COleClientItem* pItem);
參數
pItem
指向圖示正在變更的專案。
傳回值
如果變更成功，則為非零;否則為 0。
COleChangeIconDialog：:D oModal
呼叫此函式以顯示 [OLE 變更圖示] 對話框。
virtual INT_PTR DoModal();
傳回值
對話框的完成狀態。 下列其中一個值：
如果對話框已成功顯示，則為IDOK。
如果使用者取消對話框，IDCANCEL。
如果發生錯誤，則為IDABORT。 如果傳回 IDABORT，請呼叫
COleDialog::GetLastError成員函式以取得所發生錯誤類型的詳細資訊。 如需可能錯誤的清單，請參閱 Windows SDK 中的 OleUIChangeIcon 函式。
備註
如果您要藉由設定m_ci結構的成員來初始化各種對話框控制件，您應該先執行此動作，再呼叫 DoModal，但在建構對話框對象之後。
如果 DoModal 傳回 IDOK，您可以呼叫其他成員函式，將使用者輸入的設定或資訊擷取到對話框中。
COleChangeIconDialog：：GetIconicMetafile
呼叫此函式，以取得包含所選專案之圖示層面的元檔句柄。
HGLOBAL GetIconicMetafile() const;
傳回值
如果對話框是透過選擇 [確定] 關閉對話框，則為包含新圖示圖示之圖示層面的元檔句柄，否則為對話框顯示前的圖示。
COleChangeIconDialog：：m_ci
OLEUICHANGEICON 類型的結構，用來控制 [變更圖示] 對話框的行為。
OLEUICHANGEICON m_ci;
備註
您可以直接或透過成員函式來修改這個結構的成員。
如需詳細資訊，請參閱 Windows SDK 中的 OLEUICHANGEICON 結構。