Controlar las notificaciones de información sobre herramientas
Cuando especifica el estilo TBSTYLE_TOOLTIPS, la barra de herramientas crea y administra un control de información sobre herramientas. Una información sobre herramientas es una ventana emergente pequeña que contiene una línea de texto que describe un botón de la barra de herramientas. La información sobre herramientas está oculta y solo aparece cuando el usuario coloca el cursor en un botón de la barra de herramientas y lo deja allí durante, aproximadamente, medio segundo. La información sobre herramientas se muestra cerca del cursor.
Antes de que se muestre la información sobre herramientas, el mensaje de notificación TTN_NEEDTEXT se envía a la ventana propietaria de la barra para recuperar el texto descriptivo del botón. Si la ventana propietaria de la barra de herramientas es una ventana CFrameWnd, la información sobre herramientas se muestra sin ningún esfuerzo adicional, porque CFrameWnd tiene un controlador predeterminado para la notificación TTN_NEEDTEXT. Si la ventana propietaria de la barra de herramientas no deriva de CFrameWnd, como un cuadro de diálogo o vista de formulario, debe agregar una entrada a la asignación de mensajes de la ventana propietaria y proporcionar un controlador de notificaciones en la asignación de mensajes. La entrada para la asignación de mensaje de la ventana propietaria es la siguiente:
ON_NOTIFY_EX(TTN_NEEDTEXT, 0, &CMyDialog::OnTtnNeedText)
Comentarios
memberFxn
Función miembro a la que se llamará cuando se necesite texto para este botón.
Tenga en cuenta que el identificador de una información sobre herramientas siempre es 0.
Además de la notificación TTN_NEEDTEXT, un control de información sobre herramientas puede enviar las notificaciones siguientes a un control de la barra de herramientas:
| Notification | Significado |
|---|---|
| TTN_NEEDTEXTA | El control de información sobre herramientas requiere texto ASCII (solo Windows 95). |
| TTN_NEEDTEXTW | El control de información sobre herramientas requiere texto UNICODE (solo Windows NT). |
| TBN_HOTITEMCHANGE | Indica que el elemento activo (resaltado) ha cambiado. |
| NM_RCLICK | Indica que el usuario hizo clic con el botón derecho en un botón. |
| TBN_DRAGOUT | Indica que el usuario hizo clic en el botón y arrastró el puntero fuera del botón. Permite que una aplicación implemente la operación de arrastrar y colocar desde un botón de la barra de herramientas. Al recibir esta notificación, la aplicación iniciará la operación de arrastrar y colocar. |
| TBN_DROPDOWN | Indica que el usuario hizo clic en un botón que utiliza el estilo TBSTYLE_DROPDOWN. |
| TBN_GETOBJECT | Indica que el usuario movió el puntero sobre un botón que utiliza el estilo TBSTYLE_DROPPABLE. |
Para una función de controlador de ejemplo y más información sobre cómo habilitar información sobre herramientas, consulte Información sobre herramientas.