ToolTip Třída

Definice

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

Dědičnost

Object

MarshalByRefObject

Component

ToolTip

Implementuje

IExtenderProvider

Příklady

Následující příklad kódu vytvoří instanci ToolTip třídy a přidruží instanci k Form instanci, ve které je instance vytvořena. Kód pak inicializuje vlastnosti AutoPopDelayzpoždění , InitialDelaya ReshowDelay. Kromě toho instance ToolTip třídy nastaví ShowAlways vlastnost na true , aby se text popisku vždy zobrazoval bez ohledu na to, zda je formulář aktivní. Nakonec příklad přidruží text popisu ke dvěma ovládacím prvkům ve formuláři, Button a .CheckBox Příklad kódu vyžaduje, aby se metoda definovaná v příkladu nacházela v objektu FormButton , který obsahuje ovládací prvek s názvem button1 a CheckBox ovládací prvek s názvem checkBox1a aby byla metoda volána z konstruktoru objektu 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

Poznámky

ToolTip Pomocí třídy můžete uživateli poskytnout rady, když uživatel umístí ukazatel myši na ovládací prvek. Třída se ToolTip obvykle používá k upozornění uživatelů na zamýšlené použití ovládacího prvku. Můžete například zadat text popisu pro TextBox ovládací prvek, který přijímá název, a určit formát názvu, který se má zadat do ovládacího prvku. Kromě poskytování nápovědy můžete třídu použít ToolTip také k poskytování informací o stavu běhu. Třídu můžete například použít ToolTip k zobrazení dat o rychlosti připojení a kvalitě řádku, když uživatel přesune ukazatel na PictureBox ovládací prvek, který zobrazuje stav připojení k internetu.

Třídu ToolTip lze použít v libovolném kontejneru. Pokud chcete explicitně zadat kontejner, použijte ToolTip(IContainer) konstruktor. Jedna ToolTip komponenta se obvykle používá k vytvoření popisů pro více ovládacích prvků v jednom formuláři. Po vytvoření ToolTipmetody použijte samostatné volání metody a SetToolTip přidružte zobrazovaný text tooltipu k jednotlivým ovládacím prvkům. Když pak uživatel přesune ukazatel na ovládací prvek, zobrazí se popis s jeho textem. Pro stejný ovládací prvek můžete volat SetToolTip více než jednou a změnit tak text, který je k ovládacího prvku přidružený. Pokud chcete získat text přidružený k ovládacímu prvku, použijte metodu GetToolTip . Pokud chcete odebrat všechna přidružení textu tooltipu ToolTip k instanci třídy, použijte metodu RemoveAll .

Třída ToolTip poskytuje následující vlastnosti a metody pro úpravu výchozího chování a vzhledu popisku.

Pokud chcete zakázat veškerý text popisu, aby ho nebylo možné zobrazit v aplikaci, můžete použít Active vlastnost . Obvykle je popis nakreslen operačním systémem, ale chcete-li přizpůsobit vzhled objektu ToolTip, můžete nastavit OwnerDraw vlastnost na true a zpracovat Draw událost.

Třída ToolTipTitle implementuje System.ComponentModel.IExtenderProvider rozhraní, které má jednu metodu, CanExtend. Popisy rozšiřují ovládací prvky ve stejném formuláři v době návrhu ToolTip a přidávají vlastnost. Další informace o poskytovateli extenderů najdete v tématu Poskytovatelé extenderů.

Konstruktory

Vlastnosti

Metody

Událost

Platí pro

Viz také

• ToolTipIcon
• HelpProvider
• Zprostředkovatelé rozšíření
• ToolTip – komponenta (Windows Forms)