ToolTip Třída

Definice

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

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
Implementuje

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 bylo možné text popisku vždy zobrazit bez ohledu na to, zda je formulář aktivní. Nakonec tento 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 metoda definovaná v příkladu byla umístěna 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 nápovědu, když uživatel umístí ukazatel 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ý má být zadán 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 za běhu. Můžete například použít ToolTip třídu k zobrazení dat o rychlosti připojení a kvalitě linky, 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í objektu ToolTippoužijte samostatné volání metody , které SetToolTip přidruží zobrazovaný text popisku k jednotlivému ovládacímu prvku. 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 popisku ToolTip k instanci třídy, použijte metodu RemoveAll .

Poznámka

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

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

Kategorie Přidružení členové
Ruční zobrazení Active, Show, Hide, ShowAlways, Popup, StopTimer
Časování popisku 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é v aplikaci zobrazit, 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á jedinou metodu , CanExtend. Popisy tlačítek 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 rozšíření najdete v tématu Poskytovatelé rozšíření.

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í popisku.

AutoPopDelay

Získá nebo nastaví dobu 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 tooltip okno.

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í popisku.

InitialDelay

Získá nebo nastaví čas, který uplyne před zobrazením popisu.

IsBalloon

Získá nebo nastaví hodnotu označující, zda popis má používat 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, která se musí provést, než se zobrazí následující okna popisu při ukazateli přesunu z jednoho ovládacího prvku do jiného.

ShowAlways

Získá nebo nastaví hodnotu označující, zda je zobrazena okno popisu, i když jeho nadřazený ovládací prvek není aktivní.

Site

Získá nebo nastaví ISite z 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 objektu ToolTip.

ToolTipIcon

Získá nebo nastaví hodnotu, která definuje typ ikony, která má být zobrazena spolu s textem Popis tlačítka.

ToolTipTitle

Získá nebo nastaví název pro popis okna.

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 popisek může nabídnout rozšiřující vlastnost zadané cílové součásti.

CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící 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é nástrojem Component a volitelně uvolní spravované prostředky.

Dispose(Boolean)

Uvolní nespravované prostředky používané nástrojem Component a volitelně uvolní spravované prostředky.

(Zděděno od Component)
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()
Zastaralé.

Načte aktuální životnost objektu služby, 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 .Container

(Zděděno od Component)
GetToolTip(Control)

Načte text popisu tlačítka přidružený k zadanému ovládacímu prvku.

GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
Hide(IWin32Window)

Skryje zadané okno popisu.

InitializeLifetimeService()
Zastaralé.

Získá životnost objektu služby, 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 tlačítka.

SetToolTip(Control, String)

Přidruží text popisu k zadanému ovládacímu prvku.

Show(String, IWin32Window)

Nastaví text popisu tlačítka přidružený k zadanému ovládacímu prvku a modálně zobrazí popis.

Show(String, IWin32Window, Int32)

Nastaví text popisu tlačítka přidružený k zadanému ovládacímu prvku a potom zobrazí popis na zadanou dobu trvání.

Show(String, IWin32Window, Int32, Int32)

Nastaví text popisu tlačítka přidružený k zadanému ovládacímu prvku a poté zobrazí popis tlačítka modálně na zadané relativní pozici.

Show(String, IWin32Window, Int32, Int32, Int32)

Nastaví text popisu tlačítka přidružený k zadanému ovládacímu prvku a potom zobrazí popis na zadanou dobu trvání na zadané relativní pozici.

Show(String, IWin32Window, Point)

Nastaví text popisu tlačítka přidružený k zadanému ovládacímu prvku a poté zobrazí popis tlačítka modálně na zadané relativní pozici.

Show(String, IWin32Window, Point, Int32)

Nastaví text popisu tlačítka přidružený k zadanému ovládacímu prvku a potom zobrazí popis na zadanou dobu trvání na zadané relativní pozici.

StopTimer()

Zastaví časovač, který skryje zobrazené popisy tlačítek.

ToString()

Vrátí řetězcovou reprezentaci pro tento ovládací prvek.

Událost

Disposed

Vyvolá se, když je komponenta uvolněna voláním Dispose() metody .

(Zděděno od Component)
Draw

Vyvolá se, 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 .

Platí pro

Viz také