CUserTool Sınıfı

Kullanıcı aracı, dış uygulama çalıştıran bir menü öğesidir. Özelleştir iletişim kutusunun Araçlar sekmesi (CMFCToolBarsCustomizeDialog Sınıfı), kullanıcının kullanıcı araçları eklemesine ve her kullanıcı aracı için ad, komut, bağımsız değişkenler ve ilk dizini belirtmesine olanak tanır.

Sözdizimi

class CUserTool : public CObject

Üyeler

Genel Yöntemler

Veri Akışı Adı	Açıklama
CUserTool::CopyIconToClipboard
CUserTool::D rawToolIcon	Belirtilen dikdörtgende kullanıcı aracı simgesini çizer.
CUserTool::GetCommand	Kullanıcı aracıyla ilişkilendirilmiş komutun metnini içeren bir dize döndürür.
CUserTool::GetCommandId	Kullanıcı aracının menü öğesinin komut kimliğini döndürür.
CUserTool::Invoke	Kullanıcı aracıyla ilişkili komutu yürütür.
CUserTool::Serialize	Bu nesneyi bir arşivden veya arşivden okur veya yazar. (Geçersiz Kılmalar CObject::Serialize.)
CUserTool::SetCommand	Kullanıcı aracıyla ilişkili komutu ayarlar.
CUserTool::SetToolIcon	Araçla ilişkilendirilmiş uygulamadan kullanıcı aracının simgesini yükler.

Korumalı Yöntemler

Veri Akışı Adı	Açıklama
CUserTool::LoadDefaultIcon	Bir kullanıcı aracı için varsayılan simgeyi yükler.

Veri Üyeleri

Veri Akışı Adı	Açıklama
CUserTool::m_strArguments	Kullanıcı aracının komut satırı bağımsız değişkenleri.
CUserTool::m_strInitialDirectory	Kullanıcı aracının ilk dizini.
CUserTool::m_strLabel	Aracın menü öğesinde görüntülenen araç adı.

Açıklamalar

Uygulamanızda kullanıcı araçlarını etkinleştirme hakkında daha fazla bilgi için bkz . CUserToolsManager Sınıfı.

Örnek

Aşağıdaki örnekte bir nesneden CUserToolsManager araç oluşturma, üye değişkenini m_strLabel ayarlama ve kullanıcı aracının çalıştıracağı uygulamayı ayarlama işlemleri gösterilmektedir. Bu kod parçacığı Visual Studio Tanıtım örneğinin bir parçasıdır.

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

Devralma Hiyerarşisi

CObject

CUserTool

Gereksinimler

Üst bilgi: afxusertool.h

CUserTool::CopyIconToClipboard

Daha fazla ayrıntı için Visual Studio yüklemenizin VC\atlmfc\src\mfc klasöründe bulunan kaynak koduna bakın.

BOOL CopyIconToClipboard();

Dönüş Değeri

Açıklamalar

CUserTool::D rawToolIcon

Belirtilen dikdörtgenin ortasına kullanıcı aracı simgesini çizer.

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

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

rectImage
[in] Simgenin görüntüleneceği alanın koordinatlarını belirtir.

CUserTool::GetCommand

Kullanıcı aracıyla ilişkilendirilmiş komutun metnini içeren bir dize döndürür.

const CString& GetCommand() const;

Dönüş Değeri

CString Kullanıcı aracıyla ilişkilendirilmiş komutun metnini içeren nesne başvurusu.

CUserTool::GetCommandId

Kullanıcı aracının komut kimliğini döndürür.

UINT GetCommandId() const;

Dönüş Değeri

Bu kullanıcı aracının komut kimliği.

CUserTool::Invoke

Kullanıcı aracıyla ilişkili komutu yürütür.

virtual BOOL Invoke();

Dönüş Değeri

Komut başarıyla yürütüldüyse sıfır olmayan; aksi takdirde 0.

Açıklamalar

Kullanıcı aracıyla ilişkilendirilmiş bir komutu yürütmek için ShellExecute'ı çağırır. Komut boşsa veya ShellExecute başarısız olursa işlev başarısız olur.

CUserTool::LoadDefaultIcon

Bir kullanıcı aracı için varsayılan simgeyi yükler.

virtual HICON LoadDefaultIcon();

Dönüş Değeri

Yüklü simgenin (HICON) tutamacı veya varsayılan simge yüklenemediğinde NULL.

Açıklamalar

Çerçeve, aracın yürütülebilir dosyasından kullanıcı tanımlı bir araç için simge yükleyemediğinde bu yöntemi çağırır.

Kendi varsayılan araç simgenizi sağlamak için bu yöntemi geçersiz kılın.

CUserTool::m_strArguments

Kullanıcı aracının komut satırı bağımsız değişkenleri.

CString m_strArguments;

Açıklamalar

CUserTool::Invoke çağrısı yaptığınızda veya bir kullanıcı bu araçla ilişkilendirilmiş komuta tıkladığında bu dize araca geçirilir.

CUserTool::m_strInitialDirectory

Kullanıcı aracının ilk dizinini belirtir.

CString m_strInitialDirectory;

Açıklamalar

Bu değişken, CUserTool::Invoke çağrısı yaptığınızda veya bir kullanıcı bu araçla ilişkilendirilmiş komuta tıkladığında aracın yürütülürken çalıştırılacağını ilk dizini belirtir.

CUserTool::m_strLabel

Aracın menü öğesinde görüntülenen etiket.

CString m_strLabel;

CUserTool::Serialize

Daha fazla ayrıntı için Visual Studio yüklemenizin VC\atlmfc\src\mfc klasöründe bulunan kaynak koduna bakın.

virtual void Serialize(CArchive& ar);

Parametreler

[in] Ar

Açıklamalar

CUserTool::SetCommand

Kullanıcı aracının çalıştırdığını uygulamayı ayarlar.

void SetCommand(LPCTSTR lpszCmd);

Parametreler

lpszCmd
[in] Kullanıcı aracıyla ilişkilendirilecek yeni uygulamayı belirtir.

Açıklamalar

Kullanıcı aracının çalıştırdiği yeni bir uygulama ayarlamak için bu yöntemi çağırın. yöntemi eski simgeyi yok eder ve verilen uygulamadan yeni bir simge yükler. Uygulamadan bir simge yükleyemiyorsa, CUserTool::LoadDefaultIcon çağrısı yaparak bir kullanıcı aracı için varsayılan simgeyi yükler.

CUserTool::SetToolIcon

Aracın kullandığı uygulamadan kullanıcı aracının simgesini yükler.

virtual HICON SetToolIcon();

Dönüş Değeri

Yüklenen simgenin tutamacı.

Açıklamalar

Menü öğesinde görüntülenecek simgeyi yüklemek için bu yöntemi çağırın. Bu yöntem, aracın kullandığı yürütülebilir dosyadaki simgeyi arar. Varsayılan bir simgesi yoksa, bunun yerine CUserTool::LoadDefaultIcon tarafından sağlanan simge kullanılır.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CWinAppEx Sınıfı
CUserToolsManager Sınıfı