¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo

ToolTip (Clase)

Representa una pequeña ventana emergente rectangular que muestra una breve descripción de la finalidad de un control cuando el usuario sitúa el puntero sobre el control.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

public class ToolTip : Component, IExtenderProvider
public class ToolTip extends Component implements IExtenderProvider
public class ToolTip extends Component implements IExtenderProvider
No aplicable.

Con la clase ToolTip, puede proporcionar sugerencias a un usuario cuando éste coloca el puntero sobre un control. Normalmente, la clase ToolTip se utiliza para notificar a los usuarios el uso al que está destinado un control. Por ejemplo, para un control TextBox que acepta un nombre, podría especificar un texto de información sobre herramientas que indique el formato del nombre que se debe escribir en el control. Además de para proporcionar sugerencias, la clase ToolTip se puede utilizar para proporcionar información de estado en tiempo de ejecución. Por ejemplo, se puede utilizar la clase ToolTip para mostrar datos sobre la velocidad de conexión y la calidad de la línea cuando el usuario desplace el puntero sobre un control PictureBox que muestra el estado de la conexión a Internet.

La clase ToolTip se puede utilizar en cualquier contenedor. Para especificar explícitamente un contenedor, utilice el constructor ToolTip(IContainer). Un componente ToolTip único se utiliza normalmente para crear información sobre herramientas para diversos controles en un formulario único. Después de crear ToolTip, utilice una llamada independiente al método SetToolTip para asociar el texto de presentación de información sobre herramientas a un control individual. A continuación, cuando el usuario mueve el puntero sobre un control, se muestra la información sobre herramientas con su texto. Puede llamar a SetToolTip más de una vez para el mismo control para cambiar el texto que se asocia al control. Para obtener el texto al que está asociado un control, utilice el método GetToolTip. Para quitar todos los textos de información sobre herramientas asociados a una instancia de la clase ToolTip, utilice el método RemoveAll.

NotaNota:

La información sobre herramientas no se muestra para los controles que están deshabilitados. A menos que la propiedad ShowAlways se establezca en true, no se muestra la información sobre herramientas cuando su contenedor está inactivo.

La clase ToolTip proporciona las propiedades y los métodos siguientes para modificar el comportamiento y aspecto predeterminados de una información sobre herramientas.

Categoría

Miembros asociados

Presentación manual

Active, Show, Hide, ShowAlways, Popup, StopTimer

Control de tiempo de información sobre herramientas

AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimer

Contenido

SetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAll

Aspecto

BackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFading

Si desea que no se muestre ningún texto de información sobre herramientas en la aplicación, utilice la propiedad Active. Generalmente, la información sobre herramientas la dibuja el sistema operativo, pero para personalizar la apariencia de ToolTip, puede establecer la propiedad OwnerDraw en true y controlar el evento Draw.

La clase ToolTipTitle implementa la interfaz System.ComponentModel.IExtenderProvider, que tiene un método único, CanExtend. La información sobre herramientas extiende los controles en el mismo formulario en tiempo de diseño, agregando una propiedad ToolTip. Para obtener más información acerca de los proveedores extensores, vea Proveedores extensores.

En el siguiente ejemplo de código se crea una instancia de la clase ToolTip y la asocia a Form donde se creó la instancia. Después, el código inicializa las propiedades de retraso AutoPopDelay, InitialDelay y ReshowDelay. Además, la instancia de la clase ToolTip establece la propiedad ShowAlways en true para que el texto de información sobre herramientas se muestre siempre, aunque el formulario no esté activo. Por último, en el ejemplo se asocia el texto de información sobre herramientas a dos controles de un formulario, Button y CheckBox. El ejemplo de código requiere que el método definido en él se encuentre en un Form que contenga un control Button denominado button1 y un control CheckBox denominado checkBox1 y que se llame al método desde el constructor de Form.

// This example assumes that the Form_Load event handling method
// is connected to the Load event of the form.
private void Form1_Load(object sender, System.EventArgs e)
{
   // Create the ToolTip and associate with the Form container.
   ToolTip toolTip1 = new ToolTip();

   // Set up the delays for the ToolTip.
   toolTip1.AutoPopDelay = 5000;
   toolTip1.InitialDelay = 1000;
   toolTip1.ReshowDelay = 500;
   // Force the ToolTip text to be displayed whether or not the form is active.
   toolTip1.ShowAlways = true;
      
   // Set up the ToolTip text for the Button and Checkbox.
   toolTip1.SetToolTip(this.button1, "My button1");
   toolTip1.SetToolTip(this.checkBox1, "My checkBox1");
}

// This example assumes that the Form_Load event handling method
// is connected to the Load event of the form.
private void Form1_Load(Object sender, System.EventArgs e)
{
    // Create the ToolTip and associate with the Form container.
    ToolTip toolTip1 = new ToolTip();
    // Set up the delays for the ToolTip.
    toolTip1.set_AutoPopDelay(5000);
    toolTip1.set_InitialDelay(1000);
    toolTip1.set_ReshowDelay(500);
    // Force the ToolTip text to be displayed whether or not the form
    // is active.
    toolTip1.set_ShowAlways(true);
    // Set up the ToolTip text for the Button and Checkbox.
    toolTip1.SetToolTip(this.button1, "My button1");
    toolTip1.SetToolTip(this.checkBox1, "My checkBox1");
} //Form1_Load

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0
Mostrar:
© 2015 Microsoft