ToolTip Klasa

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Reprezentuje małe prostokątne okno podręczne, które wyświetla krótki opis celu kontrolki, gdy użytkownik spoczywa wskaźnik na kontrolce.

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

Dziedziczenie

Object

MarshalByRefObject

Component

ToolTip

Implementuje

IExtenderProvider

Przykłady

Poniższy przykład kodu tworzy wystąpienie ToolTip klasy i kojarzy wystąpienie z Form wystąpieniem, w ramach którego jest tworzone wystąpienie. Następnie kod inicjuje właściwości AutoPopDelayopóźnienia , InitialDelayi ReshowDelay. Ponadto wystąpienie ToolTip klasy ustawia właściwość , ShowAlways aby true umożliwić wyświetlanie tekstu etykietki narzędzia, niezależnie od tego, czy formularz jest aktywny. Na koniec przykład kojarzy tekst etykietki narzędzia z dwoma kontrolkami w formularzu, a Button i CheckBox. Przykładowy kod wymaga, aby metoda zdefiniowana w przykładzie znajdowała się w obiekcie Form zawierającym kontrolkę CheckBoxButton o nazwie i kontrolce o nazwie button1checkBox1, a metoda jest wywoływana z konstruktora 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

Uwagi

ToolTip Dzięki klasie można podać wskazówki dla użytkownika, gdy użytkownik umieszcza wskaźnik w kontrolce. Klasa ToolTip jest zwykle używana do powiadamiania użytkowników o zamierzonym użyciu kontrolki. Można na przykład określić tekst etykietki narzędzia dla TextBox kontrolki, która akceptuje nazwę, określając format nazwy, która ma zostać wpisana do kontrolki. Oprócz podawania wskazówek można również użyć ToolTip klasy , aby podać informacje o stanie czasu wykonywania. Można na przykład użyć ToolTip klasy , aby wyświetlić dane dotyczące szybkości połączenia i jakości linii, gdy użytkownik przenosi wskaźnik na kontrolkę PictureBox wyświetlający stan połączenia internetowego.

Klasa ToolTip może być używana w dowolnym kontenerze. Aby jawnie określić kontener, użyj konstruktora ToolTip(IContainer) . ToolTip Pojedynczy składnik jest zwykle używany do tworzenia etykietek narzędzi dla wielu kontrolek w jednym formularzu. Po utworzeniu ToolTipelementu należy użyć oddzielnego wywołania metody w SetToolTip celu skojarzenia tekstu wyświetlanego etykietki narzędzia z pojedynczą kontrolką. Następnie, gdy użytkownik przenosi wskaźnik w kontrolce, zostanie wyświetlona etykietka narzędzia z tekstem. Możesz wywołać SetToolTip więcej niż raz dla tej samej kontrolki, aby zmienić tekst skojarzony z kontrolką. Aby uzyskać tekst skojarzony z kontrolką, użyj GetToolTip metody . Aby usunąć wszystkie skojarzenia tekstu etykietki narzędzia z wystąpieniem ToolTip klasy, użyj RemoveAll metody .

Uwaga

Tekst etykietki narzędzia nie jest wyświetlany dla kontrolek, które są wyłączone. Jeśli właściwość nie jest ustawiona ShowAlways na true, etykietki narzędzi nie są wyświetlane, gdy ich kontener jest nieaktywny.

Klasa ToolTip udostępnia następujące właściwości i metody modyfikowania domyślnego zachowania i wyglądu etykietki narzędzia.

Kategoria	Skojarzone elementy członkowskie
Wyświetlanie ręczne	Active, Show, Hide, ShowAlways, Popup, StopTimer
Czas etykietki narzędzia	AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimer
Zawartość	SetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAll
Wygląd	BackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFading

Jeśli chcesz wyłączyć cały tekst etykietki narzędzia, aby nie można było go wyświetlić w aplikacji, możesz użyć Active właściwości . Zazwyczaj etykietka narzędzia jest rysowana przez system operacyjny, ale w celu dostosowania wyglądu ToolTipelementu można ustawić OwnerDraw właściwość na true i obsłużyć Draw zdarzenie.

Klasa ToolTipTitle implementuje System.ComponentModel.IExtenderProvider interfejs, który ma jedną metodę . CanExtend Etykietki narzędzi rozszerzają kontrolki na tym samym formularzu w czasie projektowania, dodając ToolTip właściwość. Aby uzyskać więcej informacji na temat dostawców rozszerzenia, zobacz Dostawcy rozszerzenia.

Konstruktory

ToolTip()	Inicjuje nowe wystąpienie ToolTip obiektu bez określonego kontenera.
ToolTip(IContainer)	Inicjuje ToolTip nowe wystąpienie klasy z określonym kontenerem.

Właściwości

Active	Pobiera lub ustawia wartość wskazującą, czy etykietka narzędzia jest obecnie aktywna.
AutomaticDelay	Pobiera lub ustawia automatyczne opóźnienie dla etykietki narzędzia.
AutoPopDelay	Pobiera lub ustawia okres czasu etykietki narzędzia pozostaje widoczny, jeśli wskaźnik jest nieruchomy w kontrolce z określonym tekstem etykietki narzędzia.
BackColor	Pobiera lub ustawia kolor tła etykietki narzędzia.
CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
CreateParams	Pobiera parametry tworzenia okna Etykietka narzędzia.
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
ForeColor	Pobiera lub ustawia kolor pierwszego planu dla etykietki narzędzia.
InitialDelay	Pobiera lub ustawia czas, który upływa przed wyświetleniem etykietki narzędzia.
IsBalloon	Pobiera lub ustawia wartość wskazującą, czy etykietka narzędzia powinna używać okna dymku.
OwnerDraw	Pobiera lub ustawia wartość wskazującą, czy etykietka narzędzia jest rysowana przez system operacyjny, czy przez kod, który podajesz.
ReshowDelay	Pobiera lub ustawia czas, który musi wystąpić przed wyświetleniem kolejnych okien Etykietka narzędzia, gdy wskaźnik przechodzi z jednej kontrolki do innej.
ShowAlways	Pobiera lub ustawia wartość wskazującą, czy jest wyświetlane okno Etykietka narzędzia, nawet jeśli jego kontrolka nadrzędna nie jest aktywna.
Site	Pobiera lub ustawia wartość ISite .Component (Odziedziczone po Component)
StripAmpersands	Pobiera lub ustawia wartość, która określa, jak są traktowane znaki ampersand (&).
Tag	Pobiera lub ustawia obiekt zawierający dane dostarczone przez programistę skojarzone z obiektem ToolTip.
ToolTipIcon	Pobiera lub ustawia wartość, która definiuje typ ikony do wyświetlenia obok tekstu Etykietka narzędzia.
ToolTipTitle	Pobiera lub ustawia tytuł okna Etykietka narzędzia.
UseAnimation	Pobiera lub ustawia wartość określającą, czy podczas wyświetlania etykietki narzędzia ma być używany efekt animacji.
UseFading	Pobiera lub ustawia wartość określającą, czy podczas wyświetlania etykietki narzędzia ma być używany efekt zanikania.

Metody

CanExtend(Object)	Zwraca wartość true , jeśli etykietka narzędzia może zaoferować właściwość rozszerzenia do określonego składnika docelowego.
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Finalize()	Zwalnia niezarządzane zasoby i wykonuje inne operacje oczyszczania przed Cursor odzyskaniem przez moduł odśmiecanie pamięci.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetService(Type)	Zwraca obiekt, który reprezentuje usługę dostarczaną przez Component obiekt lub przez element Container. (Odziedziczone po Component)
GetToolTip(Control)	Pobiera tekst etykietki narzędzia skojarzony z określoną kontrolką.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
Hide(IWin32Window)	Ukrywa określone okno Etykietka narzędzia.
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
RemoveAll()	Usuwa cały tekst etykietki narzędzia skojarzony obecnie ze składnikiem ToolTip.
SetToolTip(Control, String)	Kojarzy tekst etykietki narzędzia z określoną kontrolką.
Show(String, IWin32Window)	Ustawia tekst etykietki narzędzia skojarzony z określoną kontrolką i wyświetla etykietkę narzędzia modalnie.
Show(String, IWin32Window, Int32)	Ustawia tekst etykietki narzędzia skojarzony z określoną kontrolką, a następnie wyświetla etykietkę narzędzia dla określonego czasu trwania.
Show(String, IWin32Window, Int32, Int32)	Ustawia tekst etykietki narzędzia skojarzony z określoną kontrolką, a następnie wyświetla etykietkę narzędzia modalnie w określonej pozycji względnej.
Show(String, IWin32Window, Int32, Int32, Int32)	Ustawia tekst etykietki narzędzia skojarzony z określoną kontrolką, a następnie wyświetla etykietkę narzędzia dla określonego czasu trwania w określonej pozycji względnej.
Show(String, IWin32Window, Point)	Ustawia tekst etykietki narzędzia skojarzony z określoną kontrolką, a następnie wyświetla etykietkę narzędzia modalnie w określonej pozycji względnej.
Show(String, IWin32Window, Point, Int32)	Ustawia tekst etykietki narzędzia skojarzony z określoną kontrolką, a następnie wyświetla etykietkę narzędzia dla określonego czasu trwania w określonej pozycji względnej.
StopTimer()	Zatrzymuje czasomierz, który ukrywa wyświetlane etykietki narzędzi.
ToString()	Zwraca reprezentację ciągu dla tej kontrolki.

Zdarzenia

Disposed	Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)
Draw	Występuje, gdy etykietka narzędzia jest rysowana, a OwnerDraw właściwość jest ustawiona na true , a IsBalloon właściwość ma falsewartość .
Popup	Występuje przed początkowym wyświetleniem etykietki narzędzia. Jest to domyślne zdarzenie dla ToolTip klasy.

Zobacz też

• ToolTipIcon
• HelpProvider
• Dostawcy rozszerzeń
• ToolTip — Składnik (Formularze systemu Windows)