Megosztás a következőn keresztül:

CMFCToolBarsCustomizeDialog 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.

Modeless tab dialog box ( CPropertySheet Class), amely lehetővé teszi a felhasználó számára, hogy testre szabja az eszköztárakat, menüket, billentyűparancsokat, felhasználó által definiált eszközöket és vizuális stílust egy alkalmazásban. A felhasználó általában az Eszközök menü Testreszabás elemével fér hozzá ehhez a párbeszédpanelhez.

A Testreszabás párbeszédpanelen hat lap található: Parancsok, Eszköztárak, Eszközök, Billentyűzet, Menü és Beállítások.

Szemantika

class CMFCToolBarsCustomizeDialog : public CPropertySheet

Tagok

Nyilvános konstruktorok

Név Description
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog Egy CMFCToolBarsCustomizeDialog objektumot hoz létre.
CMFCToolBarsCustomizeDialog::~CMFCToolBarsCustomizeDialog Destruktor.

Nyilvános metódusok

Név Description
CMFCToolBarsCustomizeDialog::AddButton Eszköztár gomb beszúrása a Parancsok lap parancslistájába
CMFCToolBarsCustomizeDialog::AddMenu Betölt egy menüt az erőforrásokból, és meghívja a CMFCToolBarsCustomizeDialog::AddMenuCommands parancsokat a parancsok listájához a Parancsok lapon.
CMFCToolBarsCustomizeDialog::AddMenuCommands Betölt egy menüt az erőforrásokból, és meghívja a CMFCToolBarsCustomizeDialog::AddMenuCommands parancsokat a parancsok listájához a Parancsok lapon.
CMFCToolBarsCustomizeDialog::AddToolBar Betölt egy eszköztárat az erőforrásokból. Ezután a menü minden parancsához meghívja a CMFCToolBarsCustomizeDialog::AddButton metódust, hogy beszúrjon egy gombot a parancsok listájába a parancsok listájában a megadott kategória alatt.
CMFCToolBarsCustomizeDialog::Létrehozás Megjeleníti a Testreszabás párbeszédpanelt.
CMFCToolBarsCustomizeDialog::EnableTools Jövőbeli használatra fenntartva.
CMFCToolBarsCustomizeDialog::EnableUserDefinedToolbars Engedélyezi vagy letiltja az új eszköztárak létrehozását a Testreszabás párbeszédpanelen.
CMFCToolBarsCustomizeDialog::FillAllCommandsList Kitölti a megadott CListBox objektumot a Minden parancs kategóriában található parancsokkal .
CMFCToolBarsCustomizeDialog::FillCategoriesComboBox Kitölti a megadott CComboBox objektumot az egyes parancskategóriák nevével a Testreszabás párbeszédpanelen.
CMFCToolBarsCustomizeDialog::FillCategoriesListBox Kitölti a megadott CListBox objektumot az egyes parancskategóriák nevével a Testreszabás párbeszédpanelen.
CMFCToolBarsCustomizeDialog::GetCommandName Lekéri a megadott parancsazonosítóhoz társított nevet.
CMFCToolBarsCustomizeDialog::GetCountInCategory Lekéri a megadott lista azon elemeinek számát, amelyek adott szövegfeliratot kaptak.
CMFCToolBarsCustomizeDialog::GetFlags Lekéri a párbeszédpanel viselkedését befolyásoló jelzőket.
CMFCToolBarsCustomizeDialog::GetThisClass A keretrendszer az ehhez az osztálytípushoz társított CRuntimeClass objektumra mutató mutató lekéréséhez használja.
CMFCToolBarsCustomizeDialog::OnEditToolbarMenuImage Elindít egy képszerkesztőt, hogy a felhasználó testre szabhassa az eszköztárgombot vagy a menüelem ikont.
CMFCToolBarsCustomizeDialog::OnInitDialog Felülbírálások a tulajdonságlap inicializálásának kiegészítéséhez. (Felülbírálások CPropertySheet::OnInitDialog.)
CMFCToolBarsCustomizeDialog::P ostNcDestroy A keretrendszer hívta, miután az ablak elpusztult. (Felülbírálások CPropertySheet::PostNcDestroy.)
CMFCToolBarsCustomizeDialog::RemoveButton Eltávolítja a megadott parancsazonosítóval rendelkező gombot a megadott kategóriából vagy az összes kategóriából.
CMFCToolBarsCustomizeDialog::RenameCategory Átnevez egy kategóriát a Parancsok lap kategóriák listájában.
CMFCToolBarsCustomizeDialog::ReplaceButton Lecserél egy gombot a Parancsok lap parancslistájában egy új eszköztárgomb-objektumra.
CMFCToolBarsCustomizeDialog::SetUserCategory Hozzáad egy kategóriát a Parancsok lapon megjelenő kategóriák listájához.

Védett metódusok

Név Description
CMFCToolBarsCustomizeDialog::CheckToolsValidity A keretrendszer meghívta, hogy megállapítsa, hogy a felhasználó által definiált eszközök listája érvényes-e.
CMFCToolBarsCustomizeDialog::OnAfterChangeTool A keretrendszer meghívja, amikor egy felhasználó által definiált eszköz tulajdonságai megváltoznak.
CMFCToolBarsCustomizeDialog::OnAssignKey Meghatározza, hogy egy adott billentyűparancs hozzárendelhető-e egy művelethez.
CMFCToolBarsCustomizeDialog::OnBeforeChangeTool Meghatározza, hogy módosítható-e a felhasználó által definiált eszköz.
CMFCToolBarsCustomizeDialog::OnInitToolsPage A rendszer meghívja a keretrendszert, amikor a felhasználó az Eszközök lapot választja.

Megjegyzések

A Testreszabás párbeszédpanel megjelenítéséhez hozzon létre egy CMFCToolBarsCustomizeDialog objektumot, és hívja meg a CMFCToolBarsCustomizeDialog::Create metódust.

Amíg a Testreszabás párbeszédpanel aktív, az alkalmazás speciális módban működik, amely korlátozza a felhasználót a testreszabási feladatokra.

Example

Az alábbi példa bemutatja, hogyan használhat különböző metódusokat az CMFCToolBarsCustomizeDialog osztályban. A példa bemutatja, hogyan cserélhet le egy eszköztárgombot a parancsok listájában a Parancsok lapon, hogyan engedélyezheti az új eszköztárak létrehozását a Testreszabás párbeszédpanelen, és hogyan jelenítheti meg a Testreszabás párbeszédpanelt. Ez a kódrészlet az IE Demo-minta része.

pDlgCust->ReplaceButton(ID_FAVORITS_DUMMY,
                        CMFCToolBarMenuButton((UINT)-1, menuFavorites, -1, strFavorites));
pDlgCust->EnableUserDefinedToolbars();
pDlgCust->Create();

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CPropertySheet

CMFCToolBarsCustomizeDialog

Requirements

Fejléc: afxToolBarsCustomizeDialog.h

CMFCToolBarsCustomizeDialog::AddButton

Beszúr egy eszköztárgombot a Parancsok lap parancslistájába.

void AddButton(
    UINT uiCategoryId,
    const CMFCToolBarButton& button,
    int iInsertBefore=-1);

void AddButton(
    LPCTSTR lpszCategory,
    const CMFCToolBarButton& button,
    int iInsertBefore=-1);

Paraméterek

uiCategoryId
[in] Megadja azt a kategóriaazonosítót, amelybe be szeretné szúrni a gombot.

Gomb
[in] Megadja a beszúrni kívánt gombot.

iInsertBefore
[in] Megadja annak az eszköztárgombnak a nullaalapú indexét, amely elé a gomb be van szúrva.

lpszCategory
[in] Megadja a gomb beszúrásához kívánt kategóriasztringet.

Megjegyzések

A AddButton metódus figyelmen kívül hagyja a szokásos parancsazonosítókkal (például ID_FILE_MRU_FILE1), a nem engedélyezett parancsokkal (lásd : CMFCToolBar::IsCommandPermitted) és a próbagombokkal rendelkező gombokat.

Ez a metódus a gomb futtatókörnyezeti osztályával létrehoz egy új, a cmFCToolBarButton osztályhoz hasonló típusú button objektumot. Ezután meghívja a CMFCToolBarButton::CopyFrom parancsot a gomb adattagjainak másolásához, és beszúrja a másolatot a megadott kategóriába.

Az új gomb beszúrása után megkapja az OnAddToCustomizePage értesítést.

Ha iInsertBefore -1, a gomb hozzá lesz fűzve a kategóriák listájához, ellenkező esetben a program a megadott indexet tartalmazó elem elé szúrja be.

Example

Az alábbi példa bemutatja, hogyan használható az AddButtonCMFCToolBarsCustomizeDialog osztály metódusa. Ez a kódrészlet a Csúszka minta része.

CMFCToolBarsCustomizeDialog *pDlgCust = new CMFCToolBarsCustomizeDialog(this,
                                                                        TRUE /* Automatic menus scanning */);

CSliderButton btnSlider(ID_SLIDER);
btnSlider.SetRange(0, 100);

pDlgCust->AddButton(_T("Edit"), btnSlider);

CMFCToolBarsCustomizeDialog::AddMenu

Betölt egy menüt az erőforrásokból, és meghívja a CMFCToolBarsCustomizeDialog::AddMenuCommands parancsokat a parancsok listájához a Parancsok lapon.

BOOL AddMenu(UINT uiMenuResId);

Paraméterek

uiMenuResId
[in] Megadja a betöltendő menü erőforrás-azonosítóját.

Visszaadott érték

IGAZ, ha sikeresen hozzáadtak egy menüt; egyéb esetben HAMIS.

Megjegyzések

A hívásban AddMenuCommandsa bPopup ÉRTÉKE HAMIS. Ennek eredményeképpen ez a metódus nem ad hozzá almenüt tartalmazó menüelemeket a parancsok listájához. Ez a módszer felveszi az almenü menüelemeit a parancsok listájába.

CMFCToolBarsCustomizeDialog::AddMenuCommands

Elemeket ad hozzá a parancsok listájához a Parancsok lapon, hogy a megadott menü összes elemét képviselje.

void AddMenuCommands(
    const CMenu* pMenu,
    BOOL bPopup,
    LPCTSTR lpszCategory=NULL,
    LPCTSTR lpszMenuPath=NULL);

Paraméterek

pMenu
[in] A hozzáadni kívánt CMenu objektumra mutató mutató.

bPopup
[in] Megadja, hogy beszúrja-e az előugró menüelemeket a parancsok listájába.

lpszCategory
[in] A menü beszúrásához a kategória neve.

lpszMenuPath
[in] Egy előtag, amely akkor lesz hozzáadva a névhez, amikor a parancs megjelenik az Összes kategória listában.

Megjegyzések

A AddMenuCommands metódus a pMenu összes menüelemére hurkol. Ez a metódus létrehoz egy CMFCToolBarButton osztályobjektumot minden olyan menüelemhez, amely nem tartalmaz almenüt, és meghívja a CMFCToolBarsCustomizeDialog::AddButton metódust, hogy eszköztárgombként adja hozzá a menüelemet a Parancsok lap parancslistájához. Ebben a folyamatban a rendszer figyelmen kívül hagyja az elválasztókat.

Ha a bPopup ÉRTÉKE IGAZ, a metódus minden almenüt tartalmazó menüelemhez létrehoz egy CMFCToolBarMenuButton osztályobjektumot , és meghívva AddButtonbeszúrja a parancsok listájába. Ellenkező esetben az almenüket tartalmazó menüelemek nem jelennek meg a parancsok listájában. Mindkét esetben, amikor AddMenuCommands egy almenüvel találkozik, rekurzívan hívja magát, pMenu paraméterként egy mutatót ad át az almenünek, és hozzáfűzi az almenü címkéjét az lpszMenuPathhoz.

CMFCToolBarsCustomizeDialog::AddToolBar

Betölt egy eszköztárat az erőforrásokból. Ezután a menü minden parancsához meghívja a CMFCToolBarsCustomizeDialog::AddButton metódust, hogy beszúrjon egy gombot a parancsok listájába a parancsok listájában a megadott kategória alatt.

BOOL AddToolBar(
    UINT uiCategoryId,
    UINT uiToolbarResId);

BOOL AddToolBar(
    LPCTSTR lpszCategory,
    UINT uiToolbarResId);

Paraméterek

uiCategoryId
[in] Megadja annak a kategóriának az erőforrás-azonosítóját, amelybe hozzá szeretné adni az eszköztárat.

uiToolbarResId
[in] Megadja annak az eszköztárnak az erőforrás-azonosítóját, amelynek parancsai be vannak szúrva a parancsok listájába.

lpszCategory
[in] Megadja annak a kategóriának a nevét, amelyhez hozzá szeretné adni az eszköztárat.

Visszaadott érték

IGAZ, ha a módszer sikeres; egyéb esetben HAMIS.

Example

Az alábbi példa bemutatja, hogyan használható a AddToolBar metódus az CMFCToolBarsCustomizeDialog osztályban. Ez a kódrészlet a Word Pad-minta része.

CMFCToolBarsCustomizeDialog *pDlgCust = new CMFCToolBarsCustomizeDialog(this,
                                                                        TRUE /* Automatic menus scanning */,
                                                                        AFX_CUSTOMIZE_MENU_SHADOWS | AFX_CUSTOMIZE_TEXT_LABELS |
                                                                            AFX_CUSTOMIZE_MENU_ANIMATIONS);

pDlgCust->AddToolBar(_T("Format"), IDR_FORMATBAR);

Megjegyzések

Az egyes parancsok megjelenítésére használt vezérlő egy CMFCToolBarButton osztályobjektum . Az eszköztár hozzáadása után lecserélheti a gombot egy származtatott típusú vezérlőre a CMFCToolBarsCustomizeDialog::ReplaceButton meghívásával.

CMFCToolBarsCustomizeDialog::CheckToolsValidity

Ellenőrzi a felhasználói eszközök listájának érvényességét.

virtual BOOL CheckToolsValidity(const CObList& lstTools);

Paraméterek

lstTools
[in] Az ellenőrizendő, felhasználó által definiált eszközök listája.

Visszaadott érték

IGAZ értéket ad vissza, ha a felhasználó által definiált eszközök listája érvényes; egyéb esetben HAMIS. Az alapértelmezett implementáció mindig IGAZ értéket ad vissza.

Megjegyzések

A keretrendszer meghívja ezt a metódust a CMFCToolBarsCustomizeDialog::CheckToolsValidity által visszaadott, felhasználó által megadott eszközöket képviselő objektumok érvényességének ellenőrzésére.

Bírálja felül a CheckToolsValidity metódust egy olyan osztályban, amelyből CMFCToolBarsCustomizeDialog származik, ha ellenőrizni szeretné a felhasználói eszközöket, mielőtt a felhasználó bezárja a párbeszédpanelt. Ha ez a metódus HAMIS értéket ad vissza, amikor a felhasználó a párbeszédpanel jobb felső sarkában lévő Bezárás gombra vagy a párbeszédpanel jobb alsó sarkában a Bezárás gombra kattint, a párbeszédpanelen a bezárás helyett az Eszközök lap jelenik meg. Ha ez a metódus HAMIS értéket ad vissza, amikor a felhasználó egy fülre kattint az Eszközök lapról való navigáláshoz, a navigáció nem történik meg. Meg kell jelenítenie egy megfelelő üzenetmezőt, amely tájékoztatja a felhasználót az ellenőrzés meghiúsulását okozó problémáról.

CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog

Egy CMFCToolBarsCustomizeDialog objektumot hoz létre.

CMFCToolBarsCustomizeDialog(
    CFrameWnd* pWndParentFrame,
    BOOL bAutoSetFromMenus = FALSE,
    UINT uiFlags = (AFX_CUSTOMIZE_MENU_SHADOWS | AFX_CUSTOMIZE_TEXT_LABELS | AFX_CUSTOMIZE_MENU_ANIMATIONS | AFX_CUSTOMIZE_NOHELP),
    CList <CRuntimeClass*, CRuntimeClass*>* p listCustomPages = NULL);

Paraméterek

pWndParentFrame
[in] Mutató a szülőkerethez. Ez a paraméter nem lehet NULL értékű.

bAutoSetFromMenus
[in] Logikai érték, amely meghatározza, hogy az összes menü menüparancsai hozzáadva legyenek-e a parancsok listájához a Parancsok lapon. Ha ez a paraméter IGAZ, a menüparancsok hozzá lesznek adva. Ellenkező esetben a menüparancsok nem lesznek hozzáadva.

uiFlags
[in] A párbeszédpanel viselkedését befolyásoló jelzők kombinációja. Ez a paraméter a következő értékek közül egy vagy több lehet:

  • AFX_CUSTOMIZE_MENU_SHADOWS

  • AFX_CUSTOMIZE_TEXT_LABELS

  • AFX_CUSTOMIZE_MENU_ANIMATIONS

  • AFX_CUSTOMIZE_NOHELP

  • AFX_CUSTOMIZE_CONTEXT_HELP

  • AFX_CUSTOMIZE_NOTOOLS

  • AFX_CUSTOMIZE_MENUAMPERS

  • AFX_CUSTOMIZE_NO_LARGE_ICONS

plistCustomPages
[in] Mutató a további egyéni lapokat meghatározó objektumok listájára CRuntimeClass .

Megjegyzések

A plistCustomPages paraméter a további egyéni lapokat meghatározó objektumok listájára CRuntimeClass hivatkozik. A konstruktor a CRuntimeClass::CreateObject metódussal további lapokat ad hozzá a párbeszédpanelhez. A CustomPages-minta egy olyan példát mutat be, amely további lapokat ad hozzá a Testreszabás párbeszédpanelhez.

Az uiFlags paraméterben átadható értékekről további információt a CMFCToolBarsCustomizeDialog::GetFlags című témakörben talál.

Example

Az alábbi példa bemutatja, hogyan hozhat létre egy objektumot az CMFCToolBarsCustomizeDialog osztályból. Ez a kódrészlet az Egyéni lapok minta része.

CMFCToolBarsCustomizeDialog *pDlgCust = new CMFCToolBarsCustomizeDialog(this,
                                                                        TRUE /* Automatic menus scanning */,
                                                                        AFX_CUSTOMIZE_MENU_SHADOWS | AFX_CUSTOMIZE_TEXT_LABELS |
                                                                            AFX_CUSTOMIZE_MENU_ANIMATIONS, // default parameters
                                                                        &lstCustomPages);                  // pointer to the list of runtime classes of the custom property pages

CMFCToolBarsCustomizeDialog::Létrehozás

Megjeleníti a Testreszabás párbeszédpanelt.

virtual BOOL Create();

Visszaadott érték

IGAZ, ha a testreszabási tulajdonságlap sikeresen létrejött; egyéb esetben HAMIS.

Megjegyzések

Csak az Create osztály teljes inicializálása után hívja meg a metódust.

CMFCToolBarsCustomizeDialog::EnableUserDefinedToolbars

Engedélyezi vagy letiltja az új eszköztárak létrehozását a Testreszabás párbeszédpanelen.

void EnableUserDefinedToolbars(BOOL bEnable=TRUE);

Paraméterek

bEnable
[in] IGAZ a felhasználó által definiált eszköztárak engedélyezéséhez; HAMIS az eszköztárak letiltásához.

Megjegyzések

Ha a bEnable értéke IGAZ, az Eszköztárak lapon megjelenik az Új, az Átnevezés és a Törlés gomb.

Alapértelmezés szerint, vagy ha a bEnable HAMIS, ezek a gombok nem jelennek meg, és a felhasználó nem tud új eszköztárakat definiálni.

CMFCToolBarsCustomizeDialog::FillAllCommandsList

Kitölti a megadott CListBox objektumot a Minden parancs kategóriában található parancsokkal .

virtual void FillAllCommandsList(CListBox& wndListOfCommands) const;

Paraméterek

wndListOfCommands
[kifelé] Hivatkozás a CListBox feltöltendő objektumra.

Megjegyzések

A Minden parancs kategória az összes kategória parancsait tartalmazza. A CMFCToolBarsCustomizeDialog::AddButton metódus hozzáadja a megadott gombhoz társított parancsot az Összes parancs kategóriához.

Ez a metódus törli a megadott CListBox objektum tartalmát, mielőtt a Minden parancs kategóriában lévő parancsokkal feltöltené.

Az CMFCMousePropertyPage osztály ezzel a módszerrel tölti ki a dupla kattintással megjelenő eseménylistamezőt.

CMFCToolBarsCustomizeDialog::FillCategoriesComboBox

Kitölti a megadott CComboBox objektumot az egyes parancskategóriák nevével a Testreszabás párbeszédpanelen.

void FillCategoriesComboBox(
    CComboBox& wndCategory,
    BOOL bAddEmpty = TRUE) const;

Paraméterek

wndCategory
[kifelé] Hivatkozás a CComboBox feltöltendő objektumra.

bAddEmpty
[in] Logikai érték, amely meghatározza, hogy a parancsokkal nem rendelkező kombinált listához adjon-e kategóriákat. Ha ez a paraméter IGAZ, a rendszer üres kategóriákat ad hozzá a kombinált listához. Ellenkező esetben a rendszer nem ad hozzá üres kategóriákat.

Megjegyzések

Ez a metódus a CMFCToolBarsCustomizeDialog::FillCategoriesListBox metódushoz hasonló, azzal a kivétellel, hogy ez a metódus egy CComboBox objektummal működik.

Ez a metódus nem törli az objektum tartalmát a CComboBox feltöltés előtt. Garantálja, hogy az Összes parancs kategória a kombinált lista utolsó eleme.

Új parancskategóriákat a CMFCToolBarsCustomizeDialog::AddButton metódussal vehet fel. Egy meglévő kategória nevét a CMFCToolBarsCustomizeDialog::RenameCategory metódussal módosíthatja .

Az CMFCToolBarsKeyboardPropertyPage osztályok ezzel CMFCKeyMapDialog a módszerrel kategorizálják a billentyűzetleképezéseket.

CMFCToolBarsCustomizeDialog::FillCategoriesListBox

Kitölti a megadott CListBox objektumot az egyes parancskategóriák nevével a Testreszabás párbeszédpanelen.

void FillCategoriesListBox(
    CListBox& wndCategory,
    BOOL bAddEmpty = TRUE) const;

Paraméterek

wndCategory
[kifelé] Hivatkozás a CListBox feltöltendő objektumra.

bAddEmpty
[in] Logikai érték, amely meghatározza, hogy a parancsokkal nem rendelkező kategóriákat adja-e hozzá a listamezőhöz. Ha ez a paraméter IGAZ, a rendszer üres kategóriákat ad hozzá a listamezőhöz. Ellenkező esetben a rendszer nem ad hozzá üres kategóriákat.

Megjegyzések

Ez a metódus a CMFCToolBarsCustomizeDialog::FillCategoriesComboBox metódushoz hasonló, azzal a kivétellel, hogy ez a metódus egy CListBox objektummal működik.

Ez a metódus nem törli az objektum tartalmát a CListBox feltöltés előtt. Garantálja, hogy a Minden parancs kategória a listamező utolsó eleme.

Új parancskategóriákat a CMFCToolBarsCustomizeDialog::AddButton metódussal vehet fel. Egy meglévő kategória nevét a CMFCToolBarsCustomizeDialog::RenameCategory metódussal módosíthatja .

Az CMFCToolBarsCommandsPropertyPage osztály ezzel a módszerrel jeleníti meg az egyes parancskategóriákhoz társított parancsok listáját.

CMFCToolBarsCustomizeDialog::GetCommandName

Lekéri a megadott parancsazonosítóhoz társított nevet.

LPCTSTR GetCommandName(UINT uiCmd) const;

Paraméterek

uiCmd
[in] A lekérni kívánt parancs azonosítója.

Visszaadott érték

A megadott parancsazonosítóhoz társított név, vagy NULL, ha a parancs nem létezik.

CMFCToolBarsCustomizeDialog::GetCountInCategory

Lekéri a megadott lista azon elemeinek számát, amelyek adott szövegfeliratot kaptak.

int GetCountInCategory(
    LPCTSTR lpszItemName,
    const CObList& lstCommands) const;

Paraméterek

lpszItemName
[in] Az egyező szövegfelirat.

lstCommands
[in] Objektumokat tartalmazó CMFCToolBarButton listára mutató hivatkozás.

Visszaadott érték

Azon elemek száma a megadott listában, amelyek szövegfelirata lpszItemName.

Megjegyzések

A megadott objektumlista minden elemének típusnak CMFCToolBarButtonkell lennie. Ez a metódus az lpszItemName és a CMFCToolBarButton::m_strText adattagot hasonlítja össze.

CMFCToolBarsCustomizeDialog::GetFlags

Lekéri a párbeszédpanel viselkedését befolyásoló jelzőket.

UINT GetFlags() const;

Visszaadott érték

A párbeszédpanel viselkedését befolyásoló jelzők.

Megjegyzések

Ez a metódus lekéri a konstruktornak átadott uiFlags paraméter értékét. A visszatérési érték az alábbi értékek közül egy vagy több lehet:

Név Description
AFX_CUSTOMIZE_MENU_SHADOWS Lehetővé teszi a felhasználó számára a menü árnyékos megjelenését.
AFX_CUSTOMIZE_TEXT_LABELS Lehetővé teszi a felhasználó számára, hogy megadja, hogy megjelenjenek-e szövegfeliratok az eszköztár gombképei alatt.
AFX_CUSTOMIZE_MENU_ANIMATIONS Lehetővé teszi a felhasználó számára a menü animációs stílusának megadását.
AFX_CUSTOMIZE_NOHELP Eltávolítja a súgó gombot a testreszabási párbeszédpanelről.
AFX_CUSTOMIZE_CONTEXT_HELP Engedélyezi a WS_EX_CONTEXTHELP vizuális stílust.
AFX_CUSTOMIZE_NOTOOLS Eltávolítja az Eszközök lapot a testreszabási párbeszédpanelről. Ez a jelző akkor érvényes, ha az alkalmazás az osztályt CUserToolsManager használja.
AFX_CUSTOMIZE_MENUAMPERS Lehetővé teszi, hogy a gombfeliratok tartalmazzák az ampersand ( >) karaktert.
AFX_CUSTOMIZE_NO_LARGE_ICONS Eltávolítja a Nagy ikonok lehetőséget a testreszabási párbeszédpanelről.

A WS_EX_CONTEXTHELP vizualizációstílusról további információt a Bővített ablakstílusok című témakörben talál.

CMFCToolBarsCustomizeDialog::OnAfterChangeTool

Közvetlenül a bekövetkezése után válaszol a felhasználói eszköz változásaira.

virtual void OnAfterChangeTool(CUserTool* pSelTool);

Paraméterek

pSelTool
[be, ki] A módosított felhasználóieszköz-objektumra mutató mutató.

Megjegyzések

Ezt a metódust a keretrendszer hívja meg, amikor egy felhasználó módosítja egy felhasználó által definiált eszköz tulajdonságait. Az alapértelmezett implementáció nem végez semmit. Felülbírálja ezt a metódust egy olyan osztályban, amelyből CMFCToolBarsCustomizeDialog a felhasználói eszköz módosítása után végez feldolgozást.

CMFCToolBarsCustomizeDialog::OnAssignKey

Érvényesíti a billentyűparancsokat, ahogy a felhasználó definiálja őket.

virtual BOOL OnAssignKey(ACCEL* pAccel);

Paraméterek

pAccel
[be, ki] Mutasson a javasolt billentyűzet-hozzárendelésre, amely ACCEL-szerkezetként van kifejezve.

Visszaadott érték

IGAZ, ha a kulcs hozzárendelhető, vagy HAMIS, ha a kulcs nem rendelhető hozzá. Az alapértelmezett implementáció mindig IGAZ értéket ad vissza.

Megjegyzések

Felülbírálja ezt a metódust egy származtatott osztályban, hogy további feldolgozást végezzen, amikor egy felhasználó új billentyűparancsot rendel hozzá, vagy a felhasználó által definiált billentyűparancsokat érvényesíti. Ha meg szeretné akadályozni egy parancsikon hozzárendelését, a HAMIS értéket adja vissza. Egy üzenetmezőt is meg kell jelenítenie, vagy más módon tájékoztatnia kell a felhasználót a billentyűparancs elutasításának okáról.

CMFCToolBarsCustomizeDialog::OnBeforeChangeTool

Egyéni feldolgozást végez egy felhasználói eszköz módosításakor, amikor a felhasználó módosítást készül alkalmazni.

virtual void OnBeforeChangeTool(CUserTool* pSelTool);

Paraméterek

pSelTool
[be, ki] A lecserélni kívánt felhasználóieszköz-objektumra mutató mutató.

Megjegyzések

Ezt a metódust a keretrendszer hívja meg, amikor egy felhasználó által definiált eszköz tulajdonságai módosulnak. Az alapértelmezett implementáció nem végez semmit. Felülbírálja a OnBeforeChangeTool metódust egy olyan osztályban, amelyből CMFCToolBarsCustomizeDialog származik, ha a felhasználói eszköz módosítása előtt szeretné elvégezni a feldolgozást, például a pSelTool által használt erőforrások felszabadítását.

CMFCToolBarsCustomizeDialog::OnEditToolbarMenuImage

Elindít egy képszerkesztőt, hogy a felhasználó testre szabhassa az eszköztárgombot vagy a menüelem ikont.

virtual BOOL OnEditToolbarMenuImage(
    CWnd* pWndParent,
    CBitmap& bitmap,
    int nBitsPerPixel);

Paraméterek

pWndParent
[in] Mutató a szülőablakra.

Bitkép
[in] A szerkeszteni kívánt bitképobjektumra mutató hivatkozás.

nBitsPerPixel
[in] Bitkép színfelbontása képpontonkénti bitekben.

Visszaadott érték

IGAZ, ha a módosítás véglegesítése folyamatban van; egyéb esetben HAMIS. Az alapértelmezett implementáció egy párbeszédpanelt jelenít meg, és IGAZ értéket ad vissza, ha a felhasználó az OK gombra kattint, vagy HAMIS értéket, ha a felhasználó a Mégse vagy a Bezárás gombra kattint.

Megjegyzések

Ezt a metódust a keretrendszer hívja meg, amikor a felhasználó futtatja a képszerkesztőt. Az alapértelmezett implementáció megjeleníti a CMFCImageEditorDialog Osztály párbeszédpanelt. Felülbírálás OnEditToolbarMenuImage származtatott osztályban egyéni képszerkesztő használatához.

CMFCToolBarsCustomizeDialog::OnInitDialog

Felülbírálások a tulajdonságlap inicializálásának kiegészítéséhez.

virtual BOOL OnInitDialog();

Visszaadott érték

A CPropertySheet::OnInitDialog metódus meghívásának eredménye.

Megjegyzések

Ez a módszer kibővíti a CPropertySheet::OnInitDialog alaposztály-implementációt a Bezárás gomb megjelenítésével, a párbeszédpanel aktuális képernyőméretének megfelelő beállításával, valamint a Súgó gomb bal alsó sarkába való áthelyezésével.

CMFCToolBarsCustomizeDialog::OnInitToolsPage

Kezeli a keretrendszer azon értesítését, amely szerint az Eszközök lap inicializálásra készül.

virtual void OnInitToolsPage();

Megjegyzések

Az alapértelmezett implementáció nem végez semmit. Az értesítés feldolgozásához felülbírálja ezt a metódust egy származtatott osztályban.

CMFCToolBarsCustomizeDialog::P ostNcDestroy

A keretrendszer hívta, miután az ablak elpusztult.

virtual void PostNcDestroy();

Megjegyzések

Ez a módszer kibővíti az alaposztály implementálását az CPropertySheet::PostNcDestroyalkalmazás előző módba való visszaállításával.

A CMFCToolBarsCustomizeDialog::Create metódus egy speciális módban helyezi el az alkalmazást, amely a felhasználót a testreszabási feladatokra korlátozza.

CMFCToolBarsCustomizeDialog::RemoveButton

Eltávolítja a megadott parancsazonosítóval rendelkező gombot a megadott kategóriából vagy az összes kategóriából.

int RemoveButton(
    UINT uiCategoryId,
    UINT uiCmdId);

int RemoveButton(
    LPCTSTR lpszCategory,
    UINT uiCmdId);

Paraméterek

uiCategoryId
[in] Megadja azt a kategóriaazonosítót, amelyből el szeretné távolítani a gombot.

uiCmdId
[in] Megadja a gomb parancsazonosítóját.

lpszCategory
[in] Megadja annak a kategóriának a nevét, amelyből el szeretné távolítani a gombot.

Visszaadott érték

Az eltávolított gomb nullaalapú indexe, vagy -1, ha a megadott parancsazonosító nem található a megadott kategóriában. Ha az uiCategoryId értéke -1, a visszatérési érték 0.

Megjegyzések

Ha el szeretne távolítani egy gombot az összes kategóriából, hívja meg a metódus első túlterhelését, és állítsa az uiCategoryId értéket -1 értékre.

CMFCToolBarsCustomizeDialog::RenameCategory

Átnevez egy kategóriát a Parancsok lapon található kategóriák listájában.

BOOL RenameCategory(
    LPCTSTR lpszCategoryOld,
    LPCTSTR lpszCategoryNew);

Paraméterek

lpszCategoryOld
[in] A módosítani kívánt kategórianév.

lpszCategoryNew
[in] Az új kategória neve.

Visszaadott érték

IGAZ, ha a módszer sikeres volt; egyéb esetben HAMIS.

Megjegyzések

A kategória nevének egyedinek kell lennie.

CMFCToolBarsCustomizeDialog::ReplaceButton

A Parancsok lap parancslistájának eszköztárgombját cseréli le.

void ReplaceButton(
    UINT uiCmd,
    const CMFCToolBarButton& button);

Paraméterek

uiCmd
[in] Megadja a lecserélendő gomb parancsát.

Gomb
[in] Hivatkozás const a régi gombot lecserélő eszköztárgomb-objektumra.

Megjegyzések

Amikor CMFCToolBarsCustomizeDialog::AddMenu, CMFCToolBarsCustomizeDialog::AddMenuCommands vagy CMFCToolBarsCustomizeDialog::AddToolBar hozzáad egy parancsot a Parancsok laphoz, ez a parancs CMFCToolBarButton osztályobjektum (vagy CMFCToolBarMenuButton osztályobjektum egy olyan menüelemhez, amely egy almenü által AddMenuCommandshozzáadott almenüt tartalmaz). A keretrendszer ezt a három metódust is meghívja, hogy automatikusan adjon hozzá parancsokat. Ha azt szeretné, hogy egy parancsot származtatott típus jelöljön, hívja meg ReplaceButton és adja át a származtatott típus egyik gombját.

Example

Az alábbi példa bemutatja, hogyan használható a ReplaceButton metódus az CMFCToolBarsCustomizeDialog osztályban. Ez a kódrészlet a Visual Studio Demo-minta része.

// CMFCToolBarsCustomizeDialog* pDlgCust
     // CMFCToolBarComboBoxButton comboButtonConfig
     pDlgCust->ReplaceButton(ID_DUMMY_SELECT_ACTIVE_CONFIGURATION, comboButtonConfig);

CMFCToolBarsCustomizeDialog::SetUserCategory

Meghatározza, hogy a Parancsok lapon a kategóriák listájában melyik kategória a felhasználói kategória. A CMFCToolBarsCustomizeDialog::Létrehozás hívása előtt meg kell hívnia ezt a függvényt.

BOOL SetUserCategory(LPCTSTR lpszCategory);

Paraméterek

lpszCategory
[in] A kategória neve.

Visszaadott érték

IGAZ, ha a módszer sikeres; egyéb esetben HAMIS.

Megjegyzések

A keretrendszer jelenleg nem használja a felhasználói kategória beállítását.

Lásd még

hierarchiadiagram
osztályok
CPropertySheet osztály

  • Last updated on