Klasa CMFCKeyMapDialog
Klasa CMFCKeyMapDialog obsługuje kontrolkę, która mapuje polecenia na na klawiaturze.
Składnia
class CMFCKeyMapDialog : public CDialogEx
Elementy członkowskie
Konstruktory publiczne
| Nazwa/nazwisko | opis |
|---|---|
| CMFCKeyMapDialog::CMFCKeyMapDialog | CMFCKeyMapDialog Tworzy obiekt. |
Metody publiczne
| Nazwa/nazwisko | opis |
|---|---|
| CMFCKeyMapDialog::D oModal | Wyświetla okno dialogowe mapowania klawiatury. |
Metody chronione
| Nazwa/nazwisko | opis |
|---|---|
| CMFCKeyMapDialog::FormatItem | Wywoływana przez platformę w celu utworzenia ciągu opisującego mapowanie klucza. Domyślnie ciąg zawiera nazwę polecenia, używane skrótu i opis skrótu. |
| CMFCKeyMapDialog::GetCommandKeys | Pobiera ciąg zawierający listę skrótów skojarzonych z określonym poleceniem. |
| CMFCKeyMapDialog::OnInsertItem | Wywoływana przez platformę przed wstawieniem nowego elementu do wewnętrznej kontrolki listy obsługującej kontrolkę mapowania klawiatury. |
| CMFCKeyMapDialog::OnPrintHeader | Wywoływana przez platformę w celu wydrukowania nagłówka mapy klawiatury na nowej stronie. |
| CMFCKeyMapDialog::OnPrintItem | Wywoływana przez strukturę do drukowania elementu mapowania klawiatury. |
| CMFCKeyMapDialog::OnSetColumns | Wywoływana przez platformę w celu ustawienia podpisów dla kolumn w wewnętrznej kontrolce listy, która obsługuje kontrolkę mapowania klawiatury. |
| CMFCKeyMapDialog::P rintKeyMap | Wywoływana przez platformę, gdy użytkownik kliknie przycisk Drukuj. |
| CMFCKeyMapDialog::SetColumnsWidth | Wywoływana przez platformę w celu ustawienia szerokości kolumn w wewnętrznej kontrolce listy, która obsługuje kontrolkę mapowania klawiatury. |
Uwagi
CMFCKeyMapDialog Użyj klasy , aby zaimplementować okno dialogowe mapowania klawiatury z możliwością zmiany rozmiaru. Okno dialogowe używa kontrolki widoku listy do wyświetlania skrótów klawiaturowych i skojarzonych z nimi poleceń.
Aby użyć CMFCKeyMapDialog klasy w aplikacji, przekaż wskaźnik do głównego okna ramki jako parametr konstruktora CMFCKeyMapDialog . Następnie wywołaj metodę , DoModal aby uruchomić modalne okno dialogowe.
Hierarchia dziedziczenia
Wymagania
Nagłówek: afxkeymapdialog.h
CMFCKeyMapDialog::CMFCKeyMapDialog
CMFCKeyMapDialog Tworzy obiekt.
CMFCKeyMapDialog(
CFrameWnd* pWndParentFrame,
BOOL bEnablePrint=FALSE);
Parametry
pWndParentFrame
[in] Wskaźnik do okna nadrzędnego CMFCKeyMapDialog obiektu.
bEnablePrint
[in] WARTOŚĆ TRUE, jeśli można wydrukować listę skrótu; w przeciwnym razie, FAŁSZ. Wartość domyślna to FALSE.
Uwagi
Przykład
W poniższym przykładzie pokazano, jak utworzyć obiekt CMFCKeyMapDialog klasy. Ten przykład jest częścią przykładu pokazowego programu Visual Studio.
// this points to a CMainFrame class which extends the
// CMDIFrameWndEx class
CMFCKeyMapDialog dlg(this, TRUE /* Enable Print */);
CMFCKeyMapDialog::D oModal
Wyświetla okno dialogowe mapowania klawiatury.
virtual INT_PTR DoModal();
Wartość zwracana
Podpisana liczba całkowita, taka jak IDOK lub IDCANCEL, przekazywana do metody CDialog::EndDialog . Metoda z kolei zamyka okno dialogowe. Aby uzyskać więcej informacji, zobacz CDialog::D oModal.
Uwagi
Okno dialogowe mapowania klawiatury umożliwia wybieranie i przypisywanie akceleratorów do różnych kategorii poleceń. Ponadto możesz skopiować wybrane klucze akceleratora i ich opis do schowka.
CMFCKeyMapDialog::FormatItem
Wywoływana przez platformę w celu utworzenia ciągu opisującego mapowanie klucza. Domyślnie ciąg zawiera nazwę polecenia, używane skrótu i opis skrótu.
virtual CString FormatItem(int nItem) const;
Parametry
nItem
[in] Indeks oparty na zera elementu na wewnętrznej liście mapowań kluczy.
Wartość zwracana
CString Obiekt zawierający sformatowany tekst elementu.
Uwagi
CMFCKeyMapDialog::GetCommandKeys
Pobiera wartość ciągu. Ciąg zawiera listę skrótów skojarzonych z określonym poleceniem.
virtual CString GetCommandKeys(UINT uiCmdID) const;
Parametry
uiCmdID
[in] Identyfikator polecenia.
Wartość zwracana
Rozdzielana (';') średnikami lista skrótów skojarzonych z określonym poleceniem.
Uwagi
CMFCKeyMapDialog::OnInsertItem
Wywoływana przez platformę przed wstawieniem nowego elementu do wewnętrznej kontrolki listy obsługującej kontrolkę mapowania klawiatury.
virtual void OnInsertItem(
CMFCToolBarButton* pButton,
int nItem);
Parametry
PButton
[in] Wskaźnik do przycisku paska narzędzi, który jest używany do mapowania kombinacji klawiatury na nazwę polecenia i opis. Element mapy klucza jest przechowywany w wewnętrznej kontrolce listy.
nItem
[in] Indeks oparty na zera, który określa, gdzie wstawić nowy element mapy klucza w wewnętrznej kontrolce listy.
Uwagi
CMFCKeyMapDialog::OnPrintHeader
Wywoływana przez platformę w celu wydrukowania nagłówka mapy klawiatury na nowej stronie.
virtual int OnPrintHeader(
CDC& dc,
int nPage,
int cx) const;
Parametry
Dc
[in] Kontekst urządzenia dla drukarki.
nPage
[in] Numer strony do wydrukowania.
cx
[in] Przesunięcie poziome nagłówka w pikselach.
Wartość zwracana
Jeśli to się powiedzie, wysokość drukowanego tekstu. Aby uzyskać więcej informacji, zobacz sekcję Wartość zwracana w pliku CDC::D rawText.
Uwagi
Struktura używa tej metody do drukowania mapy klawiatury. Domyślnie ta metoda drukuje numer strony, nazwę aplikacji i tytuł okna dialogowego.
CMFCKeyMapDialog::OnPrintItem
Wywoływana przez strukturę do drukowania elementu mapowania klawiatury.
virtual int OnPrintItem(
CDC& dc,
int nItem,
int y,
int cx,
BOOL bCalcHeight) const;
Parametry
Dc
[in] Kontekst urządzenia drukarki.
nItem
[in] Indeks zerowy elementu do wydrukowania.
y
[in] Przesunięcie w pionie między górną częścią strony a położeniem elementu.
cx
[in] Przesunięcie poziome między lewej strony a położeniem elementu.
bCalcHeight
[in] WARTOŚĆ TRUE, aby obliczyć najlepszą wysokość elementu wydruku; FAŁSZ, aby obcinać element wydruku, tak aby pasował do domyślnego miejsca.
Wartość zwracana
Wysokość drukowanego elementu.
Uwagi
Struktura wywołuje tę metodę, aby wydrukować element okna dialogowego mapy klucza. Domyślnie ta metoda wyświetla nazwę polecenia elementu, skrótów i opis polecenia.
CMFCKeyMapDialog::OnSetColumns
Wywoływana przez platformę w celu ustawienia podpisów dla kolumn w wewnętrznej kontrolce listy, która obsługuje kontrolkę mapowania klawiatury.
virtual void OnSetColumns();
Uwagi
Domyślnie ta metoda uzyskuje podpisy dla kolumn z trzech zasobów. Podpis kolumny polecenia pochodzi z IDS_AFXBARRES_COMMAND, podpis kolumny klucza pochodzi z IDS_AFXBARRES_KEYS, a podpis kolumny opisu pochodzi z IDS_AFXBARRES_DESCRIPTION.
CMFCKeyMapDialog::P rintKeyMap
Wywoływana przez platformę, gdy użytkownik kliknie przycisk Drukuj.
virtual void PrintKeyMap();
Uwagi
Metoda PrintKeyMap wyświetla mapę kluczy. Inicjuje nowe zadanie drukowania, a następnie wielokrotnie wywołuje metody CMFCKeyMapDialog::OnPrintHeader i CMFCKeyMapDialog::OnPrintItem , dopóki nie zostaną wydrukowane wszystkie mapowania kluczy.
CMFCKeyMapDialog::SetColumnsWidth
Wywoływana przez platformę w celu ustawienia szerokości kolumn w wewnętrznej kontrolce listy, która obsługuje kontrolkę mapowania klawiatury.
virtual void SetColumnsWidth();
Uwagi
Ta metoda ustawia kolumny wewnętrznej kontrolki listy na domyślne szerokości. Najpierw jest obliczana szerokość kolumny skrótów. Następnie jedna trzecia pozostałej szerokości zostanie przydzielona do kolumny poleceń, a pozostałe dwie trzecie zostanie przydzielone do kolumny opisu.