Condividi tramite


Nozioni fondamentali sulla barra degli strumenti

In questo articolo viene descritta l'implementazione fondamentale di MFC che consente di aggiungere una barra degli strumenti predefinita all'applicazione selezionando un'opzione nella creazione guidata applicazione. Vengono trattati i seguenti argomenti:

  • L'opzione della barra degli strumenti della creazione guidata applicazione

  • La barra degli strumenti nel codice

  • Modificare la risorsa barra degli strumenti

  • Barre degli strumenti più

L'opzione della barra degli strumenti della creazione guidata applicazione

Per ottenere una singola barra degli strumenti con i pulsanti predefiniti, selezionare l'opzione standard della barra degli strumenti ancorabile nella pagina denominata funzionalità dell'interfaccia utente. In questo modo verrà aggiunto il codice all'applicazione che:

  • Crea l'oggetto della barra degli strumenti.

  • Gestisce la barra degli strumenti, tra cui la possibilità di ancoraggio o mobile.

La barra degli strumenti nel codice

La barra degli strumenti è un oggetto di CToolBar dichiarata come membro dati di una classe di CMainFrame dell'applicazione. Ovvero l'oggetto della barra degli strumenti è incorporato nell'oggetto finestra cornice principale. Ciò significa che MFC crea la barra degli strumenti quando crea la finestra cornice e elimina la barra degli strumenti quando si elimina la finestra cornice. La seguente dichiarazione di classe parziale, per un'applicazione MDI (multiple-document interface (MDI), i membri dati per la barra degli strumenti incorporata e una barra di stato incorporata. Mostra inoltre l'override della funzione membro di OnCreate.

class CMainFrame : public CMDIFrameWnd
{
// Implementation
protected:  // control bar embedded members
   CStatusBar  m_wndStatusBar;
   CToolBar    m_wndToolBar;

// Generated message map functions
protected:
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
   DECLARE_MESSAGE_MAP()

La creazione della barra degli strumenti si verifica in CMainFrame::OnCreate. MFC chiama OnCreate dopo aver creato la finestra per il frame ma prima che diventa visibile. OnCreate predefinito della creazione guidata applicazione genera vengono eseguite le attività seguenti della barra degli strumenti:

  1. Chiama la funzione membro CToolBar dell'oggetto Create per creare l'oggetto sottostante CToolBarCtrl.

  2. Chiama LoadToolBar per caricare le informazioni sulle risorse della barra degli strumenti.

  3. Le chiamate funziona per attivare l'ancoraggio, il mobile e le descrizioni comandi. Per informazioni dettagliate sulle chiamate, vedere l'articolo L'aggancio e barre degli strumenti mobili.

Nota

L'esempio generale DOCKTOOL MFC include le illustrazioni delle barre degli strumenti recenti che nuove MFC.Le barre degli strumenti che utilizzano COldToolbar richiedono le chiamate al passaggio 2 a LoadBitmap (anziché LoadToolBar) e a SetButtons.Le nuove barre degli strumenti richiedono le chiamate a LoadToolBar.

Dock, il mobile e le chiamate delle descrizioni comandi sono facoltativi. È possibile rimuovere le righe da OnCreate se si preferisce. Il risultato è una barra degli strumenti che rimane fissa, unable to mobile o redock e non di visualizzare le descrizioni comandi.

Modificare la risorsa barra degli strumenti

La barra degli strumenti predefinita che si ottiene mediante la creazione guidata applicazione è basata su una risorsa personalizzata di RT_TOOLBAR, introdotta nella versione 4,0 di MFC. È possibile modificare questa risorsa con editor barra degli strumenti. L'editor consente di facile aggiungere, rimuovere e riordinare i pulsanti. Contiene un editor grafico per i pulsanti che è molto simile all'editor grafico generale in Visual C++. Se sono state modificate le barre degli strumenti nelle versioni precedenti di Visual C++, sono ora l'attività molto più semplice.

Per connettere un pulsante della barra degli strumenti a un comando, assegnarvi pulsante un ID di comando, ad esempio ID_MYCOMMAND. Specificare l'id di comando nella pagina proprietà del pulsante nell'editor barra degli strumenti. Creare quindi una funzione di gestione per il comando (vedere Vedere mapping di messaggi per ulteriori informazioni.

Nuovo lavoro di funzioni membro di CToolBar alla risorsa di RT_TOOLBAR. LoadToolBar ora sostituisce LoadBitmap per caricare la bitmap delle icone dei pulsanti della barra degli strumenti e SetButtons per impostare gli stili del pulsante e connettere i pulsanti con immagini bitmap.

Per informazioni dettagliate su come utilizzare l'editor della barra degli strumenti, vedere Editor barra degli strumenti.

Barre degli strumenti più

La creazione guidata applicazione fornisce una barra degli strumenti predefinita. Se sono necessari più barre degli strumenti dell'applicazione, è possibile modellare il codice per le barre degli strumenti aggiuntive in base al codice generato dalla creazione guidata nella barra degli strumenti predefinita.

Se si desidera visualizzare una barra degli strumenti come risultato di un comando, è necessario disporre di:

  • Creare una nuova risorsa barra degli strumenti con l'editor barra degli strumenti e carichila in OnCreate con la funzione membro di LoadToolbar.

  • Importare un nuovo oggetto di CToolBar nella classe della finestra cornice principale.

  • Fare chiamate a funzioni appropriate in OnCreate per ancorare o rendere mobile la barra degli strumenti, impostare gli stili, e così via.

Scegliere l'argomento su cui visualizzare maggiori informazioni

Vedere anche

Concetti

Implementazione della barra degli strumenti MFC