Sdílet prostřednictvím

CMouseManager – třída

  • Článek

Umožňuje uživateli přidružit různé příkazy k určitému objektu CView , když uživatel dvakrát klikne uvnitř tohoto zobrazení.

Syntaxe

class CMouseManager : public CObject

Členové

Veřejné metody

Název Popis
CMouseManager::AddView CView Přidá objekt do dialogového okna Vlastní nastavení. Dialogové okno Vlastní nastavení umožňuje uživateli přidružit poklikání k příkazu pro každé z uvedených zobrazení.
CMouseManager::GetViewDblClickCommand Vrátí příkaz, který se spustí, když uživatel pokliká uvnitř zadaného zobrazení.
CMouseManager::GetViewIconId Vrátí ikonu přidruženou k zadanému ID zobrazení.
CMouseManager::GetViewIdByName Vrátí ID zobrazení přidružené k zadanému názvu zobrazení.
CMouseManager::GetViewNames Načte seznam všech přidaných názvů zobrazení.
CMouseManager::LoadState CMouseManager Načte stav z registru Systému Windows.
CMouseManager::SaveState CMouseManager Zapíše stav do registru Systému Windows.
CMouseManager::SetCommandForDblClk Přidruží zadaný příkaz a zadané zobrazení.

Poznámky

Třída CMouseManager udržuje kolekci CView objektů. Každé zobrazení je identifikované názvem a ID. Tato zobrazení se zobrazují v dialogovém okně Vlastní nastavení . Uživatel může změnit příkaz přidružený k libovolnému zobrazení prostřednictvím dialogového okna Přizpůsobení . Přidružený příkaz se spustí, když uživatel pokliká v daném zobrazení. Chcete-li to podporovat z hlediska kódování, musíte zpracovat WM_LBUTTONDBLCLK zprávu a volat CWinAppEx::OnViewDoubleClick funkce v kódu tohoto CView objektu..

Objekt byste neměli vytvářet CMouseManager ručně. Vytvoří se v rámci vaší aplikace. Bude také zničen automaticky, když uživatel ukončí aplikaci. Pokud chcete získat ukazatel na správce myši pro vaši aplikaci, zavolejte CWinAppEx::GetMouseManager.

Hierarchie dědičnosti

Objekt CObject

CMouseManager

Požadavky

Hlavička: afxmousemanager.h

CMouseManager::AddView

Zaregistruje objekt CView pomocí třídy CMouseManager pro podporu vlastní chování myši.

BOOL AddView(
    int iViewId,
    UINT uiViewNameResId,
    UINT uiIconId = 0);

BOOL AddView(
    int iId,
    LPCTSTR lpszViewName,
    UINT uiIconId = 0);

Parametry

iViewId
[v] ID zobrazení.

uiViewNameResId
[v] ID řetězce prostředku, které odkazuje na název zobrazení.

uiIconId
[v] ID ikony zobrazení

iId
[v] ID zobrazení.

lpszViewName
[v] Název zobrazení.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Aby bylo možné podporovat vlastní chování myši, musí být u objektu CMouseManager zaregistrováno zobrazení. Jakýkoli objekt odvozený z CView třídy lze zaregistrovat pomocí správce myši. Řetězec a ikona přidružená k zobrazení se zobrazí na kartě Myš v dialogovém okně Přizpůsobit.

Je zodpovědností programátora vytvářet a udržovat ID zobrazení, jako je iViewId a iId.

Další informace o tom, jak poskytovat vlastní chování myši, naleznete v tématu Přizpůsobení klávesnice a myši.

Příklad

Následující příklad ukazuje, jak načíst ukazatel na CMouseManager objekt pomocí CWinAppEx::GetMouseManager metody a AddView metody ve CMouseManager třídě. Tento fragment kódu je součástí ukázky kolekce stavů.

GetMouseManager()->AddView(IDR_MAINFRAME, _T("My view"), IDR_MAINFRAME);

CMouseManager::GetViewDblClickCommand

Vrátí příkaz, který se spustí, když uživatel pokliká uvnitř zadaného zobrazení.

UINT GetViewDblClickCommand(int iId) const;

Parametry

iId
[v] ID zobrazení.

Návratová hodnota

Identifikátor příkazu, pokud je zobrazení přidružené k příkazu; jinak 0.

CMouseManager::GetViewIconId

Načte ikonu přidruženou k ID zobrazení.

UINT GetViewIconId(int iViewId) const;

Parametry

iViewId
[v] ID zobrazení.

Návratová hodnota

Identifikátor prostředku ikony v případě úspěchu; jinak 0.

Poznámky

Tato metoda selže, pokud zobrazení není poprvé registrováno pomocí CMouseManager::AddView.

CMouseManager::GetViewIdByName

Načte ID zobrazení přidružené k názvu zobrazení.

int GetViewIdByName(LPCTSTR lpszName) const;

Parametry

lpszName
[v] Název zobrazení.

Návratová hodnota

ID zobrazení v případě úspěchu; jinak 0.

Poznámky

Tato metoda vyhledá zobrazení zaregistrovaná pomocí CMouseManager::AddView.

CMouseManager::GetViewNames

Načte seznam všech registrovaných názvů zobrazení.

void GetViewNames(CStringList& listOfNames) const;

Parametry

listOfNames
[ven] Odkaz na CStringList objekt.

Poznámky

Tato metoda vyplní parametr listOfNames názvy všech zobrazení registrovaných pomocí CMouseManager::AddView.

CMouseManager::LoadState

Načte stav třídy CMouseManager z registru.

BOOL LoadState(LPCTSTR lpszProfileName = NULL);

Parametry

lpszProfileName
[v] Cesta klíče registru.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Informace o stavu načtené z registru zahrnují registrovaná zobrazení, identifikátory zobrazení a přidružené příkazy. Pokud je parametr lpszProfileName NULL, tato funkce načte CMouseManager data z výchozího umístění registru řízeného třídou CWinAppEx.

Ve většině případů nemusíte tuto funkci volat přímo. Volá se jako součást procesu inicializace pracovního prostoru. Další informace o procesu inicializace pracovního prostoru naleznete v tématu CWinAppEx::LoadState.

CMouseManager::SaveState

Zapíše stav třídy CMouseManager do registru.

BOOL SaveState(LPCTSTR lpszProfileName = NULL);

Parametry

lpszProfileName
[v] Cesta klíče registru.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Informace o stavu zapsané do registru zahrnují všechna registrovaná zobrazení, identifikátory zobrazení a přidružené příkazy. Pokud je parametr lpszProfileName NULL, tato funkce zapíše CMouseManager data do výchozího umístění registru řízeného třídou CWinAppEx.

Ve většině případů nemusíte tuto funkci volat přímo. Volá se jako součást procesu serializace pracovního prostoru. Další informace o procesu serializace pracovního prostoru naleznete v tématu CWinAppEx::SaveState.

CMouseManager::SetCommandForDblClk

Přidruží vlastní příkaz k zobrazení, které je poprvé registrováno u správce myši.

void SetCommandForDblClk(
    int iViewId,
    UINT uiCmd);

Parametry

iViewId
[v] Identifikátor zobrazení.

uiCmd
[v] Identifikátor příkazu.

Poznámky

Chcete-li přidružit vlastní příkaz k zobrazení, musíte nejprve zaregistrovat zobrazení pomocí CMouseManager::AddView. Metoda AddView vyžaduje identifikátor zobrazení jako vstupní parametr. Po registraci zobrazení můžete volat CMouseManager::SetCommandForDblClk se stejným vstupním parametrem identifikátoru zobrazení, do AddViewkterého jste zadali . Poté, když uživatel dvakrát klikne myší v registrovaném zobrazení, aplikace spustí příkaz označený uiCmd. Pokud chcete podporovat vlastní chování myši, budete také muset přizpůsobit zobrazení zaregistrované ve správci myši. Další informace o vlastním chování myši naleznete v tématu Přizpůsobení klávesnice a myši.

Pokud je vlastnost uiCmd nastavená na hodnotu 0, zadané zobrazení už není přidružené k příkazu.

Viz také

Graf hierarchie
Třídy
CWinAppEx – třída
Přizpůsobení klávesnice a myši