ToolTip Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 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 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 button1
checkBox1
, 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ść |
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śmiecanie 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, 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() |
Przestarzałe.
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 |
Popup |
Występuje przed początkowym wyświetleniem etykietki narzędzia. Jest to domyślne zdarzenie dla ToolTip klasy. |
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla