Gestione delle notifiche dei suggerimenti

Quando si specifica lo stile TBSTYLE_TOOLTIPS, la barra degli strumenti crea e gestisce un controllo tooltip. Una descrizione comando è una piccola finestra popup che contiene una riga di testo che descrive un pulsante della barra degli strumenti. La descrizione comando è nascosta, visualizzata solo quando l'utente posiziona il cursore su un pulsante della barra degli strumenti e lo lascia lì per circa un secondo. La descrizione comando viene visualizzata vicino al cursore.

Prima che venga visualizzata la descrizione comando, il messaggio di notifica TTN_NEEDTEXT viene inviato alla finestra del proprietario della barra degli strumenti per recuperare il testo descrittivo per il pulsante. Se la finestra proprietaria della barra degli strumenti è una CFrameWnd finestra, i suggerimenti degli strumenti vengono visualizzati senza alcun sforzo aggiuntivo, perché CFrameWnd ha un gestore predefinito per la notifica di TTN_NEEDTEXT . Se la finestra proprietaria della barra degli strumenti non è derivata da CFrameWnd, ad esempio una finestra di dialogo o una visualizzazione di modulo, è necessario aggiungere una voce alla mappa dei messaggi della finestra proprietaria e fornire un gestore di notifica nella mappa dei messaggi. La voce nella mappa dei messaggi della finestra proprietaria è la seguente:

ON_NOTIFY_EX(TTN_NEEDTEXT, 0, &CMyDialog::OnTtnNeedText)

Osservazioni:

memberFxn
Funzione membro da chiamare quando è necessario il testo per questo pulsante.

Si noti che l'ID dell'etichetta di comando è sempre 0.

Oltre alla notifica TTN_NEEDTEXT, un controllo tool tip può inviare le seguenti notifiche a un controllo barra degli strumenti.

Notifica	Significato
TTN_NEEDTEXTA	Il controllo tooltip richiede testo ASCII (solo Windows 95)
TTN_NEEDTEXTW	Il controllo descrizione comando richiede testo UNICODE (solo Windows NT)
TBN_HOTITEMCHANGE	Indica che l'elemento attivo (evidenziato) è stato modificato.
NM_RCLICK	Indica che l'utente ha fatto clic con il pulsante destro del mouse su un pulsante.
TBN_DRAGOUT	Indica che l'utente ha fatto clic sul pulsante e trascinato il puntatore dal pulsante. Consente a un'applicazione di implementare il trascinamento della selezione da un pulsante della barra degli strumenti. Quando si riceve questa notifica, l'applicazione avvierà l'operazione di trascinamento e rilascio.
TBN_DROPDOWN	Indica che l'utente ha fatto clic su un pulsante che utilizza lo stile di TBSTYLE_DROPDOWN .
TBN_GETOBJECT	Indica che l'utente ha spostato il puntatore su un pulsante che usa lo stile TBSTYLE_DROPPABLE .

Per una funzione del gestore di esempio e altre informazioni sull'abilitazione dei suggerimenti per gli strumenti, vedere Suggerimenti per gli strumenti.

Vedere anche

Uso di CToolBarCtrl
Comandi