ToolTip.SetToolTip(Control, String) ToolTip.SetToolTip(Control, String) ToolTip.SetToolTip(Control, String) Method

Definición

Asocia el texto de información sobre herramientas al control especificado.Associates ToolTip text with the specified control.

public:
 void SetToolTip(System::Windows::Forms::Control ^ control, System::String ^ caption);
public void SetToolTip (System.Windows.Forms.Control control, string caption);
member this.SetToolTip : System.Windows.Forms.Control * string -> unit

Parámetros

control
Control Control Control

Control al que se asociará el texto de información sobre herramientas.The Control to associate the ToolTip text with.

caption
String String String

Texto de información sobre herramientas que se muestra cuando el puntero se sitúa sobre el control.The ToolTip text to display when the pointer is on the control.

Ejemplos

En el ejemplo de código siguiente se crea una ToolTip instancia de la clase y se asocia Form la instancia con la clase en la que se crea la instancia.The following code example creates an instance of the ToolTip class and associates the instance with the Form that the instance is created within. A continuación, el código inicializa las propiedades AutoPopDelayde InitialDelayretraso, ReshowDelayy.The code then initializes the delay properties AutoPopDelay, InitialDelay, and ReshowDelay. Además, la instancia de la ToolTip clase establece la ShowAlways propiedad en true para permitir que se muestre el texto de información sobre herramientas sin tener en consideración si el formulario está activo.In addition the instance of the ToolTip class sets the ShowAlways property to true to enable ToolTip text to be displayed regardless of whether the form is active. Por último, en el ejemplo se asocia el texto de información sobre herramientas con Button dos controles CheckBoxen un formulario, un y un.Finally, the example associates ToolTip text with two controls on a form, a Button and a CheckBox. Este ejemplo requiere que el método definido en el ejemplo se encuentre dentro de Form un que contiene Button un control button1 denominado y CheckBox un control checkBox1denominado, y que el método se llama desde el constructor de. el Form.This example requires that the method defined in the example is located within a Form that contains a Button control named button1 and a CheckBox control named checkBox1, and that the method is called from the constructor of the Form.

// This example assumes that the Form_Load event handling method
// is connected to the Load event of the form.
void Form1_Load( Object^ sender, System::EventArgs^ e )
{
   // Create the ToolTip and associate with the Form container.
   ToolTip^ toolTip1 = gcnew 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.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 Sub Form1_Load(sender As Object, e As System.EventArgs) Handles MyBase.Load
   ' Create the ToolTip and associate with the Form container.
   Dim toolTip1 As 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(Me.button1, "My button1")
   toolTip1.SetToolTip(Me.checkBox1, "My checkBox1")
End Sub

Comentarios

Además de especificar el texto de información sobre herramientas que se va a mostrar para un control, también puede utilizar este método para modificar el texto de información sobre herramientas de un control.In addition to specifying the ToolTip text to display for a control, you can also use this method to modify the ToolTip text for a control. Si se SetToolTip llama al método más de una vez para un control determinado, no se especifica el texto de información sobre herramientas que se va a mostrar en un control, sino que se cambia el texto de la información sobre herramientas actual del control.Calling the SetToolTip method more than once for a given control does not specify multiple ToolTip text to display for a control, but instead changes the current ToolTip text for the control. Para determinar el texto de información sobre herramientas que está asociado a un control en tiempo de GetToolTip ejecución, use el método.To determine the ToolTip text that is associated with a control at run time, use the GetToolTip method.

Como regla general, el texto utilizado debe ser corto. sin embargo, puede insertar saltos de línea mediante \r\n la secuencia de caracteres de escape.As a general rule the text used should be short; however, you can insert line breaks by using the \r\n escape character sequence. Los signos de y comercial (&) del texto se controlan StripAmpersands tal y como se describe en la propiedad.Ampersands (&) in the text are handled as described by the StripAmpersands property.

Se aplica a

Consulte también: