Share via


Klasse CMFCKeyMapDialog

Opmerking

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

De CMFCKeyMapDialog klasse ondersteunt een besturingselement waarmee opdrachten worden toegewezen aan toetsen op het toetsenbord.

Syntaxis

class CMFCKeyMapDialog : public CDialogEx

Leden

Openbare constructors

Naam Description
CMFCKeyMapDialog::CMFCKeyMapDialog Maakt een CMFCKeyMapDialog object.

Openbare methoden

Naam Description
CMFCKeyMapDialog::D oModal Hiermee wordt een dialoogvenster voor toetsenbordtoewijzing weergegeven.

Beveiligde methoden

Naam Description
CMFCKeyMapDialog::FormatItem Wordt aangeroepen door het framework om een tekenreeks te bouwen die een sleuteltoewijzing beschrijft. De tekenreeks bevat standaard de opdrachtnaam, de gebruikte sneltoetsen en de beschrijving van de sneltoets.
CMFCKeyMapDialog::GetCommandKeys Hiermee haalt u een tekenreeks op die een lijst met sneltoetsen bevat die zijn gekoppeld aan de opgegeven opdracht.
CMFCKeyMapDialog::OnInsertItem Aangeroepen door het framework voordat een nieuw item wordt ingevoegd in het interne lijstbeheer dat ondersteuning biedt voor het toetsenbordtoewijzingsbeheer.
CMFCKeyMapDialog::OnPrintHeader Aangeroepen door het framework om de koptekst voor de toetsenbordtoewijzing op een nieuwe pagina af te drukken.
CMFCKeyMapDialog::OnPrintItem Aangeroepen door het framework om een toetsenbordtoewijzingsitem af te drukken.
CMFCKeyMapDialog::OnSetColumns Aangeroepen door het framework om bijschriften in te stellen voor de kolommen in het interne lijstbeheer dat ondersteuning biedt voor het toetsenbordtoewijzingsbeheer.
CMFCKeyMapDialog::P rintKeyMap Aangeroepen door het framework wanneer een gebruiker op de knop Afdrukken klikt.
CMFCKeyMapDialog::SetColumnsWidth Wordt aangeroepen door het framework om de breedte van de kolommen in het besturingselement voor interne lijsten in te stellen dat ondersteuning biedt voor het toetsenbordtoewijzingsbeheer.

Opmerkingen

Gebruik de CMFCKeyMapDialog klasse om een dialoogvenster voor het aanpassen van het formaat van een toetsenbord te implementeren. In het dialoogvenster wordt een besturingselement voor de lijstweergave gebruikt om sneltoetsen en de bijbehorende opdrachten weer te geven.

Als u de CMFCKeyMapDialog klasse in een toepassing wilt gebruiken, geeft u een aanwijzer door naar het hoofdframevenster als parameter voor de CMFCKeyMapDialog constructor. Roep vervolgens de DoModal methode aan om een modaal dialoogvenster te starten.

Overnamehiërarchie

CObject

CCmdTarget-

CWnd

CDialog

CDialogEx

CMFCKeyMapDialog

Requirements

Header: afxkeymapdialog.h

CMFCKeyMapDialog::CMFCKeyMapDialog

Maakt een CMFCKeyMapDialog object.

CMFCKeyMapDialog(
    CFrameWnd* pWndParentFrame,
    BOOL bEnablePrint=FALSE);

Parameterwaarden

pWndParentFrame
[in] Een aanwijzer naar het bovenliggende venster van het CMFCKeyMapDialog object.

bEnablePrint
[in] WAAR als de lijst met versnellertoetsen kan worden afgedrukt; anders, ONWAAR. De standaard is FOUT.

Opmerkingen

Example

In het volgende voorbeeld ziet u hoe u een object van de CMFCKeyMapDialog klasse maakt. Dit voorbeeld maakt deel uit van het Visual Studio Demo-voorbeeld.

// this points to a CMainFrame class which extends the 
// CMDIFrameWndEx class
CMFCKeyMapDialog dlg(this, TRUE /* Enable Print */);

CMFCKeyMapDialog::D oModal

Hiermee wordt een dialoogvenster voor toetsenbordtoewijzing weergegeven.

virtual INT_PTR DoModal();

Retourwaarde

Een ondertekend geheel getal, zoals IDOK of IDCANCEL, dat wordt doorgegeven aan de methode CDialog::EndDialog . Met de methode wordt het dialoogvenster gesloten. Zie CDialog::D oModal voor meer informatie.

Opmerkingen

Met het dialoogvenster toetsenbordtoewijzing kunt u sneltoetsen selecteren en toewijzen aan verschillende categorieën opdrachten. Daarnaast kunt u de geselecteerde sneltoetsen en hun beschrijving naar het klembord kopiëren.

CMFCKeyMapDialog::FormatItem

Wordt aangeroepen door het framework om een tekenreeks te bouwen die een sleuteltoewijzing beschrijft. De tekenreeks bevat standaard de opdrachtnaam, de gebruikte sneltoetsen en de beschrijving van de sneltoets.

virtual CString FormatItem(int nItem) const;

Parameterwaarden

nItem
[in] De op nul gebaseerde index van een item in de interne lijst met sleuteltoewijzingen.

Retourwaarde

Een CString object dat de opgemaakte itemtekst bevat.

Opmerkingen

CMFCKeyMapDialog::GetCommandKeys

Hiermee haalt u een tekenreekswaarde op. De tekenreeks bevat een lijst met sneltoetsen die zijn gekoppeld aan een opgegeven opdracht.

virtual CString GetCommandKeys(UINT uiCmdID) const;

Parameterwaarden

uiCmdID
[in] Een opdracht-id.

Retourwaarde

Een door puntkomma's gescheiden (';') lijst met sneltoetsen die is gekoppeld aan de opgegeven opdracht.

Opmerkingen

CMFCKeyMapDialog::OnInsertItem

Wordt aangeroepen door het framework voordat een nieuw item wordt ingevoegd in een intern lijstbeheer dat ondersteuning biedt voor het toetsenbordtoewijzingsbeheer.

virtual void OnInsertItem(
    CMFCToolBarButton* pButton,
    int nItem);

Parameterwaarden

pButton
[in] Een aanwijzer naar een werkbalkknop die wordt gebruikt om een toetsenbordtoetscombinatie toe te wijzen aan een opdrachtnaam en beschrijving. Het sleuteltoewijzingsitem wordt opgeslagen in een intern lijstbeheer.

nItem
[in] Een op nul gebaseerde index die aangeeft waar het nieuwe sleuteltoewijzingsitem in het interne lijstbesturingselement moet worden ingevoegd.

Opmerkingen

CMFCKeyMapDialog::OnPrintHeader

Aangeroepen door het framework om de koptekst voor de toetsenbordtoewijzing op een nieuwe pagina af te drukken.

virtual int OnPrintHeader(
    CDC& dc,
    int nPage,
    int cx) const;

Parameterwaarden

Dc
[in] De apparaatcontext voor de printer.

nPagina
[in] Het paginanummer dat moet worden afgedrukt.

Cx
[in] De horizontale verschuiving van de koptekst, in pixels.

Retourwaarde

Als dit lukt, wordt de hoogte van de afgedrukte tekst weergegeven. Zie de sectie Retourwaarde van CDC::D rawText voor meer informatie.

Opmerkingen

Het framework gebruikt deze methode om de toetsenbordkaart af te drukken. Deze methode drukt standaard de titel van het paginanummer, de toepassingsnaam en de titel van het dialoogvenster af.

CMFCKeyMapDialog::OnPrintItem

Aangeroepen door het framework om een toetsenbordtoewijzingsitem af te drukken.

virtual int OnPrintItem(
    CDC& dc,
    int nItem,
    int y,
    int cx,
    BOOL bCalcHeight) const;

Parameterwaarden

Dc
[in] De apparaatcontext van de printer.

nItem
[in] De op nul gebaseerde index van het item dat moet worden afgedrukt.

y
[in] De verticale verschuiving tussen de bovenkant van de pagina en de positie van het item.

Cx
[in] De horizontale verschuiving tussen de linkerkant van de pagina en de positie van het item.

bCalcHeight
[in] WAAR om de beste hoogte voor het afdrukitem te berekenen; ONWAAR om het afdrukitem af te kapen zodat het past bij de standaardruimte.

Retourwaarde

De hoogte van het afgedrukte item.

Opmerkingen

In het framework wordt deze methode aangeroepen om een dialoogvensteritem voor sleuteltoewijzing af te drukken. Met deze methode worden standaard de opdrachtnaam, sneltoetsen en opdrachtbeschrijving van het item afgedrukt.

CMFCKeyMapDialog::OnSetColumns

Aangeroepen door het framework om bijschriften in te stellen voor de kolommen in het interne lijstbeheer dat ondersteuning biedt voor het toetsenbordtoewijzingsbeheer.

virtual void OnSetColumns();

Opmerkingen

Met deze methode worden standaard de bijschriften voor de kolommen opgehaald uit drie resources. Het opdrachtkolombijschrift komt uit IDS_AFXBARRES_COMMAND, het sleutelkolombijschrift is afkomstig uit IDS_AFXBARRES_KEYS en het bijschrift van de beschrijvingskolom komt uit IDS_AFXBARRES_DESCRIPTION.

CMFCKeyMapDialog::P rintKeyMap

Aangeroepen door het framework wanneer een gebruiker op de knop Afdrukken klikt.

virtual void PrintKeyMap();

Opmerkingen

Met PrintKeyMap de methode wordt de sleutelkaart afgedrukt. Er wordt een nieuwe afdruktaak gestart en vervolgens herhaaldelijk de methoden CMFCKeyMapDialog::OnPrintHeader en CMFCKeyMapDialog::OnPrintItem aangeroepen totdat alle sleuteltoewijzingen worden afgedrukt.

CMFCKeyMapDialog::SetColumnsWidth

Wordt aangeroepen door het framework om de breedte van de kolommen in het besturingselement voor interne lijsten in te stellen dat ondersteuning biedt voor het toetsenbordtoewijzingsbeheer.

virtual void SetColumnsWidth();

Opmerkingen

Met deze methode worden de kolommen van het interne lijstbeheer ingesteld op standaardbreedten. Eerst wordt de breedte van de kolom sneltoetsen berekend. Vervolgens wordt een derde van de resterende breedte toegewezen aan de opdrachtkolom en wordt de resterende twee derde toegewezen aan de beschrijvingskolom.

Zie ook

Hiërarchiegrafiek
Klassen
CKeyboardManager-klasse