ToolTip Klass

Definition

public ref class ToolTip sealed : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider

public ref class ToolTip : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider

public sealed class ToolTip : System.ComponentModel.Component, System.ComponentModel.IExtenderProvider

public class ToolTip : System.ComponentModel.Component, System.ComponentModel.IExtenderProvider

type ToolTip = class
    inherit Component
    interface IExtenderProvider

Public NotInheritable Class ToolTip
Inherits Component
Implements IExtenderProvider

Public Class ToolTip
Inherits Component
Implements IExtenderProvider

Arv

Object

MarshalByRefObject

Component

ToolTip

Implementeringar

IExtenderProvider

Exempel

I följande kodexempel skapas en instans av ToolTip klassen och instansen associeras med Form den som instansen skapas i. Koden initierar sedan fördröjningsegenskaperna AutoPopDelay, InitialDelayoch ReshowDelay. Dessutom anger ToolTip instansen ShowAlways av klassen egenskapen till true så att Knappbeskrivningstext alltid visas oavsett om formuläret är aktivt. Slutligen associerar exemplet ToolTip-text med två kontroller i ett formulär, en Button och en CheckBox. Kodexemplet kräver att metoden som definieras i exemplet finns inom en Form som innehåller en Button kontroll med namnet button1 och en CheckBox kontroll med namnet checkBox1, och att metoden anropas från konstruktorn i 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

Kommentarer

ToolTip Med klassen kan du ge tips till en användare när användaren placerar pekaren på en kontroll. Klassen ToolTip används vanligtvis för att varna användare om den avsedda användningen av en kontroll. Du kan till exempel ange Knappbeskrivningstext för en TextBox kontroll som accepterar ett namn och ange formatet för det namn som ska skrivas in i kontrollen. Förutom att ge tips kan du även använda ToolTip klassen för att ange statusinformation för körningstid. Du kan till exempel använda ToolTip klassen för att visa anslutningshastighet och linjekvalitetsdata när användaren flyttar pekaren till en PictureBox kontroll som visar Status för Internetanslutning.

Klassen ToolTip kan användas i valfri container. Om du uttryckligen vill ange en container använder du ToolTip(IContainer) konstruktorn. En enskild ToolTip komponent används vanligtvis för att skapa knappbeskrivningar för flera kontroller i ett enda formulär. När du har skapat en ToolTipanvänder du ett separat anrop till SetToolTip metoden för att associera Visningstext för Knappbeskrivning till en enskild kontroll. När användaren sedan flyttar pekaren på en kontroll visas knappbeskrivningen med dess text. Du kan anropa SetToolTip mer än en gång för samma kontroll för att ändra texten som är associerad med kontrollen. Använd metoden för att hämta texten som är associerad med en kontroll GetToolTip . Om du vill ta bort alla ToolTip-textassociationer med en instans av ToolTip klassen använder du RemoveAll metoden .

Klassen ToolTip innehåller följande egenskaper och metoder för att ändra standardbeteendet och utseendet på en Knappbeskrivning.

Om du vill inaktivera all knappbeskrivningstext så att den inte kan visas i programmet kan du använda Active egenskapen . Vanligtvis ritas knappbeskrivningen av operativsystemet, men för att anpassa utseendet på ToolTipkan du ange OwnerDraw egenskapen till true och hantera Draw händelsen.

Klassen ToolTipTitle implementerar System.ComponentModel.IExtenderProvider gränssnittet, som har en enda metod, CanExtend. Knappbeskrivningar utökar kontrollerna i samma formulär vid designtillfället och lägger till en ToolTip egenskap. Mer information om förlängarprovidrar finns i Extender Providers(Utökarproviders).

Se även

• ToolTipIcon
• HelpProvider
• Förlängarproviders
• ToolTip Component (Windows Forms)