Sdílet prostřednictvím


CMFCKeyMapDialog – třída

Třída CMFCKeyMapDialog podporuje ovládací prvek, který mapuje příkazy na klávesy na klávesnici.

Syntaxe

class CMFCKeyMapDialog : public CDialogEx

Členové

Veřejné konstruktory

Jméno popis
CMFCKeyMapDialog::CMFCKeyMapDialog CMFCKeyMapDialog Vytvoří objekt.

Veřejné metody

Jméno popis
CMFCKeyMapDialog::D oModal Zobrazí dialogové okno mapování klávesnice.

Chráněné metody

Jméno popis
CMFCKeyMapDialog::FormatItem Volá se rozhraním pro vytvoření řetězce, který popisuje mapování klíčů. Ve výchozím nastavení obsahuje řetězec název příkazu, použité klávesové zkratky a popis klávesové zkratky.
CMFCKeyMapDialog::GetCommandKeys Načte řetězec, který obsahuje seznam klávesových zkratek přidružených k zadanému příkazu.
CMFCKeyMapDialog::OnInsertItem Volá se rozhraním před vložením nové položky do interního ovládacího prvku seznamu, který podporuje ovládací prvek mapování klávesnice.
CMFCKeyMapDialog::OnPrintHeader Volá se rozhraním pro tisk záhlaví mapy klávesnice na nové stránce.
CMFCKeyMapDialog::OnPrintItem Volá se rozhraním pro tisk položky mapování klávesnice.
CMFCKeyMapDialog::OnSetColumns Volal rozhraní pro nastavení popis pro sloupce v interním ovládacím prvku seznamu, který podporuje ovládací prvek mapování klávesnice.
CMFCKeyMapDialog::P rintKeyMap Volá se rozhraním, když uživatel klikne na tlačítko Tisk .
CMFCKeyMapDialog::SetColumnsWidth Volá se rozhraním pro nastavení šířky sloupců v interním ovládacím prvku seznamu, který podporuje ovládací prvek mapování klávesnice.

Poznámky

CMFCKeyMapDialog Pomocí třídy implementujte dialogové okno pro změnu velikosti mapování klávesnice. Dialogové okno používá ovládací prvek zobrazení seznamu k zobrazení klávesových zkratek a jejich přidružených příkazů.

Chcete-li použít CMFCKeyMapDialog třídu v aplikaci, předejte ukazatel na hlavní okno rámce jako parametr konstruktoru CMFCKeyMapDialog . Potom zavolejte metodu DoModal a spusťte modální dialogové okno.

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

Cwnd

Cdialog

CDialogEx

CMFCKeyMapDialog

Požadavky

Hlavička: afxkeymapdialog.h

CMFCKeyMapDialog::CMFCKeyMapDialog

CMFCKeyMapDialog Vytvoří objekt.

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

Parametry

pWndParentFrame
[v] Ukazatel na nadřazené okno objektu CMFCKeyMapDialog .

bEnablePrint
[v] TRUE, pokud lze vytisknout seznam kláves akcelerátoru; jinak NEPRAVDA. Výchozí hodnota je NEPRAVDA.

Poznámky

Příklad

Následující příklad ukazuje, jak vytvořit objekt CMFCKeyMapDialog třídy. Tento příklad je součástí ukázky sady Visual Studio Demo.

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

CMFCKeyMapDialog::D oModal

Zobrazí dialogové okno mapování klávesnice.

virtual INT_PTR DoModal();

Vrácená hodnota

Podepsané celé číslo, například IDOK nebo IDCANCEL, které je předáno CDialog::EndDialog metoda. Metoda zase zavře dialogové okno. Další informace naleznete v tématu CDialog::D oModal.

Poznámky

Dialogové okno mapování klávesnice umožňuje vybrat a přiřadit klávesy akcelerátoru různým kategoriím příkazů. Kromě toho můžete zkopírovat vybrané klávesy akcelerátoru a jejich popis do schránky.

CMFCKeyMapDialog::FormatItem

Volá se rozhraním pro vytvoření řetězce, který popisuje mapování klíčů. Ve výchozím nastavení obsahuje řetězec název příkazu, použité klávesové zkratky a popis klávesové zkratky.

virtual CString FormatItem(int nItem) const;

Parametry

nItem
[v] Index položky založené na nule v interním seznamu mapování klíčů.

Vrácená hodnota

Objekt CString , který obsahuje formátovaný text položky.

Poznámky

CMFCKeyMapDialog::GetCommandKeys

Načte řetězcovou hodnotu. Řetězec obsahuje seznam klávesových zkratek přidružených k zadanému příkazu.

virtual CString GetCommandKeys(UINT uiCmdID) const;

Parametry

uiCmdID
[v] ID příkazu.

Vrácená hodnota

Seznam klávesových zkratek oddělených středníkem (';') přidružených k zadanému příkazu.

Poznámky

CMFCKeyMapDialog::OnInsertItem

Volá se rozhraním před vložením nové položky do interního ovládacího prvku seznamu, který podporuje ovládací prvek mapování klávesnice.

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

Parametry

pButton
[v] Ukazatel na tlačítko panelu nástrojů, které se používá k mapování kombinace kláves klávesnice na název a popis příkazu. Položka mapy klíčů je uložena v interním ovládacím prvku seznamu.

nItem
[v] Index založený na nule, který určuje, kam vložit novou položku mapování klíčů do interního ovládacího prvku seznamu.

Poznámky

CMFCKeyMapDialog::OnPrintHeader

Volá se rozhraním pro tisk záhlaví mapy klávesnice na nové stránce.

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

Parametry

Dc
[v] Kontext zařízení pro tiskárnu.

nPage
[v] Číslo stránky, které se má vytisknout.

Cx
[v] Vodorovný posun záhlaví v pixelech.

Vrácená hodnota

V případě úspěchu výška tištěného textu. Další informace naleznete v části Návratová hodnota CDC::D rawText.

Poznámky

Architektura používá tuto metodu k tisku mapy klávesnice. Ve výchozím nastavení tato metoda vytiskne číslo stránky, název aplikace a název dialogového okna.

CMFCKeyMapDialog::OnPrintItem

Volá se rozhraním pro tisk položky mapování klávesnice.

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

Parametry

Dc
[v] Kontext zařízení tiskárny.

nItem
[v] Index položky, který se má vytisknout, založený na nule.

Y
[v] Svislý posun mezi horní částí stránky a umístěním položky.

Cx
[v] Vodorovný posun mezi levou stranou stránky a umístěním položky

bCalcHeight
[v] PRAVDA pro výpočet nejlepší výšky pro tiskovou položku; FALSE, pokud chcete zkrátit tiskovou položku tak, aby odpovídala výchozímu místu.

Vrácená hodnota

Výška tištěné položky.

Poznámky

Architektura volá tuto metodu k tisku položky mapy klíčů. Ve výchozím nastavení tato metoda vytiskne název příkazu položky, klávesové zkratky a popis příkazu.

CMFCKeyMapDialog::OnSetColumns

Volal rozhraní pro nastavení popis pro sloupce v interním ovládacím prvku seznamu, který podporuje ovládací prvek mapování klávesnice.

virtual void OnSetColumns();

Poznámky

Ve výchozím nastavení tato metoda získá popis sloupců ze tří prostředků. Sloupec příkazů popis pochází z IDS_AFXBARRES_COMMAND, klíčový sloupec popis pochází z IDS_AFXBARRES_KEYS a sloupec popisu popis pochází z IDS_AFXBARRES_DESCRIPTION.

CMFCKeyMapDialog::P rintKeyMap

Volá se rozhraním, když uživatel klikne na tlačítko Tisk .

virtual void PrintKeyMap();

Poznámky

Metoda PrintKeyMap vytiskne mapu klíčů. Spustí novou tiskovou úlohu a pak opakovaně volá CMFCKeyMapDialog::OnPrintHeader a CMFCKeyMapDialog::OnPrintItem metody, dokud se nevytisknou všechna mapování klíčů.

CMFCKeyMapDialog::SetColumnsWidth

Volá se rozhraním pro nastavení šířky sloupců v interním ovládacím prvku seznamu, který podporuje ovládací prvek mapování klávesnice.

virtual void SetColumnsWidth();

Poznámky

Tato metoda nastaví sloupce interního ovládacího prvku seznamu na výchozí šířky. Nejprve se vypočítá šířka sloupce klávesových zkratek. Pak se ke sloupci příkazu přidělí jedna třetina zbývající šířky a zbývající dvě třetiny se přidělí sloupci popisu.

Viz také

Graf hierarchie
Třídy
CKeyboardManager – třída