Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase ToolTip

 

Publicado: octubre de 2016

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)

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.ToolTip

public class ToolTip : Component, IExtenderProvider

NombreDescripción
System_CAPS_pubmethodToolTip()

Inicializa una nueva instancia de la ToolTip sin un contenedor especificado.

System_CAPS_pubmethodToolTip(IContainer)

Inicializa una nueva instancia de la ToolTip clase con un contenedor especificado.

NombreDescripción
System_CAPS_pubpropertyActive

Obtiene o establece un valor que indica si la información sobre herramientas está actualmente activa.

System_CAPS_pubpropertyAutomaticDelay

Obtiene o establece el retraso automático de la información sobre herramientas.

System_CAPS_pubpropertyAutoPopDelay

Obtiene o establece el período de tiempo que la información sobre herramientas estará visible si el puntero se detiene sobre un control para el que se haya especificado esa información.

System_CAPS_pubpropertyBackColor

Obtiene o establece el color de fondo de la información sobre herramientas.

System_CAPS_protpropertyCanRaiseEvents

Obtiene un valor que indica si el componente puede provocar un evento.(Heredado de Component).

System_CAPS_pubpropertyContainer

Obtiene IContainer que contiene Component.(Heredado de Component).

System_CAPS_protpropertyCreateParams

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene los parámetros de creación para la ventana de información sobre herramientas.

System_CAPS_protpropertyDesignMode

Obtiene un valor que indica si la Component está actualmente en modo de diseño.(Heredado de Component).

System_CAPS_protpropertyEvents

Obtiene la lista de controladores de eventos que se adjuntará a este Component.(Heredado de Component).

System_CAPS_pubpropertyForeColor

Obtiene o establece el color de primer plano de la información sobre herramientas.

System_CAPS_pubpropertyInitialDelay

Obtiene o establece el tiempo que transcurre hasta que aparece la información sobre herramientas.

System_CAPS_pubpropertyIsBalloon

Obtiene o establece un valor que indica si la información sobre herramientas debería utilizar una ventana de globo.

System_CAPS_pubpropertyOwnerDraw

Obtiene o establece un valor que indica si la información sobre herramientas la dibuja el sistema operativo o el código que se proporciona.

System_CAPS_pubpropertyReshowDelay

Obtiene o establece el período de tiempo que debe transcurrir antes de que aparezca la siguiente ventana de información sobre herramientas cuando el puntero se desplaza de un control a otro.

System_CAPS_pubpropertyShowAlways

Obtiene o establece un valor que indica si la ventana de información sobre herramientas se muestra aunque el control primario no esté activo.

System_CAPS_pubpropertySite

Obtiene o establece la ISite de la Component.(Heredado de Component).

System_CAPS_pubpropertyStripAmpersands

Obtiene o establece un valor que determina cómo se tratan los caracteres de "y" comercial (&).

System_CAPS_pubpropertyTag

Obtiene o establece el objeto que contiene datos proporcionados por el programador asociados a la ToolTip.

System_CAPS_pubpropertyToolTipIcon

Obtiene o establece un valor que define el tipo de icono que se va a mostrar junto al texto de información sobre herramientas.

System_CAPS_pubpropertyToolTipTitle

Obtiene o establece un título para la ventana de información sobre herramientas.

System_CAPS_pubpropertyUseAnimation

Obtiene o establece un valor que determina si se debería utilizar un efecto de animación al mostrar la información sobre herramientas.

System_CAPS_pubpropertyUseFading

Obtiene o establece un valor que determina si se debería utilizar un efecto de atenuación al mostrar la información sobre herramientas.

NombreDescripción
System_CAPS_pubmethodCanExtend(Object)

Devuelve true Si la información sobre herramientas puede ofrecer una propiedad extensora al componente de destino especificado.

System_CAPS_pubmethodCreateObjRef(Type)

Crea un objeto que contiene toda la información pertinente necesaria para generar a un proxy utilizado para comunicarse con un objeto remoto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodDispose()

Libera todos los recursos que usa Component.(Heredado de Component).

System_CAPS_protmethodDispose(Boolean)

Libera los recursos no administrados que usa Component y libera los recursos administrados de forma opcional.(Invalida Component.Dispose(Boolean)).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Libera los recursos no administrados y realiza otras operaciones de limpieza antes de la Cursor sea reclamado por el recolector de elementos no utilizados.(Invalida Component.Finalize()).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_protmethodGetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.(Heredado de Component).

System_CAPS_pubmethodGetToolTip(Control)

Recupera el texto de información sobre herramientas asociado al control especificado.

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodHide(IWin32Window)

Oculta la ventana de información sobre herramientas especificada.

System_CAPS_pubmethodInitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone(Boolean)

Crea una copia superficial del actual MarshalByRefObject objeto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodRemoveAll()

Quita todo el texto de información de herramientas asociado al componente de información sobre herramientas.

System_CAPS_pubmethodSetToolTip(Control, String)

Asocia el texto de información sobre herramientas al control especificado.

System_CAPS_pubmethodShow(String, IWin32Window)

Establece el texto de información sobre herramientas asociado al control especificado y muestra de forma modal esa información.

System_CAPS_pubmethodShow(String, IWin32Window, Int32)

Establece el texto de información sobre herramientas asociado al control especificado y, a continuación, muestra la información durante el tiempo especificado.

System_CAPS_pubmethodShow(String, IWin32Window, Int32, Int32)

Establece el texto de información sobre herramientas asociado al control especificado y, a continuación, muestra de forma modal la información en la posición relativa especificada.

System_CAPS_pubmethodShow(String, IWin32Window, Int32, Int32, Int32)

Establece el texto de información sobre herramientas asociado al control especificado y, a continuación, muestra la información durante el tiempo especificado en la posición relativa indicada.

System_CAPS_pubmethodShow(String, IWin32Window, Point)

Establece el texto de información sobre herramientas asociado al control especificado y, a continuación, muestra de forma modal la información en la posición relativa especificada.

System_CAPS_pubmethodShow(String, IWin32Window, Point, Int32)

Establece el texto de información sobre herramientas asociado al control especificado y, a continuación, muestra la información durante el tiempo especificado en la posición relativa indicada.

System_CAPS_protmethodStopTimer()

Detiene el temporizador que oculta la información sobre herramientas mostrada.

System_CAPS_pubmethodToString()

Devuelve una representación de cadena para este control.(Invalida Component.ToString()).

NombreDescripción
System_CAPS_pubeventDisposed

Se produce cuando el componente se elimina mediante una llamada a la Dispose (método).(Heredado de Component).

System_CAPS_pubeventDraw

Se produce cuando se dibuja la información sobre herramientas y el OwnerDraw propiedad está establecida en true y IsBalloon propiedad es false.

System_CAPS_pubeventPopup

Sucede antes de que se muestre inicialmente una información sobre herramientas. Este es el evento predeterminado para la ToolTip clase.

Con el ToolTip (clase), puede proporcionar sugerencias a un usuario cuando el usuario coloca el puntero sobre un control. La ToolTip clase normalmente se usa para alertar a los usuarios con el uso previsto de un control. Por ejemplo, puede especificar el texto de información sobre herramientas para un TextBox control que acepta un nombre, que especifica el formato del nombre que se escriba en el control. Además de ofrecer sugerencias, también puede utilizar el ToolTip clase para proporcionar información de estado de tiempo de ejecución. Por ejemplo, puede usar el ToolTip clase para mostrar los datos de calidad de velocidad y la línea de conexión cuando el usuario mueve el puntero sobre un PictureBox control que muestra el estado de conexión de Internet.

La ToolTip clase puede usarse en cualquier contenedor. Para especificar explícitamente un contenedor, utilice la ToolTip(IContainer) constructor. Una sola ToolTip componente se utiliza normalmente para crear información sobre herramientas para varios controles en un único formulario. Después de crear un ToolTip, utilice una llamada independiente a la SetToolTip para asociar el texto para mostrar información sobre herramientas a un control individual. Cuando el usuario mueve el puntero sobre un control, se mostrará la información sobre herramientas con su texto. Puede llamar a SetToolTip más de una vez para el mismo control cambiar el texto que está asociado el control. Para obtener el texto que está asociado a un control, utilice la GetToolTip método. Para quitar todas las asociaciones de texto de información sobre herramientas con una instancia de la ToolTip clase, use la RemoveAll método.

System_CAPS_noteNota

No se muestra el texto de información sobre herramientas para los controles que están deshabilitados. A menos que el ShowAlways propiedad se establece en true, no se muestra información sobre herramientas cuando su contenedor está inactivo.

La ToolTip clase proporciona las siguientes propiedades y métodos para modificar el comportamiento predeterminado y la apariencia de una información sobre herramientas.

Categoría

Miembros asociados

Presentación manual

Active, Show, Hide, ShowAlways, Popup, StopTimer

Tiempo de información sobre herramientas

AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimer

Contenido

SetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAll

Apariencia

BackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFading

Si desea deshabilitar todo el texto de información sobre herramientas para que no se puede mostrar en la aplicación, puede utilizar el Active propiedad. Normalmente la información sobre herramientas se dibuja el sistema operativo, pero para personalizar la apariencia de la ToolTip, puede establecer el OwnerDraw propiedad true y controlar la Draw eventos.

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

En el ejemplo de código siguiente se crea una instancia de la ToolTip clase y la asocia con el Form que se creó la instancia. A continuación, el código inicializa las propiedades de retraso AutoPopDelay, InitialDelay, y ReshowDelay. Además la instancia de la ToolTip clase establece la ShowAlways propiedad true para habilitar el texto de información sobre herramientas se muestre independientemente de si el formulario está activo siempre. Por último, el ejemplo asocia el texto de información sobre herramientas a dos controles en un formulario, un Button y un CheckBox. El ejemplo de código requiere que el método definido en el ejemplo se encuentra en un Form que contiene un Button control denominado button1 y un CheckBox control denominado checkBox1, y que se llama al método desde el constructor de la 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");
}

.NET Framework
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: