Come personalizzare le barre degli strumenti
La maggior parte delle applicazioni basate su Windows usa i controlli della barra degli strumenti per fornire agli utenti un accesso pratico alla funzionalità del programma. Tuttavia, le barre degli strumenti statiche presentano alcune carenze, ad esempio troppo poco spazio per visualizzare in modo efficace tutti gli strumenti disponibili. La soluzione a questo problema consiste nel rendere personalizzabili le barre degli strumenti dell'applicazione. Quindi, gli utenti possono scegliere di visualizzare solo gli strumenti di cui hanno bisogno e possono organizzarli in modo adatto al proprio stile di lavoro personale.
Nota
Le barre degli strumenti nelle finestre di dialogo non possono essere personalizzate.
Per abilitare la personalizzazione, includere il flag di stile dei controlli comuni CCS_ADJUSTABLE quando si crea il controllo barra degli strumenti. Esistono due approcci di base alla personalizzazione:
- Finestra di dialogo di personalizzazione. Questa finestra di dialogo fornita dal sistema è l'approccio più semplice. Offre agli utenti un'interfaccia utente grafica che consente di aggiungere, eliminare o spostare icone.
- Trascinamento e rilascio di strumenti. L'implementazione della funzionalità di trascinamento della selezione consente agli utenti di spostare gli strumenti in un'altra posizione sulla barra degli strumenti o di eliminarli trascinandoli dalla barra degli strumenti. Offre agli utenti un modo rapido e semplice per organizzare la barra degli strumenti, ma non consente loro di aggiungere strumenti.
È possibile implementare un approccio o entrambi, a seconda delle esigenze dell'applicazione. Nessuno di questi due approcci alla personalizzazione fornisce un meccanismo predefinito, ad esempio un pulsante Annulla o Annulla, per restituire la barra degli strumenti allo stato precedente. È necessario usare in modo esplicito l'API di controllo della barra degli strumenti per archiviare lo stato di precustomizzazione della barra degli strumenti. Se necessario, è possibile utilizzare queste informazioni archiviate in un secondo momento per ripristinare lo stato originale della barra degli strumenti.
Informazioni importanti
Tecnologie
Prerequisiti
- C/C++
- Programmazione dell'interfaccia utente di Windows
Istruzioni
Finestra di dialogo Personalizzazione
La finestra di dialogo di personalizzazione viene fornita dal controllo barra degli strumenti per offrire agli utenti un modo semplice per aggiungere, spostare o eliminare strumenti. Gli utenti possono avviarlo facendo doppio clic sulla barra degli strumenti. Le applicazioni possono avviare la finestra di dialogo di personalizzazione a livello di codice inviando il controllo della barra degli strumenti a un messaggio di TB_CUSTOMIZE .
La figura seguente mostra un esempio della finestra di dialogo di personalizzazione della barra degli strumenti.
Gli strumenti nella casella di riepilogo a destra sono quelli attualmente presenti sulla barra degli strumenti. Inizialmente, questo elenco conterrà gli strumenti specificati quando si crea la barra degli strumenti. La casella di riepilogo a sinistra contiene gli strumenti disponibili per l'aggiunta alla barra degli strumenti. L'applicazione è responsabile del popolamento dell'elenco ,ad eccezione del separatore, visualizzato automaticamente.
Il controllo barra degli strumenti notifica all'applicazione che sta avviando una finestra di dialogo di personalizzazione inviando alla relativa finestra padre un codice di notifica TBN_BEGINADJUST seguito da un codice di notifica TBN_INITCUSTOMIZE. Nella maggior parte dei casi, l'applicazione non deve rispondere a questi codici di notifica. Tuttavia, se non si desidera che la finestra di dialogo Personalizza barra degli strumenti visualizzi un pulsante ? , gestire TBN_INITCUSTOMIZE restituendo TBNRF_HIDEHELP.
Il controllo barra degli strumenti raccoglie quindi le informazioni necessarie per inizializzare la finestra di dialogo inviando tre serie di codici di notifica, nell'ordine seguente:
- Codice di notifica TBN_QUERYINedizione Standard RT per ogni pulsante sulla barra degli strumenti per determinare dove inserire i pulsanti. Restituisce FAL edizione Standard per impedire l'inserimento di un pulsante a sinistra del pulsante specificato nel messaggio di notifica. Se si restituisce FAL edizione Standard a tutti i codici di notifica TBN_QUERYINedizione Standard RT, la finestra di dialogo non verrà visualizzata.
- Codice di notifica TBN_QUERYDELETE per ogni strumento attualmente presente sulla barra degli strumenti. Restituisce TRUE se uno strumento può essere eliminato o FAL edizione Standard in caso contrario.
- Serie di codici di notifica TBN_GETBUTTONINFO per popolare l'elenco dei pulsanti disponibili. Per aggiungere un pulsante all'elenco, compilare la struttura NMTOOLBAR passata con il codice di notifica e restituire TRUE. Quando non si dispone di altri strumenti da aggiungere, restituire FAL edizione Standard. Si noti che è possibile restituire informazioni per i pulsanti già presenti sulla barra degli strumenti; questi pulsanti non verranno aggiunti all'elenco.
La finestra di dialogo viene quindi visualizzata e l'utente può iniziare a personalizzare la barra degli strumenti.
Quando la finestra di dialogo è aperta, l'applicazione può ricevere un'ampia gamma di codici di notifica, a seconda delle azioni dell'utente:
- TBN_QUERYINedizione Standard RT. L'utente ha modificato la posizione di uno strumento sulla barra degli strumenti o ha aggiunto uno strumento. Restituisce FAL edizione Standard per impedire l'inserimento dello strumento in tale posizione.
- TBN_DELETINGBUTTON. L'utente sta per rimuovere uno strumento dalla barra degli strumenti.
- TBN_CUSTHELP. L'utente ha fatto clic sul pulsante ?
- TBN_TOOLBARCHANGE. L'utente ha aggiunto, spostato o eliminato uno strumento.
- TBN_REedizione Standard T. L'utente ha fatto clic sul pulsante Reimposta.
Una volta eliminata la finestra di dialogo, l'applicazione riceverà un codice di notifica TBN_ENDADJUST .
Nell'esempio di codice seguente viene illustrato un modo per implementare la personalizzazione della barra degli strumenti.
// The buttons are stored in an array of TBBUTTON structures.
//
// Constants such as STD_FILENEW are identifiers for the
// built-in bitmaps that have already been assigned as the toolbar's
// image list.
//
// Constants such as IDM_NEW are application-defined command identifiers.
TBBUTTON allButtons[] =
{
{ MAKELONG(STD_FILENEW, ImageListID), IDM_NEW, TBSTATE_ENABLED, 0, {0}, 0, (INT_PTR)L"New" },
{ MAKELONG(STD_FILEOPEN, ImageListID), IDM_OPEN, TBSTATE_ENABLED, 0, {0}, 0, (INT_PTR)L"Open"},
{ MAKELONG(STD_FILESAVE, ImageListID), IDM_SAVE, TBSTATE_ENABLED, 0, {0}, 0, (INT_PTR)L"Save"},
{ MAKELONG(STD_CUT, ImageListID), IDM_CUT, TBSTATE_ENABLED, 0, {0}, 0, (INT_PTR)L"Cut" },
{ MAKELONG(STD_COPY, ImageListID), IDM_COPY, TBSTATE_ENABLED, 0, {0}, 0, (INT_PTR)L"Copy"},
{ MAKELONG(STD_PASTE, ImageListID), IDM_PASTE, TBSTATE_ENABLED, 0, {0}, 0, (INT_PTR)L"Paste"}
};
// The following appears in the window's message handler.
case WM_NOTIFY:
{
switch (((LPNMHDR)lParam)->code)
{
case TBN_GETBUTTONINFO:
{
LPTBNOTIFY lpTbNotify = (LPTBNOTIFY)lParam;
// Pass the next button from the array. There is no need to filter out buttons
// that are already used—they will be ignored.
int buttonCount = sizeof(allButtons) / sizeof(TBBUTTON);
if (lpTbNotify->iItem < buttonCount)
{
lpTbNotify->tbButton = allButtons[lpTbNotify->iItem];
return TRUE;
}
else
{
return FALSE; // No more buttons.
}
}
break;
case TBN_QUERYINSERT:
case TBN_QUERYDELETE:
return TRUE;
}
}
Trascinamento e rimozione di strumenti
Gli utenti possono anche riorganizzare i pulsanti su una barra degli strumenti premendo MAIUSC e trascinando il pulsante in un'altra posizione. Il processo di trascinamento della selezione viene gestito automaticamente dal controllo barra degli strumenti. Visualizza un'immagine fantasma del pulsante mentre viene trascinata e riorganizzerà la barra degli strumenti dopo l'eliminazione. Gli utenti non possono aggiungere pulsanti in questo modo, ma possono eliminare un pulsante rilasciandolo dalla barra degli strumenti.
Anche se il controllo della barra degli strumenti esegue normalmente questa operazione automaticamente, invia anche all'applicazione due codici di notifica: TBN_QUERYDELETE e TBN_QUERYINedizione Standard RT. Per controllare il processo di trascinamento della selezione, gestire questi codici di notifica come indicato di seguito:
- Il codice di notifica TBN_QUERYDELETE viene inviato non appena l'utente tenta di spostare il pulsante, prima che venga visualizzato il pulsante fantasma. Restituisce FAL edizione Standard per impedire lo spostamento del pulsante. Se si restituisce TRUE, l'utente sarà in grado di spostare lo strumento o eliminarlo rilasciandolo dalla barra degli strumenti. Se uno strumento può essere spostato, può essere eliminato. Tuttavia, se l'utente elimina uno strumento, il controllo barra degli strumenti invierà all'applicazione un codice di notifica TBN_DELETINGBUTTON , a questo punto è possibile scegliere di reinserire il pulsante nella posizione originale, annullando così l'eliminazione.
- Il codice di notifica TBN_QUERYINedizione Standard RT viene inviato quando l'utente tenta di rilasciare il pulsante sulla barra degli strumenti. Per evitare che il pulsante spostato venga eliminato a sinistra del pulsante specificato nella notifica, restituire FAL edizione Standard. Questo codice di notifica non viene inviato se l'utente elimina lo strumento dalla barra degli strumenti.
Se l'utente tenta di trascinare un pulsante senza premere anche MAIUSC, il controllo barra degli strumenti non gestirà l'operazione di trascinamento della selezione. Tuttavia, invierà all'applicazione un codice di notifica TBN_BEGINDRAG per indicare l'inizio di un'operazione di trascinamento e un codice di notifica TBN_ENDDRAG per indicare la fine. Se si desidera abilitare questa forma di trascinamento della selezione, l'applicazione deve gestire questi codici di notifica, fornire l'interfaccia utente necessaria e modificare la barra degli strumenti in modo da riflettere eventuali modifiche.
Salvataggio e ripristino delle barre degli strumenti
Nel processo di personalizzazione di una barra degli strumenti, l'applicazione potrebbe dover salvare le informazioni in modo da poter ripristinare lo stato originale della barra degli strumenti. Per avviare il salvataggio o il ripristino di uno stato della barra degli strumenti, inviare il controllo della barra degli strumenti a un messaggio di TB_SAVERESTORE con lParam impostato su TRUE. Il valore lParam di questo messaggio specifica se si richiede un salvataggio o un'operazione di ripristino. Dopo l'invio del messaggio, esistono due modi per gestire l'operazione di salvataggio/ripristino:
- Con i controlli comuni versione 4.72 e precedenti, è necessario implementare un gestore TBN_GETBUTTONINFO . Il controllo barra degli strumenti invia questo codice di notifica per richiedere informazioni su ogni pulsante durante il ripristino.
- La versione 5.80 include un'opzione di salvataggio/ripristino. All'inizio del processo e, man mano che ogni pulsante viene salvato o ripristinato, l'applicazione riceverà un codice di notifica TBN_SAVE o TBN_RESTORE . Per usare questa opzione, è necessario implementare i gestori di notifica per fornire le informazioni di bitmap e stato necessarie per salvare o ripristinare correttamente lo stato della barra degli strumenti.
Gli stati della barra degli strumenti vengono salvati in un flusso di dati costituito da blocchi di dati definiti dalla shell alternati con blocchi di dati definiti dall'applicazione. Un blocco di dati di ogni tipo viene archiviato per ogni pulsante, insieme a un blocco facoltativo di dati globali che le applicazioni possono posizionare all'inizio del flusso. Durante il processo di salvataggio, il gestore TBN_SAVE aggiunge i blocchi definiti dall'applicazione al flusso di dati. Durante il processo di ripristino, il gestore TBN_RESTORE legge ogni blocco e fornisce alla shell le informazioni necessarie per ricostruire la barra degli strumenti.
Come gestire una notifica di TBN_SAVE
Il primo TBN_SAVE codice di notifica viene inviato all'inizio del processo di salvataggio. Prima di salvare i pulsanti, i membri della struttura NMTBSAVE vengono impostati come illustrato nella tabella seguente.
| Membro | Impostazione |
|---|---|
| iItem | –1 |
| cbData | Quantità di memoria necessaria per i dati definiti dalla shell. |
| cButtons | Numero di pulsanti. |
| pData | Quantità calcolata di memoria necessaria per i dati definiti dall'applicazione. In genere, si includono alcuni dati globali, oltre ai dati per ogni pulsante. Aggiungere tale valore a cbData e allocare memoria sufficiente a pData per contenere tutto. |
| pCurrent | Primo byte inutilizzato nel flusso di dati. Se non sono necessarie informazioni sulla barra degli strumenti globali, impostare pCurrent = pData in modo che punti all'inizio del flusso di dati. Se sono necessarie informazioni sulla barra degli strumenti globali, archiviarla in pData, impostare pCurrent sull'inizio della parte inutilizzata del flusso di dati prima di restituire. |
Se si desidera aggiungere alcune informazioni sulla barra degli strumenti globali, inserirle all'inizio del flusso di dati. Avanzare pCurrent alla fine dei dati globali in modo che punti all'inizio della parte inutilizzata del flusso di dati e restituisca.
Al termine della restituzione, shell avvia il salvataggio delle informazioni sul pulsante. Aggiunge i dati definiti dalla shell per il primo pulsante in pCurrent e quindi sposta pCurrent all'inizio della parte inutilizzata.
Dopo aver salvato ogni pulsante, viene inviato un codice di notifica TBN_SAVE e NMTBSAVE viene restituito con questi membri impostati come indicato di seguito.
| Membro | Impostazione |
|---|---|
| iItem | Indice in base zero del numero del pulsante. |
| pCurrent | Puntatore al primo byte inutilizzato nel flusso di dati. Se si desidera archiviare informazioni aggiuntive sul pulsante, archiviarlo nella posizione a cui punta pCurrent e aggiornare pCurrent in modo che punti alla prima parte inutilizzata del flusso di dati dopo. |
| TBBUTTON | Struttura TBBUTTON che descrive il pulsante da salvare. |
Quando si riceve il codice di notifica, è necessario estrarre le informazioni specifiche del pulsante necessarie da TBBUTTON. Tenere presente che quando si aggiunge un pulsante, è possibile usare il membro dwData di TBBUTTON per contenere dati specifici dell'applicazione. Caricare i dati nel flusso di dati in pCurrent. Passare con pCurrent alla fine dei dati, puntando nuovamente all'inizio della parte inutilizzata del flusso e restituendo.
Shell passa quindi al pulsante successivo, aggiunge le informazioni a pData, sposta pCurrent, carica TBBUTTON e invia un altro codice di notifica TBN_SAVE. Questo processo continua fino a quando non vengono salvati tutti i pulsanti.
Ripristino delle barre degli strumenti salvate
Il processo di ripristino inverte fondamentalmente il processo di salvataggio. All'inizio, l'applicazione riceverà un codice di notifica TBN_RESTORE con il membro iItem della struttura NMTBRESTORE impostato su -1. Il membro cbData è impostato sulle dimensioni di pData e cButtons è impostato sul numero di pulsanti.
Il gestore delle notifiche deve estrarre le informazioni globali inserite all'inizio di pData durante il salvataggio e passare pCurrent all'inizio del primo blocco di dati definiti da Shell. Impostare cBytesPerRecord sulle dimensioni dei blocchi di dati usati per salvare i dati del pulsante. Impostare cButtons sul numero di pulsanti e restituire.
Il successivo NMTBRESTORE è per il primo pulsante. Il membro pCurrent punta all'inizio del primo blocco di dati del pulsante e iItem è impostato sull'indice del pulsante. Estrarre i dati e avanzare pCurrent. Caricare i dati in TBBUTTON e restituire. Per omettere un pulsante dalla barra degli strumenti ripristinata, impostare il membro idCommand di TBBUTTON su zero. Shell ripeterà il processo per i pulsanti rimanenti. Oltre ai messaggi NMTBSAVE e NMTBRESTORE, è anche possibile usare messaggi come TBN_REedizione Standard T per salvare e ripristinare una barra degli strumenti.
Nell'esempio di codice seguente viene salvata una barra degli strumenti prima che venga personalizzata e ripristinata se l'applicazione riceve un messaggio TBN_REedizione Standard T.
int i;
LPNMHDR lpnmhdr;
static int nResetCount;
static LPTBBUTTON lpSaveButtons;
LPARAM lParam;
switch( lpnmhdr->code)
{
case TBN_BEGINADJUST: // Begin customizing the toolbar.
{
LPTBNOTIFY lpTB = (LPTBNOTIFY)lparam;
// Allocate memory for the button information.
nResetCount = SendMessage(lpTB->hdr.hwndFrom, TB_BUTTONCOUNT, 0, 0);
lpSaveButtons = (LPTBBUTTON)GlobalAlloc(GPTR, sizeof(TBBUTTON) * nResetCount);
// In case the user presses reset, save the current configuration
// so the original toolbar can be restored.
for(i = 0; i < nResetCount; i++)
{
SendMessage(lpTB->hdr.hwndFrom,
TB_GETBUTTON, i,
(LPARAM)(lpSaveButtons + i));
}
}
return TRUE;
case TBN_RESET:
{
LPTBNOTIFY lpTB = (LPTBNOTIFY)lparam;
int nCount, i;
// Remove all of the existing buttons, starting with the last one.
nCount = SendMessage(lpTB->hdr.hwndFrom, TB_BUTTONCOUNT, 0, 0);
for(i = nCount - 1; i >= 0; i--)
{
SendMessage(lpTB->hdr.hwndFrom, TB_DELETEBUTTON, i, 0);
}
SendMessage(lpTB->hdr.hwndFrom, // Restore the saved buttons.
TB_ADDBUTTONS,
(WPARAM)nResetCount,
(LPARAM)lpSaveButtons);
}
return TRUE;
case TBN_ENDADJUST: // Free up the memory you allocated.
GlobalFree((HGLOBAL)lpSaveButtons);
return TRUE;
}
Argomenti correlati
-
Valori dell'indice dell'immagine del pulsante standard della barra degli strumenti
-
Demo dei controlli comuni di Windows (CppWindowsCommonControls)
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per