ToolTip Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Představuje malé obdélníkové automaticky otevírané okno, které zobrazuje stručný popis účelu ovládacího prvku, když uživatel umístí ukazatel myši na ovládací prvek.

public ref 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 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 .

Poznámka

U ovládacích prvků, které jsou zakázané, se nezobrazuje text popisu. ShowAlways Pokud není vlastnost nastavená na true, popisy tlačítek se nezobrazí, když je kontejner neaktivní.

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

Kategorie	Přidružení členové
Ruční zobrazení	Active, Show, Hide, ShowAlways, Popup, StopTimer
Časování popisků	AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimer
Content	SetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAll
Vzhled	BackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFading

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

ToolTip()	Inicializuje novou instanci objektu ToolTip bez zadaného kontejneru.
ToolTip(IContainer)	Inicializuje novou instanci ToolTip třídy se zadaným kontejnerem.

Vlastnosti

Active	Získá nebo nastaví hodnotu označující, zda popis je aktuálně aktivní.
AutomaticDelay	Získá nebo nastaví automatické zpoždění popisu.
AutoPopDelay	Získá nebo nastaví časové období Popis zůstane viditelný, pokud je ukazatel na ovládacím prvku se zadaným textem popisu.
BackColor	Získá nebo nastaví barvu pozadí popisku.
CanRaiseEvents	Získá hodnotu označující, zda komponenta může vyvolat událost. (Zděděno od Component)
Container	Získá objekt IContainer , který obsahuje Component. (Zděděno od Component)
CreateParams	Získá parametry vytváření pro okno Popis.
DesignMode	Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component)
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
ForeColor	Získá nebo nastaví barvu popředí pro popis.
InitialDelay	Získá nebo nastaví čas, který uplyne před zobrazením popisku.
IsBalloon	Získá nebo nastaví hodnotu označující, zda má popis použít okno bubliny.
OwnerDraw	Získá nebo nastaví hodnotu označující, zda popis je vykreslen operačním systémem nebo kódem, který zadáte.
ReshowDelay	Získá nebo nastaví dobu, po kterou se musí provést, než se zobrazí následující okna popisu, když ukazatel přejde z jednoho ovládacího prvku do jiného.
ShowAlways	Získá nebo nastaví hodnotu označující, zda se zobrazí okno Popis, i když jeho nadřazený ovládací prvek není aktivní.
Site	Získá nebo nastaví ISite hodnotu Component. (Zděděno od Component)
StripAmpersands	Získá nebo nastaví hodnotu, která určuje, jak ampersand (&) znaky jsou zpracovány.
Tag	Získá nebo nastaví objekt, který obsahuje programátorem zadaná data přidružená k ToolTip.
ToolTipIcon	Získá nebo nastaví hodnotu, která definuje typ ikony, která má být zobrazena spolu s textem Popis.
ToolTipTitle	Získá nebo nastaví název pro okno Popis.
UseAnimation	Získá nebo nastaví hodnotu určující, zda se má použít animační efekt při zobrazení popisu.
UseFading	Získá nebo nastaví hodnotu určující, zda se má při zobrazení popisku použít efekt prolnutí.

Metody

CanExtend(Object)	Vrátí true , pokud tooltip může nabídnout rozšiřující vlastnost určené cílové komponenty.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Uvolní nespravované prostředky používané Component nástrojem a volitelně uvolní spravované prostředky.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
Finalize()	Uvolní nespravované prostředky a provede další operace čištění před Cursor uvolněním paměti uvolňováním paměti.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jejím Containerobjektem . (Zděděno od Component)
GetToolTip(Control)	Načte text popisku přidruženého k zadanému ovládacímu prvku.
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
Hide(IWin32Window)	Skryje zadané okno popisku.
InitializeLifetimeService()	Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
RemoveAll()	Odebere veškerý text popisu, který je aktuálně přidružený k komponentě Popis.
SetToolTip(Control, String)	Přidruží text popisku k zadanému ovládacímu prvku.
Show(String, IWin32Window)	Nastaví text popisu přidruženého k zadanému ovládacímu prvku a zobrazí popis modálně.
Show(String, IWin32Window, Int32)	Nastaví text popisu přidruženého k zadanému ovládacímu prvku a potom zobrazí popis po zadanou dobu trvání.
Show(String, IWin32Window, Int32, Int32)	Nastaví text popisku přidružený k zadanému ovládacímu prvku a pak zobrazí popis modálně na zadané relativní pozici.
Show(String, IWin32Window, Int32, Int32, Int32)	Nastaví text popisu přidruženého k zadanému ovládacímu prvku a potom zobrazí popis po zadanou dobu na zadané relativní pozici.
Show(String, IWin32Window, Point)	Nastaví text popisku přidružený k zadanému ovládacímu prvku a pak zobrazí popis modálně na zadané relativní pozici.
Show(String, IWin32Window, Point, Int32)	Nastaví text popisu přidruženého k zadanému ovládacímu prvku a potom zobrazí popis po zadanou dobu na zadané relativní pozici.
StopTimer()	Zastaví časovač, který skryje zobrazené popisy.
ToString()	Vrátí řetězcovou reprezentaci pro tento ovládací prvek.

Událost

Disposed	Nastane, když je komponenta odstraněna voláním Dispose() metody. (Zděděno od Component)
Draw	Nastane, když je popis nakreslen a OwnerDraw vlastnost je nastavena na true a IsBalloon vlastnost je false.
Popup	Nastane před počátečním zobrazením popisu. Toto je výchozí událost pro ToolTip třídu.

Viz také

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