Udostępnij za pośrednictwem


ToolTip Klasa

Definicja

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 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
Dziedziczenie
Implementuje

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.

Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane.

(Odziedziczone po Component)
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()
Przestarzałe.

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()
Przestarzałe.

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.

Dotyczy

Zobacz też