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
| Název | Popis |
|---|---|
| CMFCKeyMapDialog::CMFCKeyMapDialog | CMFCKeyMapDialog Vytvoří objekt. |
Veřejné metody
| Název | Popis |
|---|---|
| CMFCKeyMapDialog::D oModal | Zobrazí dialogové okno mapování klávesnice. |
Chráněné metody
| Název | 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 | Volá se rozhraním pro nastavení titulků 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
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();
Návratová 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íčů.
Návratová 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.
Návratová 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
stejnosměrný proud
[v] Kontext zařízení pro tiskárnu.
nPage
[v] Číslo stránky, které se má vytisknout.
cx
[v] Vodorovný posun záhlaví v pixelech.
Návratová 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
stejnosměrný proud
[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.
Návratová 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
Volá se rozhraním pro nastavení titulků 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á titulky pro sloupce ze tří prostředků. Titulek sloupce příkazu pochází z IDS_AFXBARRES_COMMAND, titulek klíčového sloupce pochází z IDS_AFXBARRES_KEYS a popisek sloupce je 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.