Share via

Klasse CMFCToolBarsCustomizeDialog

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Een modusloze tabdialoogvenster ( CPropertySheet Class) waarmee de gebruiker de werkbalken, menu's, sneltoetsen, door de gebruiker gedefinieerde hulpmiddelen en visuele stijl in een toepassing kan aanpassen. Normaal gesproken opent de gebruiker dit dialoogvenster door Aanpassen te selecteren in het menu Extra .

Het dialoogvenster Aanpassen heeft zes tabbladen: Opdrachten, Werkbalken, Hulpmiddelen, Toetsenbord, Menu en Opties.

Syntaxis

class CMFCToolBarsCustomizeDialog : public CPropertySheet

Leden

Openbare constructors

Naam Description
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog Maakt een CMFCToolBarsCustomizeDialog object.
CMFCToolBarsCustomizeDialog::~CMFCToolBarsCustomizeDialog Destructor.

Openbare methoden

Naam Description
CMFCToolBarsCustomizeDialog::AddButton Een werkbalkknop invoegen in de lijst met opdrachten op de pagina Opdrachten
CMFCToolBarsCustomizeDialog::AddMenu Laadt een menu van de resources en roept CMFCToolBarsCustomizeDialog::AddMenuCommands aan om dat menu toe te voegen aan de lijst met opdrachten op de pagina Opdrachten .
CMFCToolBarsCustomizeDialog::AddMenuCommands Laadt een menu van de resources en roept CMFCToolBarsCustomizeDialog::AddMenuCommands aan om dat menu toe te voegen aan de lijst met opdrachten op de pagina Opdrachten .
CMFCToolBarsCustomizeDialog::AddToolBar Hiermee wordt een werkbalk uit de resources geladen. Voor elke opdracht in het menu wordt vervolgens de methode CMFCToolBarsCustomizeDialog::AddButton aangeroepen om een knop in te voegen in de lijst met opdrachten op de pagina Opdrachten onder de opgegeven categorie.
CMFCToolBarsCustomizeDialog::Create Hiermee wordt het dialoogvenster Aanpassing weergegeven.
CMFCToolBarsCustomizeDialog::EnableTools Gereserveerd voor toekomstig gebruik.
CMFCToolBarsCustomizeDialog::EnableUserDefinedToolbars Hiermee schakelt u het maken van nieuwe werkbalken in of uit met behulp van het dialoogvenster Aanpassen .
CMFCToolBarsCustomizeDialog::FillAllCommandsList Hiermee wordt het opgegeven CListBox object gevuld met de opdrachten in de categorie Alle opdrachten .
CMFCToolBarsCustomizeDialog::FillCategoriesComboBox Hiermee wordt het opgegeven CComboBox object gevuld met de naam van elke opdrachtcategorie in het dialoogvenster Aanpassen .
CMFCToolBarsCustomizeDialog::FillCategoriesListBox Hiermee wordt het opgegeven CListBox object gevuld met de naam van elke opdrachtcategorie in het dialoogvenster Aanpassen .
CMFCToolBarsCustomizeDialog::GetCommandName Haalt de naam op die is gekoppeld aan de opgegeven opdracht-id.
CMFCToolBarsCustomizeDialog::GetCountInCategory Hiermee haalt u het aantal items in de opgegeven lijst op met een bepaald tekstlabel.
CMFCToolBarsCustomizeDialog::GetFlags Hiermee haalt u de set vlaggen op die van invloed zijn op het gedrag van het dialoogvenster.
CMFCToolBarsCustomizeDialog::GetThisClass Wordt door het framework gebruikt om een aanwijzer te verkrijgen naar het CRuntimeClass-object dat is gekoppeld aan dit klassetype.
CMFCToolBarsCustomizeDialog::OnEditToolbarMenuImage Hiermee start u een afbeeldingseditor zodat een gebruiker een werkbalkknop of menu-itempictogram kan aanpassen.
CMFCToolBarsCustomizeDialog::OnInitDialog Onderdrukkingen voor het uitbreiden van initialisatie van eigenschappenvensters. (Overschrijft CPropertySheet::OnInitDialog.)
CMFCToolBarsCustomizeDialog::P ostNcDestroy Aangeroepen door het framework nadat het raam is vernietigd. (Onderdrukkingen CPropertySheet::PostNcDestroy.)
CMFCToolBarsCustomizeDialog::RemoveButton Hiermee verwijdert u de knop met de opgegeven opdracht-id uit de opgegeven categorie of uit alle categorieën.
CMFCToolBarsCustomizeDialog::RenameCategory Hiermee wijzigt u de naam van een categorie in de keuzelijst met categorieën op het tabblad Opdrachten .
CMFCToolBarsCustomizeDialog::ReplaceButton Hiermee vervangt u een knop in de lijst met opdrachten op het tabblad Opdrachten door een nieuw werkbalkknopobject.
CMFCToolBarsCustomizeDialog::SetUserCategory Hiermee voegt u een categorie toe aan de lijst met categorieën die worden weergegeven op het tabblad Opdrachten .

Beveiligde methoden

Naam Description
CMFCToolBarsCustomizeDialog::CheckToolsValidity Wordt aangeroepen door het framework om te bepalen of de lijst met door de gebruiker gedefinieerde hulpprogramma's geldig is.
CMFCToolBarsCustomizeDialog::OnAfterChangeTool Aangeroepen door het framework wanneer de eigenschappen van een door de gebruiker gedefinieerd hulpprogramma worden gewijzigd.
CMFCToolBarsCustomizeDialog::OnAssignKey Bepaalt of een opgegeven sneltoets kan worden toegewezen aan een actie.
CMFCToolBarsCustomizeDialog::OnBeforeChangeTool Bepaalt of een door de gebruiker gedefinieerd hulpprogramma kan worden gewijzigd.
CMFCToolBarsCustomizeDialog::OnInitToolsPage Aangeroepen door het framework wanneer de gebruiker het tabblad Extra kiest, wordt aangevraagd.

Opmerkingen

Als u het dialoogvenster Aanpassen wilt weergeven, maakt u een CMFCToolBarsCustomizeDialog object en roept u de methode CMFCToolBarsCustomizeDialog::Create aan.

Terwijl het dialoogvenster Aanpassen actief is, werkt de toepassing in een speciale modus die de gebruiker beperkt tot aanpassingstaken.

Example

In het volgende voorbeeld ziet u hoe u verschillende methoden in de CMFCToolBarsCustomizeDialog klasse gebruikt. In het voorbeeld ziet u hoe u een werkbalkknop in de keuzelijst met opdrachten op de pagina Opdrachten kunt vervangen, nieuwe werkbalken kunt maken met behulp van het dialoogvenster Aanpassen en het dialoogvenster Aanpassen kunt weergeven. Dit codefragment maakt deel uit van het IE Demo-voorbeeld.

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

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CPropertySheet

CMFCToolBarsCustomizeDialog

Requirements

Koptekst: afxToolBarsCustomizeDialog.h

CMFCToolBarsCustomizeDialog::AddButton

Hiermee voegt u een werkbalkknop in de lijst met opdrachten op de pagina Opdrachten in.

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

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

Parameterwaarden

uiCategoryId
[in] Hiermee geeft u de categorie-id op waarin de knop moet worden ingevoegd.

Knop
[in] Hiermee geeft u de knop die moet worden ingevoegd.

iInsertBefore
[in] Hiermee geeft u de op nul gebaseerde index van een werkbalkknop voordat de knop wordt ingevoegd.

lpszCategory
[in] Hiermee geeft u de categorietekenreeks op om de knop in te voegen.

Opmerkingen

De AddButton methode negeert knoppen met de standaardopdracht-id's (zoals ID_FILE_MRU_FILE1), opdrachten die niet zijn toegestaan (zie CMFCToolBar::IsCommandPermitted) en dummyknoppen.

Met deze methode maakt u een nieuw object van hetzelfde type als button (meestal een CMFCToolBarButton-klasse) met behulp van de runtimeklasse van de knop. Vervolgens wordt CMFCToolBarButton::CopyFrom aanroepen om de gegevensleden van de knop te kopiëren en wordt de kopie ingevoegd in de opgegeven categorie.

Wanneer de nieuwe knop wordt ingevoegd, ontvangt deze de OnAddToCustomizePage melding.

Als iInsertBefore dit -1 is, wordt de knop toegevoegd aan de lijst met categorieën; anders wordt deze ingevoegd vóór het item met de opgegeven index.

Example

In het volgende voorbeeld ziet u hoe u de AddButton methode van de CMFCToolBarsCustomizeDialog klasse gebruikt. Dit codefragment maakt deel uit van het slider-voorbeeld.

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

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

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

CMFCToolBarsCustomizeDialog::AddMenu

Laadt een menu van de resources en roept CMFCToolBarsCustomizeDialog::AddMenuCommands aan om dat menu toe te voegen aan de lijst met opdrachten op de pagina Opdrachten .

BOOL AddMenu(UINT uiMenuResId);

Parameterwaarden

uiMenuResId
[in] Hiermee geeft u de resource-id van een menu dat moet worden geladen.

Retourwaarde

WAAR als een menu is toegevoegd; anders ONWAAR.

Opmerkingen

In de aanroep naar AddMenuCommandsis bPopup ONWAAR. Als gevolg hiervan voegt die methode geen menu-items toe die submenu's bevatten aan de lijst met opdrachten. Met deze methode worden de menu-items in de submenu's toegevoegd aan de lijst met opdrachten.

CMFCToolBarsCustomizeDialog::AddMenuCommands

Hiermee voegt u items toe aan de lijst met opdrachten op de pagina Opdrachten om alle items in het opgegeven menu weer te geven.

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

Parameterwaarden

pMenu
[in] Een aanwijzer naar het CMenu-object dat u wilt toevoegen.

bPopup
[in] Hiermee geeft u op of de pop-upmenu-items moeten worden ingevoegd in de lijst met opdrachten.

lpszCategory
[in] De naam van de categorie om het menu in te voegen.

lpszMenuPath
[in] Een voorvoegsel dat wordt toegevoegd aan de naam wanneer de opdracht wordt weergegeven in de lijst Alle categorieën .

Opmerkingen

Met de AddMenuCommands methode worden alle menu-items van pMenu doorlopen. Voor elk menu-item dat geen submenu bevat, maakt deze methode een CMFCToolBarButton Class-object en roept u de methode CMFCToolBarsCustomizeDialog::AddButton toe om het menu-item als werkbalkknop toe te voegen aan de lijst met opdrachten op de pagina Opdrachten . Scheidingstekens worden in dit proces genegeerd.

Als bPopup TRUE is, maakt deze methode voor elk menu-item met een submenu een CMFCToolBarMenuButton Class-object en voegt het in de lijst met opdrachten in door aan te roepen AddButton. Anders worden menu-items met submenu's niet weergegeven in de lijst met opdrachten. In beide gevallen AddMenuCommands wordt een menu-item met een submenu recursief aanroepend door een aanwijzer door te geven aan het submenu als de parameter pMenu en het label van het submenu toe te voegen aan lpszMenuPath.

CMFCToolBarsCustomizeDialog::AddToolBar

Hiermee wordt een werkbalk uit de resources geladen. Voor elke opdracht in het menu wordt vervolgens de methode CMFCToolBarsCustomizeDialog::AddButton aangeroepen om een knop in te voegen in de lijst met opdrachten op de pagina Opdrachten onder de opgegeven categorie.

BOOL AddToolBar(
    UINT uiCategoryId,
    UINT uiToolbarResId);

BOOL AddToolBar(
    LPCTSTR lpszCategory,
    UINT uiToolbarResId);

Parameterwaarden

uiCategoryId
[in] Hiermee geeft u de resource-id van de categorie waaraan u de werkbalk wilt toevoegen.

uiToolbarResId
[in] Hiermee geeft u de resource-id van een werkbalk waarvan de opdrachten worden ingevoegd in de lijst met opdrachten.

lpszCategory
[in] Hiermee geeft u de naam van de categorie waaraan de werkbalk moet worden toegevoegd.

Retourwaarde

WAAR als de methode is geslaagd; anders ONWAAR.

Example

In het volgende voorbeeld ziet u hoe u de AddToolBar methode in de CMFCToolBarsCustomizeDialog klasse gebruikt. Dit codefragment maakt deel uit van het Word Pad-voorbeeld.

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);

Opmerkingen

Het besturingselement dat wordt gebruikt om elke opdracht weer te geven, is een CMFCToolBarButton Class-object . Nadat u de werkbalk hebt toegevoegd, kunt u de knop vervangen door een besturingselement van een afgeleid type door CMFCToolBarsCustomizeDialog::ReplaceButton aan te roepen.

CMFCToolBarsCustomizeDialog::CheckToolsValidity

Controleert de geldigheid van de lijst met gebruikershulpprogramma's.

virtual BOOL CheckToolsValidity(const CObList& lstTools);

Parameterwaarden

lstTools
[in] De lijst met door de gebruiker gedefinieerde hulpprogramma's die moeten worden gecontroleerd.

Retourwaarde

Retourneert TRUE als de lijst met door de gebruiker gedefinieerde hulpprogramma's geldig is; anders ONWAAR. De standaard implementatie retourneert altijd TRUE.

Opmerkingen

Dit framework roept deze methode aan om de geldigheid te controleren van objecten die door de gebruiker gedefinieerde hulpprogramma's vertegenwoordigen die worden geretourneerd door CMFCToolBarsCustomizeDialog::CheckToolsValidity.

Overschrijf de CheckToolsValidity methode in een klasse die is afgeleid van CMFCToolBarsCustomizeDialog als u de gebruikershulpprogramma's wilt valideren voordat de gebruiker het dialoogvenster sluit. Als deze methode ONWAAR retourneert wanneer de gebruiker op de knop Sluiten klikt in de rechterbovenhoek van het dialoogvenster of op de knop Sluiten in de rechterbenedenhoek van het dialoogvenster, wordt het tabblad Extra weergegeven in plaats van te sluiten. Als deze methode ONWAAR retourneert wanneer de gebruiker op een tabblad klikt om weg te navigeren van het tabblad Extra , vindt de navigatie niet plaats. U moet een geschikt berichtvak weergeven om de gebruiker te informeren over het probleem waardoor de validatie is mislukt.

CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog

Maakt een CMFCToolBarsCustomizeDialog object.

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);

Parameterwaarden

pWndParentFrame
[in] Een aanwijzer naar het bovenliggende frame. Deze parameter mag niet NULL zijn.

bAutoSetFromMenus
[in] Een Booleaanse waarde die aangeeft of de menuopdrachten uit alle menu's moeten worden toegevoegd aan de lijst met opdrachten op de pagina Opdrachten . Als deze parameter TRUE is, worden de menuopdrachten toegevoegd. Anders worden de menuopdrachten niet toegevoegd.

uiFlags
[in] Een combinatie van vlaggen die van invloed zijn op het gedrag van het dialoogvenster. Deze parameter kan een of meer van de volgende waarden zijn:

  • 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] Een aanwijzer naar een lijst CRuntimeClass met objecten die extra aangepaste pagina's opgeven.

Opmerkingen

De parameter plistCustomPages verwijst naar de lijst CRuntimeClass met objecten die extra aangepaste pagina's opgeven. De constructor voegt meer pagina's toe aan het dialoogvenster met behulp van de methode CRuntimeClass::CreateObject . Zie het voorbeeld CustomPages voor een voorbeeld dat meer pagina's toevoegt aan het dialoogvenster Aanpassen .

Zie CMFCToolBarsCustomizeDialog::GetFlags voor meer informatie over de waarden die u kunt doorgeven in de parameter uiFlags.

Example

In het volgende voorbeeld ziet u hoe u een object van de CMFCToolBarsCustomizeDialog klasse maakt. Dit codefragment maakt deel uit van het voorbeeld aangepaste pagina's.

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::Create

Hiermee wordt het dialoogvenster Aanpassing weergegeven.

virtual BOOL Create();

Retourwaarde

WAAR als het eigenschappenvenster voor aanpassing is gemaakt; anders ONWAAR.

Opmerkingen

Roep de Create methode pas aan nadat u de klasse volledig hebt geïnitialiseerd.

CMFCToolBarsCustomizeDialog::EnableUserDefinedToolbars

Hiermee schakelt u het maken van nieuwe werkbalken in of uit met behulp van het dialoogvenster Aanpassen .

void EnableUserDefinedToolbars(BOOL bEnable=TRUE);

Parameterwaarden

bEnable
[in] TRUE om de door de gebruiker gedefinieerde werkbalken in te schakelen; FALSE om de werkbalken uit te schakelen.

Opmerkingen

Als bEnable TRUE is, worden de knoppen Nieuw, Naam wijzigen en Verwijderen weergegeven op de pagina Werkbalken .

Standaard of als bEnable ONWAAR is, worden deze knoppen niet weergegeven en kan de gebruiker geen nieuwe werkbalken definiëren.

CMFCToolBarsCustomizeDialog::FillAllCommandsList

Hiermee wordt het opgegeven CListBox object gevuld met de opdrachten in de categorie Alle opdrachten .

virtual void FillAllCommandsList(CListBox& wndListOfCommands) const;

Parameterwaarden

wndListOfCommands
[uit] Een verwijzing naar het CListBox object dat moet worden ingevuld.

Opmerkingen

De categorie Alle opdrachten bevat de opdrachten van alle categorieën. De methode CMFCToolBarsCustomizeDialog::AddButton voegt de opdracht die is gekoppeld aan de opgegeven knop toe aan de categorie Alle opdrachten voor u.

Met deze methode wordt de inhoud van het opgegeven CListBox object gewist voordat het wordt gevuld met de opdrachten in de categorie Alle opdrachten .

De CMFCMousePropertyPage klasse gebruikt deze methode om de keuzelijst met dubbelklikken in te vullen.

CMFCToolBarsCustomizeDialog::FillCategoriesComboBox

Hiermee wordt het opgegeven CComboBox object gevuld met de naam van elke opdrachtcategorie in het dialoogvenster Aanpassen .

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

Parameterwaarden

wndCategory
[uit] Een verwijzing naar het CComboBox object dat moet worden ingevuld.

bAddEmpty
[in] Een Booleaanse waarde die aangeeft of categorieën moeten worden toegevoegd aan de keuzelijst met invoervak die geen opdrachten hebben. Als deze parameter TRUE is, worden lege categorieën toegevoegd aan de keuzelijst met invoervak. Anders worden lege categorieën niet toegevoegd.

Opmerkingen

Deze methode is net als de methode CMFCToolBarsCustomizeDialog::FillCategoriesListBox , behalve dat deze methode met een CComboBox object werkt.

Met deze methode wordt de inhoud van het CComboBox object niet gewist voordat het wordt ingevuld. Het garandeert dat de categorie Alle opdrachten het laatste item in de keuzelijst met invoervak is.

U kunt nieuwe opdrachtcategorieën toevoegen met behulp van de methode CMFCToolBarsCustomizeDialog::AddButton . U kunt de naam van een bestaande categorie wijzigen met behulp van de methode CMFCToolBarsCustomizeDialog::RenameCategory .

De CMFCToolBarsKeyboardPropertyPage en CMFCKeyMapDialog klassen gebruiken deze methode om toetsenbordtoewijzingen te categoriseren.

CMFCToolBarsCustomizeDialog::FillCategoriesListBox

Hiermee wordt het opgegeven CListBox object gevuld met de naam van elke opdrachtcategorie in het dialoogvenster Aanpassen .

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

Parameterwaarden

wndCategory
[uit] Een verwijzing naar het CListBox object dat moet worden ingevuld.

bAddEmpty
[in] Een Booleaanse waarde die aangeeft of categorieën moeten worden toegevoegd aan de keuzelijst die geen opdrachten heeft. Als deze parameter TRUE is, worden lege categorieën toegevoegd aan de keuzelijst. Anders worden lege categorieën niet toegevoegd.

Opmerkingen

Deze methode is net als de methode CMFCToolBarsCustomizeDialog::FillCategoriesComboBox , behalve dat deze methode met een CListBox object werkt.

Met deze methode wordt de inhoud van het CListBox object niet gewist voordat het wordt ingevuld. Het garandeert dat de categorie Alle opdrachten het laatste item in de keuzelijst is.

U kunt nieuwe opdrachtcategorieën toevoegen met behulp van de methode CMFCToolBarsCustomizeDialog::AddButton . U kunt de naam van een bestaande categorie wijzigen met behulp van de methode CMFCToolBarsCustomizeDialog::RenameCategory .

De CMFCToolBarsCommandsPropertyPage klasse gebruikt deze methode om de lijst met opdrachten weer te geven die aan elke opdrachtcategorie zijn gekoppeld.

CMFCToolBarsCustomizeDialog::GetCommandName

Haalt de naam op die is gekoppeld aan de opgegeven opdracht-id.

LPCTSTR GetCommandName(UINT uiCmd) const;

Parameterwaarden

uiCmd
[in] De id van de opdracht die moet worden opgehaald.

Retourwaarde

De naam die is gekoppeld aan de opgegeven opdracht-id of NULL als de opdracht niet bestaat.

CMFCToolBarsCustomizeDialog::GetCountInCategory

Hiermee haalt u het aantal items in de opgegeven lijst op met een bepaald tekstlabel.

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

Parameterwaarden

lpszItemName
[in] Het tekstlabel dat moet overeenkomen.

lstCommands
[in] Een verwijzing naar een lijst met CMFCToolBarButton objecten.

Retourwaarde

Het aantal items in de opgegeven lijst waarvan het tekstlabel gelijk is aan lpszItemName.

Opmerkingen

Elk element in de opgegeven objectlijst moet van het type CMFCToolBarButtonzijn. Deze methode vergelijkt lpszItemName met het gegevenslid CMFCToolBarButton::m_strText .

CMFCToolBarsCustomizeDialog::GetFlags

Hiermee haalt u de set vlaggen op die van invloed zijn op het gedrag van het dialoogvenster.

UINT GetFlags() const;

Retourwaarde

De set vlaggen die van invloed zijn op het gedrag van het dialoogvenster.

Opmerkingen

Met deze methode wordt de waarde opgehaald van de uiFlags-parameter die wordt doorgegeven aan de constructor. De retourwaarde kan een of meer van de volgende waarden zijn:

Naam Description
AFX_CUSTOMIZE_MENU_SHADOWS Hiermee kan de gebruiker de schaduwweergave van het menu opgeven.
AFX_CUSTOMIZE_TEXT_LABELS Hiermee kan de gebruiker opgeven of tekstlabels worden weergegeven onder de afbeeldingen van de werkbalkknop.
AFX_CUSTOMIZE_MENU_ANIMATIONS Hiermee kan de gebruiker de menuanimatiestijl opgeven.
AFX_CUSTOMIZE_NOHELP Hiermee verwijdert u de Help-knop uit het dialoogvenster Aanpassing.
AFX_CUSTOMIZE_CONTEXT_HELP Hiermee schakelt u de WS_EX_CONTEXTHELP visuele stijl in.
AFX_CUSTOMIZE_NOTOOLS Hiermee verwijdert u de pagina Extra uit het dialoogvenster Aanpassing. Deze vlag is geldig als uw toepassing gebruikmaakt van de CUserToolsManager klasse.
AFX_CUSTOMIZE_MENUAMPERS Hiermee staat u toe dat knopbijschriften het en-teken ( &) bevatten.
AFX_CUSTOMIZE_NO_LARGE_ICONS Hiermee verwijdert u de optie Grote pictogrammen uit het dialoogvenster Aanpassing.

Zie Uitgebreide vensterstijlen voor meer informatie over de WS_EX_CONTEXTHELP visuele stijl.

CMFCToolBarsCustomizeDialog::OnAfterChangeTool

Reageert direct nadat deze is aangebracht op een wijziging in een gebruikershulpprogramma.

virtual void OnAfterChangeTool(CUserTool* pSelTool);

Parameterwaarden

pSelTool
[in, uit] Een aanwijzer naar het gebruikershulpprogrammaobject dat is gewijzigd.

Opmerkingen

Deze methode wordt aangeroepen door het framework wanneer een gebruiker de eigenschappen van een door de gebruiker gedefinieerd hulpprogramma wijzigt. De standaard implementatie doet niets. Overschrijf deze methode in een klasse die is afgeleid van CMFCToolBarsCustomizeDialog het uitvoeren van verwerking na een wijziging in een gebruikershulpprogramma.

CMFCToolBarsCustomizeDialog::OnAssignKey

Hiermee worden sneltoetsen gevalideerd als een gebruiker deze definieert.

virtual BOOL OnAssignKey(ACCEL* pAccel);

Parameterwaarden

pAccel
[in, uit] Wijs de voorgestelde toetsenbordtoewijzing aan die wordt uitgedrukt als een ACCEL-struct .

Retourwaarde

WAAR als de sleutel kan worden toegewezen of ONWAAR als de sleutel niet kan worden toegewezen. De standaard implementatie retourneert altijd TRUE.

Opmerkingen

Overschrijf deze methode in een afgeleide klasse om extra verwerking uit te voeren wanneer een gebruiker een nieuwe sneltoets toewijst of om sneltoetsen te valideren wanneer de gebruiker deze definieert. Als u wilt voorkomen dat een snelkoppeling wordt toegewezen, retourneert u FALSE. U moet ook een berichtvak weergeven of de gebruiker op een andere manier informeren over de reden waarom de sneltoets is geweigerd.

CMFCToolBarsCustomizeDialog::OnBeforeChangeTool

Voert aangepaste verwerking uit wanneer een wijziging in een gebruikershulpprogramma wordt uitgevoerd wanneer de gebruiker op het punt staat een wijziging toe te passen.

virtual void OnBeforeChangeTool(CUserTool* pSelTool);

Parameterwaarden

pSelTool
[in, uit] Een aanwijzer naar het gebruikershulpprogrammaobject dat op het punt staat te worden vervangen.

Opmerkingen

Deze methode wordt aangeroepen door het framework wanneer de eigenschappen van een door de gebruiker gedefinieerd hulpprogramma op het punt staat te veranderen. De standaard implementatie doet niets. Overschrijf de OnBeforeChangeTool methode in een klasse die is afgeleid van CMFCToolBarsCustomizeDialog als u verwerking wilt uitvoeren voordat een wijziging in een gebruikershulpprogramma plaatsvindt, zoals het vrijgeven van resources die pSelTool gebruikt.

CMFCToolBarsCustomizeDialog::OnEditToolbarMenuImage

Hiermee start u een afbeeldingseditor zodat een gebruiker een werkbalkknop of menu-itempictogram kan aanpassen.

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

Parameterwaarden

pWndParent
[in] Een aanwijzer naar het bovenliggende venster.

bitmap
[in] Een verwijzing naar een bitmapobject dat moet worden bewerkt.

nBitsPer Pixel
[in] Bitmapkleurresolutie, in bits per pixel.

Retourwaarde

WAAR als een wijziging wordt doorgevoerd; anders ONWAAR. De standaard implementatie geeft een dialoogvenster weer en retourneert TRUE als de gebruiker op OK klikt, of ONWAAR als de gebruiker op Annuleren of de knop Sluiten klikt.

Opmerkingen

Deze methode wordt aangeroepen door het framework wanneer de gebruiker de afbeeldingseditor uitvoert. In de standaard implementatie wordt het dialoogvenster CMFCImageEditorDialog Class weergegeven. Overschrijven OnEditToolbarMenuImage in een afgeleide klasse om een aangepaste afbeeldingseditor te gebruiken.

CMFCToolBarsCustomizeDialog::OnInitDialog

Onderdrukkingen voor het uitbreiden van initialisatie van eigenschappenvensters.

virtual BOOL OnInitDialog();

Retourwaarde

Het resultaat van het aanroepen van de methode CPropertySheet::OnInitDialog .

Opmerkingen

Deze methode breidt de basisklasse-implementatie , CPropertySheet::OnInitDialog, uit door de knop Sluiten weer te geven, door ervoor te zorgen dat het dialoogvenster past bij de huidige schermgrootte en door de Knop Help naar de linkerbenedenhoek van het dialoogvenster te verplaatsen.

CMFCToolBarsCustomizeDialog::OnInitToolsPage

Hiermee wordt de melding van het framework verwerkt dat de pagina Extra binnenkort wordt geïnitialiseerd.

virtual void OnInitToolsPage();

Opmerkingen

De standaard implementatie doet niets. Overschrijf deze methode in een afgeleide klasse om deze melding te verwerken.

CMFCToolBarsCustomizeDialog::P ostNcDestroy

Aangeroepen door het framework nadat het raam is vernietigd.

virtual void PostNcDestroy();

Opmerkingen

Deze methode breidt de implementatie CPropertySheet::PostNcDestroyvan de basisklasse uit door de toepassing te herstellen naar de vorige modus.

De methode CMFCToolBarsCustomizeDialog::Create plaatst de toepassing in een speciale modus die de gebruiker beperkt tot aanpassingstaken.

CMFCToolBarsCustomizeDialog::RemoveButton

Hiermee verwijdert u de knop met de opgegeven opdracht-id uit de opgegeven categorie of uit alle categorieën.

int RemoveButton(
    UINT uiCategoryId,
    UINT uiCmdId);

int RemoveButton(
    LPCTSTR lpszCategory,
    UINT uiCmdId);

Parameterwaarden

uiCategoryId
[in] Hiermee geeft u de categorie-id van waaruit u de knop wilt verwijderen.

uiCmdId
[in] Hiermee geeft u de opdracht-id van de knop.

lpszCategory
[in] Hiermee geeft u de naam van de categorie waaruit u de knop wilt verwijderen.

Retourwaarde

De op nul gebaseerde index van de verwijderde knop of -1 als de opgegeven opdracht-id niet is gevonden in de opgegeven categorie. Als uiCategoryId -1 is, is de retourwaarde 0.

Opmerkingen

Als u een knop uit alle categorieën wilt verwijderen, roept u de eerste overbelasting van deze methode aan en stelt u uiCategoryId in op -1.

CMFCToolBarsCustomizeDialog::RenameCategory

Hiermee wijzigt u de naam van een categorie in de keuzelijst met categorieën op de pagina Opdrachten .

BOOL RenameCategory(
    LPCTSTR lpszCategoryOld,
    LPCTSTR lpszCategoryNew);

Parameterwaarden

lpszCategoryOld
[in] De categorienaam die u wilt wijzigen.

lpszCategoryNew
[in] De naam van de nieuwe categorie.

Retourwaarde

WAAR als de methode is geslaagd; anders ONWAAR.

Opmerkingen

De categorienaam moet uniek zijn.

CMFCToolBarsCustomizeDialog::ReplaceButton

Hiermee vervangt u een werkbalkknop in de keuzelijst met opdrachten op de pagina Opdrachten .

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

Parameterwaarden

uiCmd
[in] Hiermee geeft u de opdracht van de knop die moet worden vervangen.

Knop
[in] Een const verwijzing naar het werkbalkknopobject dat de oude knop vervangt.

Opmerkingen

Wanneer CMFCToolBarsCustomizeDialog::AddMenu, CMFCToolBarsCustomizeDialog::AddMenuCommands of CMFCToolBarsCustomizeDialog::AddToolBar voegt een opdracht toe aan de pagina Opdrachten , die opdracht bevindt zich in de vorm van een CMFCToolBarButton Class-object (of een CMFCToolBarMenuButton Class-object voor een menu-item met een submenu toegevoegd door AddMenuCommands). Het framework roept deze drie methoden ook aan om automatisch opdrachten toe te voegen. Als u een opdracht wilt weergeven door een afgeleid type, roept ReplaceButton u een knop van het afgeleide type aan en geeft u deze door.

Example

In het volgende voorbeeld ziet u hoe u de ReplaceButton methode in de CMFCToolBarsCustomizeDialog klasse gebruikt. Dit codefragment maakt deel uit van het Visual Studio Demo-voorbeeld.

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

CMFCToolBarsCustomizeDialog::SetUserCategory

Hiermee geeft u op welke categorie in de lijst met categorieën op de pagina Opdrachten de gebruikerscategorie is. U moet deze functie aanroepen voordat u CMFCToolBarsCustomizeDialog::Create aanroept.

BOOL SetUserCategory(LPCTSTR lpszCategory);

Parameterwaarden

lpszCategory
[in] De naam van de categorie.

Retourwaarde

WAAR als de methode is geslaagd; anders ONWAAR.

Opmerkingen

De gebruikerscategorie-instelling wordt momenteel niet gebruikt door het framework.

Zie ook

Hiërarchiegrafiek
Klassen
CPropertySheet-klasse

  • Last updated on