Classe CMFCKeyMapDialog
La CMFCKeyMapDialog classe supporta un controllo che esegue il mapping dei comandi ai tasti sulla tastiera.
Sintassi
class CMFCKeyMapDialog : public CDialogEx
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| CMFCKeyMapDialog::CMFCKeyMapDialog | Costruisce un oggetto CMFCKeyMapDialog. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CMFCKeyMapDialog::D oModal | Visualizza una finestra di dialogo per il mapping della tastiera. |
Metodi protetti
| Nome | Descrizione |
|---|---|
| CMFCKeyMapDialog::FormatItem | Chiamato dal framework per compilare una stringa che descrive un mapping di chiavi. Per impostazione predefinita, la stringa contiene il nome del comando, i tasti di scelta rapida usati e la descrizione del tasto di scelta rapida. |
| CMFCKeyMapDialog::GetCommandKeys | Recupera una stringa che contiene un elenco di tasti di scelta rapida associati al comando specificato. |
| CMFCKeyMapDialog::OnInsertItem | Chiamato dal framework prima dell'inserimento di un nuovo elemento nel controllo elenco interno che supporta il controllo mapping della tastiera. |
| CMFCKeyMapDialog::OnPrintHeader | Chiamato dal framework per stampare l'intestazione per la mappa della tastiera in una nuova pagina. |
| CMFCKeyMapDialog::OnPrintItem | Chiamato dal framework per stampare un elemento di mapping della tastiera. |
| CMFCKeyMapDialog::OnSetColumns | Chiamato dal framework per impostare le didascalie per le colonne nel controllo elenco interno che supporta il controllo mapping della tastiera. |
| CMFCKeyMapDialog::P rintKeyMap | Chiamato dal framework quando un utente fa clic sul pulsante Stampa . |
| CMFCKeyMapDialog::SetColumnsWidth | Chiamato dal framework per impostare la larghezza delle colonne nel controllo elenco interno che supporta il controllo mapping della tastiera. |
Osservazioni:
Usare la CMFCKeyMapDialog classe per implementare una finestra di dialogo di mapping della tastiera ridimensionabile. La finestra di dialogo usa un controllo visualizzazione elenco per visualizzare i tasti di scelta rapida e i relativi comandi associati.
Per usare la CMFCKeyMapDialog classe in un'applicazione, passare un puntatore alla finestra cornice principale come parametro al CMFCKeyMapDialog costruttore. Chiamare quindi il DoModal metodo per avviare una finestra di dialogo modale.
Gerarchia di ereditarietà
Requisiti
Intestazione: afxkeymapdialog.h
CMFCKeyMapDialog::CMFCKeyMapDialog
Costruisce un oggetto CMFCKeyMapDialog.
CMFCKeyMapDialog(
CFrameWnd* pWndParentFrame,
BOOL bEnablePrint=FALSE);
Parametri
pWndParentFrame
[in] Puntatore alla finestra padre dell'oggetto CMFCKeyMapDialog .
bEnablePrint
[in] TRUE se è possibile stampare l'elenco dei tasti di scelta rapida; in caso contrario, FALSE. Il valore predefinito è FALSE.
Osservazioni:
Esempio
Nell'esempio seguente viene illustrato come costruire un oggetto della CMFCKeyMapDialog classe . Questo esempio fa parte dell'esempio demo di Visual Studio.
// this points to a CMainFrame class which extends the
// CMDIFrameWndEx class
CMFCKeyMapDialog dlg(this, TRUE /* Enable Print */);
CMFCKeyMapDialog::D oModal
Visualizza una finestra di dialogo per il mapping della tastiera.
virtual INT_PTR DoModal();
Valore restituito
Intero con segno, ad esempio IDOK o IDCANCEL, passato al metodo CDialog::EndDialog . Il metodo, a sua volta, chiude la finestra di dialogo. Per altre informazioni, vedere CDialog::D oModal.
Osservazioni:
La finestra di dialogo mapping della tastiera consente di selezionare e assegnare i tasti di scelta rapida a varie categorie di comandi. Inoltre, è possibile copiare i tasti di scelta rapida selezionati e la relativa descrizione negli Appunti.
CMFCKeyMapDialog::FormatItem
Chiamato dal framework per compilare una stringa che descrive un mapping di chiavi. Per impostazione predefinita, la stringa contiene il nome del comando, i tasti di scelta rapida usati e la descrizione del tasto di scelta rapida.
virtual CString FormatItem(int nItem) const;
Parametri
nItem
[in] Indice in base zero di un elemento nell'elenco interno dei mapping delle chiavi.
Valore restituito
Oggetto CString contenente il testo dell'elemento formattato.
Osservazioni:
CMFCKeyMapDialog::GetCommandKeys
Recupera un valore stringa. La stringa contiene un elenco di tasti di scelta rapida associati a un comando specificato.
virtual CString GetCommandKeys(UINT uiCmdID) const;
Parametri
uiCmdID
[in] ID comando.
Valore restituito
Elenco delimitato da (';') punto e virgola dei tasti di scelta rapida associati al comando specificato.
Osservazioni:
CMFCKeyMapDialog::OnInsertItem
Chiamato dal framework prima dell'inserimento di un nuovo elemento in un controllo elenco interno che supporta il controllo di mapping della tastiera.
virtual void OnInsertItem(
CMFCToolBarButton* pButton,
int nItem);
Parametri
pButton
[in] Puntatore a un pulsante della barra degli strumenti utilizzato per eseguire il mapping di una combinazione di tasti di tastiera a un nome e una descrizione del comando. L'elemento della mappa delle chiavi viene archiviato in un controllo elenco interno.
nItem
[in] Indice in base zero che specifica dove inserire il nuovo elemento della mappa delle chiavi nel controllo elenco interno.
Osservazioni:
CMFCKeyMapDialog::OnPrintHeader
Chiamato dal framework per stampare l'intestazione per la mappa della tastiera in una nuova pagina.
virtual int OnPrintHeader(
CDC& dc,
int nPage,
int cx) const;
Parametri
dc
[in] Contesto del dispositivo per la stampante.
nPage
[in] Numero di pagina da stampare.
cx
[in] Offset orizzontale dell'intestazione, in pixel.
Valore restituito
In caso di esito positivo, altezza del testo stampato. Per altre informazioni, vedere la sezione Valore restituito di CDC::D rawText.
Osservazioni:
Il framework usa questo metodo per stampare la mappa della tastiera. Per impostazione predefinita, questo metodo stampa il numero di pagina, il nome dell'applicazione e il titolo della finestra di dialogo.
CMFCKeyMapDialog::OnPrintItem
Chiamato dal framework per stampare un elemento di mapping della tastiera.
virtual int OnPrintItem(
CDC& dc,
int nItem,
int y,
int cx,
BOOL bCalcHeight) const;
Parametri
dc
[in] Contesto del dispositivo della stampante.
nItem
[in] Indice in base zero dell'elemento da stampare.
y
[in] Offset verticale tra la parte superiore della pagina e la posizione dell'elemento.
cx
[in] Offset orizzontale tra la parte sinistra della pagina e la posizione dell'elemento.
bCalcHeight
[in] TRUE per calcolare l'altezza migliore per l'elemento di stampa; FALSE per troncare l'elemento di stampa in modo che si adatti allo spazio predefinito.
Valore restituito
Altezza dell'elemento stampato.
Osservazioni:
Il framework chiama questo metodo per stampare un elemento della finestra di dialogo mappa chiavi. Per impostazione predefinita, questo metodo stampa il nome del comando, i tasti di scelta rapida e la descrizione del comando dell'elemento.
CMFCKeyMapDialog::OnSetColumns
Chiamato dal framework per impostare le didascalie per le colonne nel controllo elenco interno che supporta il controllo mapping della tastiera.
virtual void OnSetColumns();
Osservazioni:
Per impostazione predefinita, questo metodo ottiene le didascalie per le colonne da tre risorse. La didascalia della colonna del comando proviene da IDS_AFXBARRES_COMMAND, la didascalia della colonna chiave proviene da IDS_AFXBARRES_KEYS e la didascalia della colonna della descrizione proviene da IDS_AFXBARRES_DESCRIPTION.
CMFCKeyMapDialog::P rintKeyMap
Chiamato dal framework quando un utente fa clic sul pulsante Stampa .
virtual void PrintKeyMap();
Osservazioni:
Il PrintKeyMap metodo stampa la mappa delle chiavi. Avvia un nuovo processo di stampa e quindi chiama ripetutamente i metodi CMFCKeyMapDialog::OnPrintHeader e CMFCKeyMapDialog::OnPrintItem finché non vengono stampati tutti i mapping delle chiavi.
CMFCKeyMapDialog::SetColumnsWidth
Chiamato dal framework per impostare la larghezza delle colonne nel controllo elenco interno che supporta il controllo mapping della tastiera.
virtual void SetColumnsWidth();
Osservazioni:
Questo metodo imposta le colonne del controllo elenco interno sulle larghezze predefinite. Prima di tutto, viene calcolata la larghezza della colonna dei tasti di scelta rapida. Viene quindi allocato un terzo della larghezza rimanente alla colonna di comando e i due terzi rimanenti vengono allocati alla colonna di descrizione.