Klasa CMFCKeyMapDialog

Klasa CMFCKeyMapDialog obsługuje kontrolkę, która mapuje polecenia na klawisze na klawiaturze.

Składnia

class CMFCKeyMapDialog : public CDialogEx

Członkowie

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 klawisze skrótu i opis klawisza skrótu.
CMFCKeyMapDialog::GetCommandKeys	Pobiera ciąg zawierający listę klawiszy 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ę, aby ustawić podpis 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

Cobject

Ccmdtarget

Cwnd

Cdialog

Cdialogex

CMFCKeyMapDialog

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ę klawiszy 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 klawiszy 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 klawisze skrótu i opis klawisza 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ę klawiszy skrótów skojarzonych z określonym poleceniem.

virtual CString GetCommandKeys(UINT uiCmdID) const;

Parametry

uiCmdID
[in] Identyfikator polecenia.

Wartość zwracana

Rozdzielana (';') średnikami lista klawiszy 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 klawiszy 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, klawisze skrótów i opis polecenia.

CMFCKeyMapDialog::OnSetColumns

Wywoływana przez platformę, aby ustawić podpis dla kolumn w wewnętrznej kontrolce listy, która obsługuje kontrolkę mapowania klawiatury.

virtual void OnSetColumns();

Uwagi

Domyślnie ta metoda uzyskuje podpis dla kolumn z trzech zasobów. Kolumna poleceń podpis pochodzi z IDS_AFXBARRES_COMMAND, podpis kolumny klucza pochodzi z IDS_AFXBARRES_KEYS, a kolumna opisu podpis 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 klawiszy 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.

Zobacz też

Wykres hierarchii
Klasy
Klasa CKeyboardManager