CUserTool 類別

發行項
03/15/2013

使用者工具是執行外部應用程式的功能表項目。 [自訂] 對話方塊 (CMFCToolBarsCustomizeDialog 類別) 的 [工具] 索引標籤可讓使用者將使用者工具並對每個使用者工具指定名稱、命令、引數和初始目錄。

class CUserTool : public CObject

成員

公用方法

名稱	描述
CUserTool::CopyIconToClipboard
CUserTool::DrawToolIcon	以指定的矩形的使用者工具圖示。
CUserTool::GetCommand	傳回包含這個命令文字與使用者工具的字串。
CUserTool::GetCommandId	傳回使用者工具之功能表項目的命令 ID。
CUserTool::Invoke	執行命令與使用者工具。
CUserTool::Serialize	讀取或寫入這個物件從或其中的檔案。 (覆寫 CObject::Serialize)。
CUserTool::SetCommand	設定與這個關聯命令使用者工具。
CUserTool::SetToolIcon	從應用程式載入使用者工具的圖示與工具。

受保護的方法

名稱	描述
CUserTool::LoadDefaultIcon	載入使用者工具的預設圖示。

資料成員

名稱	描述
CUserTool::m_strArguments	使用者工具的命令列引數。
CUserTool::m_strInitialDirectory	使用者工具的初始目錄。
CUserTool::m_strLabel	在工具的顯示功能表項目的工具名稱。

備註

如需如何啟用應用程式的使用者工具的詳細資訊，請參閱 CUserToolsManager 類別。

範例

下列範例示範如何從 CUserToolsManager 物件的工具，設定 m_strLabel 成員變數，並將使用者工具中執行的應用程式。這個程式碼片段是 Visual Studio 示範範例的一部分。

        // CUserToolsManager* pUserToolsManager
        CUserTool* pTool1 = pUserToolsManager->CreateNewTool();
        pTool1->m_strLabel = _T("&Notepad");
        pTool1->SetCommand(_T("notepad.exe"));