24 Control ToolTip

Un ToolTip es una pequeña ventana auxiliar que muestra un texto informativo relacionado con una ventana o un control.

Generalmente se activan un pequeño tiempo después de que el ratón permanezca inmóvil sobre la ventana o control. Ese intervalo de tiempo impide que se muestren cuando probablemente no son necesarios. Normalmente se usan para indicar al usuario el tipo de información que la aplicación espera que se introduzca en un control determinado, o para explicar qué acciones se llevarán a cabo al pulsar un botón determinado, etc.

Los tooltips se muestran como una ventana superpuesta en la posición del ratón, con un texto.

Asignar un tooltip a una ventana

Se puede asignar un tooltip a cualquier ventana o control, ya que el método para hacerlo pertenece a la clase wxWindow.

Para ello basta con invocar al método SetToolTip, indicando como parámetro el texto que queremos que se muestre.

    boton = new wxButton(this, idBoton2, _T("Botón 2"));
    boton->SetToolTip(_T("Al pulsar este botón no pasará nada, o tal vez si..."));

También podemos crear un objeto de la clase wxToolTip, y asociarlo con la ventana, usando un método sobrecargado con el mismo nombre.

    boton = new wxButton(this, idBoton2, _T("Botón 2"));
    wxToolTip* tip = new wxToolTip(_T("Al pulsar este botón no pasará nada, o tal vez si..."));
    boton->SetToolTip(tip);

Además, la clase wxWindow nos proporciona otros métodos relacionados con los tooltips.

GetToolTip obtiene un puntero al tooltip asociado con la ventana. Puede ser nullptr si la ventana no tiene asociado un tooltip.

GetToolTipText devuelve el texto del tooltip asociado a la ventana.

UnsetToolTip anula la información sobre un tooltip existente. Equivale a invocar el método SetToolTip con el valor nullptr como paraḿetro.

    boton2->UnsetToolTip();

Por su parte, la clase wxToolTip dispone de métodos propios:

• GetTip obtiene la cadena asociada al tooltip.
• GetWindow obtiene la ventana a la que está asociado el tooltip.
• SetTip premite modificar el texto asociado al tooltip.

Métodos estáticos

La clase wxToolTip también dispone de varios métodos estáticos, que como tales, afectan a todos los tooltips de forma global, en lugar de sólo a uno concreto.

Al tratarse de métodos estáticos hay que invocarlos con el nombre completo, es decir, precedidos del nombre de la clase y el operador ::. Además, no todos están implementados para todas las plataformas:<(p>

• Enable: permite activar o desactivar los tooltips.
• SetAutoPop: establece el tiempo que se muestra el tooltip antes de ocultarse automáticamente.
• SetDelay: establece el tiempo que debe permanecer el puntero del ratón sobre la ventana sin moverse, antes de que se muestre el tooltip.
• SetMaxWidth: establece la anchura máxima del tooltip.
• SetReshow: establece el retardo para la aparición de posteriores tooltips.

    wxToolTip::Enable(false); // Desactiva los tooltips

Ejemplo 24

Windows:

Linux: