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 przeznaczenia 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 ShowAlways właściwość w celu true umożliwienia wyświetlania 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ład kodu wymaga, aby metoda zdefiniowana w przykładzie znajdowała się w obiekcie zawierającym kontrolkę Button o nazwie i kontrolce CheckBox o nazwie button1checkBox1, a metoda jest wywoływana z konstruktora Form.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. Na przykład można użyć ToolTip klasy do wyświetlania danych dotyczących szybkości połączenia i jakości linii, gdy użytkownik przenosi wskaźnik do PictureBox kontrolki, która wyświetla stan połączenia internetowego.

Klasa ToolTip może być używana w dowolnym kontenerze. Aby jawnie określić kontener, użyj konstruktora ToolTip(IContainer) . Pojedynczy ToolTip składnik jest zwykle używany do tworzenia etykietek narzędzi dla wielu kontrolek w jednym formularzu. Po utworzeniu ToolTipelementu użyj oddzielnego wywołania metody , SetToolTip aby skojarzyć tekst wyświetlania etykietki narzędzia z pojedynczą kontrolką. Następnie, gdy użytkownik przenosi wskaźnik na kontrolce, zostanie wyświetlona etykietka narzędzia z jego 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 aby dostosować wygląd ToolTipelementu , można ustawić OwnerDraw właściwość na true i obsłużyć Draw zdarzenie.

Klasa ToolTipTitle implementuje interfejs, który ma jedną metodę System.ComponentModel.IExtenderProviderCanExtend. 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 kontenera ToolTip 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 etykietki narzędzia.
AutoPopDelay	Pobiera lub ustawia czas, przez który etykietka narzędzia pozostaje widoczna, 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 dla 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 przechodzi przed wyświetleniem etykietki narzędzia.
IsBalloon	Pobiera lub ustawia wartość wskazującą, czy etykietka narzędzia powinna używać okna balonu.
OwnerDraw	Pobiera lub ustawia wartość wskazującą, czy etykietka narzędzia jest rysowana przez system operacyjny, czy za pomocą podanego kodu.
ReshowDelay	Pobiera lub ustawia czas, który musi się pojawić przed kolejnymi oknami etykietki 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 kontrolka nadrzędna nie jest aktywna.
Site	Pobiera lub ustawia ISite element .Component (Odziedziczone po Component)
StripAmpersands	Pobiera lub ustawia wartość określającą, 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ść definiującą typ ikony do wyświetlenia obok tekstu etykietki 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 oferować 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śmieceń 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 reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetToolTip(Control)	Pobiera tekst etykietki narzędzia skojarzony z określoną kontrolką.
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
Hide(IWin32Window)	Ukrywa określone okno Etykietka narzędzia.
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady 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, który jest obecnie skojarzony 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 IsBalloon na true , a właściwość to false.
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)