CUserTool osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

A felhasználói eszköz egy külső alkalmazást futtató menüelem. A Testreszabás párbeszédpanel Eszközök lapja (CMFCToolBarsCustomizeDialog Osztály) lehetővé teszi a felhasználó számára a felhasználói eszközök hozzáadását, valamint az egyes felhasználói eszközök nevét, parancsait, argumentumait és kezdeti könyvtárát.

Szemantika

class CUserTool : public CObject

Tagok

Nyilvános módszerek

Név	Description
CUserTool::CopyIconToClipboard
CUserTool::D rawToolIcon	Megrajzolja a felhasználói eszköz ikont egy megadott téglalapban.
CUserTool::GetCommand	A felhasználói eszközhöz társított parancs szövegét tartalmazó sztringet ad vissza.
CUserTool::GetCommandId	A felhasználói eszköz menüelemének parancsazonosítóját adja vissza.
CUserTool::Invoke	Végrehajtja a felhasználói eszközhöz társított parancsot.
CUserTool::Szerializálás	Beolvassa vagy beírja ezt az objektumot egy archívumból vagy egy archívumba. (Felülbírálja a CObject::Serialize parancsot.)
CUserTool::SetCommand	Beállítja a felhasználói eszközhöz társított parancsot.
CUserTool::SetToolIcon	Betölti a felhasználói eszköz ikont az eszközhöz társított alkalmazásból.

Védett metódusok

Név	Description
CUserTool::LoadDefaultIcon	Betölti az alapértelmezett ikont egy felhasználói eszközhöz.

Adattagok

Név	Description
CUserTool::m_strArguments	A felhasználói eszköz parancssori argumentumai.
CUserTool::m_strInitialDirectory	A felhasználói eszköz kezdeti könyvtára.
CUserTool::m_strLabel	Az eszköz menüelemében megjelenő eszköznév.

Megjegyzések

A felhasználói eszközök alkalmazásbeli engedélyezéséről további információt a CUserToolsManager osztályban talál.

Example

Az alábbi példa bemutatja, hogyan hozhat létre eszközt egy CUserToolsManager objektumból, állíthatja be a m_strLabel tagváltozót, és állíthatja be a felhasználói eszköz által futtatott alkalmazást. Ez a kódrészlet a Visual Studio Demo-minta része.

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

Öröklési hierarchia

CObject

CUserTool

Requirements

Fejléc: afxusertool.h

CUserTool::CopyIconToClipboard

További részletekért tekintse meg a Visual Studio-telepítés VC\atlmfc\src\mfc mappájában található forráskódot.

BOOL CopyIconToClipboard();

Visszaadott érték

Megjegyzések

CUserTool::D rawToolIcon

Megrajzolja a felhasználói eszköz ikonját egy megadott téglalap közepén.

void DrawToolIcon(
    CDC* pDC,
    const CRect& rectImage);

Paraméterek

Pdc
[in] Egy eszközkörnyezetre mutató mutató.

rectImage
[in] Megadja az ikon megjelenítéséhez a terület koordinátáit.

CUserTool::GetCommand

A felhasználói eszközhöz társított parancs szövegét tartalmazó sztringet ad vissza.

const CString& GetCommand() const;

Visszaadott érték

Hivatkozás a CString felhasználói eszközhöz társított parancs szövegét tartalmazó objektumra.

CUserTool::GetCommandId

A felhasználói eszköz parancsazonosítóját adja vissza.

UINT GetCommandId() const;

Visszaadott érték

A felhasználói eszköz parancsazonosítója.

CUserTool::Invoke

Végrehajtja a felhasználói eszközhöz társított parancsot.

virtual BOOL Invoke();

Visszaadott érték

Nonzero, ha a parancs végrehajtása sikeresen megtörtént; egyéb esetben 0.

Megjegyzések

Meghívja a ShellExecute parancsot a felhasználói eszközhöz társított parancs végrehajtására. A függvény meghiúsul, ha a parancs üres, vagy ha a ShellExecute sikertelen.

CUserTool::LoadDefaultIcon

Betölti az alapértelmezett ikont egy felhasználói eszközhöz.

virtual HICON LoadDefaultIcon();

Visszaadott érték

Ha az alapértelmezett ikon nem tölthető be, a betöltött ikonhoz (HICON) vagy NULL értékhez tartozó fogópont.

Megjegyzések

A keretrendszer akkor hívja meg ezt a metódust, ha nem tudja betölteni a felhasználó által definiált eszköz ikonját az eszköz végrehajtható fájljából.

A metódus felülbírálása a saját alapértelmezett eszközikon megadásához.

CUserTool::m_strArguments

A felhasználói eszköz parancssori argumentumai.

CString m_strArguments;

Megjegyzések

Ezt a sztringet a rendszer a CUserTool hívásakor továbbítja az eszköznek::Meghívja , vagy amikor egy felhasználó az eszközhöz társított parancsra kattint.

CUserTool::m_strInitialDirectory

Megadja a felhasználói eszköz kezdeti könyvtárát.

CString m_strInitialDirectory;

Megjegyzések

Ez a változó azt a kezdeti könyvtárat adja meg, amelyben az eszköz a CUserTool hívásakor fut::Meghívás vagy amikor egy felhasználó az eszközhöz társított parancsra kattint.

CUserTool::m_strLabel

Az eszköz menüelemében megjelenő címke.

CString m_strLabel;

CUserTool::Szerializálás

További részletekért tekintse meg a Visual Studio-telepítés VC\atlmfc\src\mfc mappájában található forráskódot.

virtual void Serialize(CArchive& ar);

Paraméterek

[in] Ar

Megjegyzések

CUserTool::SetCommand

Beállítja a felhasználói eszköz által futtatott alkalmazást.

void SetCommand(LPCTSTR lpszCmd);

Paraméterek

lpszCmd
[in] Megadja a felhasználói eszközhöz társítandó új alkalmazást.

Megjegyzések

Hívja meg ezt a metódust egy új alkalmazás beállításához, amelyet a felhasználói eszköz futtat. A metódus megsemmisíti a régi ikont, és betölt egy új ikont az adott alkalmazásból. Ha nem tud betölteni egy ikont az alkalmazásból, betölti a felhasználói eszköz alapértelmezett ikont a CUserTool::LoadDefaultIcon meghívásával.

CUserTool::SetToolIcon

Betölti a felhasználói eszköz ikont az eszköz által használt alkalmazásból.

virtual HICON SetToolIcon();

Visszaadott érték

A betöltött ikon fogópontja.

Megjegyzések

Hívja meg ezt a metódust, hogy betöltse a menüelemen megjelenítendő ikont. Ez a metódus az eszköz által használt végrehajtható fájlban keresi az ikont. Ha nincs alapértelmezett ikonja, a CUserTool::LoadDefaultIcon ikont használja helyette.

Lásd még

hierarchiadiagram
osztályok
CWinAppEx osztály
CUserToolsManager osztály