ToolTip Класс

Определение

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

Наследование

Object

MarshalByRefObject

Component

ToolTip

Реализации

IExtenderProvider

Примеры

В следующем примере кода создается экземпляр ToolTip класса и он связывается с экземпляром Form , в рамках этого экземпляра создается. Затем код инициализирует свойства AutoPopDelayзадержки , InitialDelayи ReshowDelay. Кроме того, экземпляр класса задает свойству ToolTipShowAlways значение , true чтобы разрешить всегда отображать текст подсказки независимо от того, активна ли форма. Наконец, в примере текст подсказки связывается с двумя элементами управления в форме: Button и CheckBox. В примере кода требуется, чтобы метод, определенный в примере, находился в Form объекте , который содержит Button элемент управления с именем button1 и CheckBox элемент управления с именем checkBox1, а метод вызывается из конструктора 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

Комментарии

ToolTip С помощью класса можно предоставлять пользователю подсказки, когда пользователь помещает указатель на элемент управления. Класс ToolTip обычно используется для оповещения пользователей о предполагаемом использовании элемента управления. Например, можно указать текст подсказки для TextBox элемента управления, принимающего имя, указав формат имени, которое будет введено в элемент управления . Помимо указания, вы также можете использовать класс для предоставления сведений ToolTip о состоянии времени выполнения. Например, класс можно использовать для ToolTip отображения данных о скорости подключения и качестве линий при перемещении указателя на элемент управления, отображающий состояние подключения к Интернету PictureBox .

Класс ToolTip можно использовать в любом контейнере. Чтобы явно указать контейнер, используйте ToolTip(IContainer) конструктор . Один ToolTip компонент обычно используется для создания подсказок для нескольких элементов управления в одной форме. После создания используйте отдельный вызов метода , чтобы SetToolTip связать отображаемый ToolTipтекст подсказки с отдельным элементом управления. Затем, когда пользователь перемещает указатель на элемент управления, отображается подсказка с текстом. Для одного и того же элемента управления можно вызвать SetToolTip несколько раз, чтобы изменить текст, связанный с элементом управления. Чтобы получить текст, связанный с элементом управления, используйте GetToolTip метод . Чтобы удалить все текстовые связи подсказки с экземпляром ToolTip класса , используйте RemoveAll метод .

Класс ToolTip предоставляет следующие свойства и методы для изменения поведения и внешнего вида подсказки по умолчанию.

Если вы хотите отключить весь текст подсказки, чтобы он не отображался в приложении, можно использовать Active свойство . Обычно подсказка рисуется операционной системой, но чтобы настроить внешний ToolTipвид , можно задать свойству OwnerDrawtrue значение и обработать Draw событие.

Класс ToolTipTitle реализует System.ComponentModel.IExtenderProvider интерфейс , который имеет один метод , CanExtend. Подсказки расширяют элементы управления в той же форме во время разработки, добавляя ToolTip свойство . Дополнительные сведения о поставщиках расширителя см. в разделе Поставщики расширителя.

Конструкторы

Свойства

Методы

События

Применяется к

См. также раздел

• ToolTipIcon
• HelpProvider
• Поставщики расширителей
• Компонент ToolTip (Windows Forms)