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
Наследование
Реализации

Примеры

В следующем примере кода создается экземпляр ToolTip класса и связывается экземпляр с Form созданным экземпляром. Затем код инициализирует свойства AutoPopDelayInitialDelayзадержки и ReshowDelay. Кроме того, экземпляр ToolTip класса задает ShowAlways свойство для true включения отображения текста подсказки всегда независимо от того, активна ли форма. Наконец, в примере текст подсказки связывается с двумя элементами управления в форме, а Button и т. д CheckBox. В примере кода требуется, чтобы метод, определенный в примере, находился в элементеForm, содержащем Button элементе управления с именем button1 и именованном checkBox1CheckBox элементе управления, и что метод вызывается из конструктора 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 компонент обычно используется для создания подсказок для нескольких элементов управления в одной форме. После создания ToolTipиспользуйте отдельный вызов SetToolTip метода, чтобы связать отображаемый текст подсказки с отдельным элементом управления. Затем, когда пользователь перемещает указатель на элемент управления, отображается подсказка с текстом. Чтобы изменить текст, связанный с элементом управления, можно вызвать SetToolTip несколько раз для одного элемента управления. Чтобы получить текст, связанный с элементом управления, используйте GetToolTip метод. Чтобы удалить все связи текста подсказки с экземпляром ToolTip класса, используйте RemoveAll метод.

Примечание

Текст подсказки не отображается для элементов управления, которые отключены. Если ShowAlways свойство не задано true, всплывающие подсказки не отображаются, если контейнер неактивен.

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

Категория Связанные члены
Отображение вручную Active, Show, Hide, ShowAlways, Popup, StopTimer
Время подсказки AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimer
Content SetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAll
Внешний вид BackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFading

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

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

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

ToolTip()

Инициализирует новый экземпляр класса ToolTip без указания контейнера.

ToolTip(IContainer)

Инициализирует новый экземпляр класса ToolTip, используя заданный контейнер.

Свойства

Active

Возвращает или задает значение, указывающее, активна ли в настоящий момент всплывающая подсказка.

AutomaticDelay

Возвращает или задает автоматическую задержку всплывающей подсказки.

AutoPopDelay

Возвращает или задает интервал времени, в течение которого всплывающая подсказка отображается на экране, когда указатель мыши останавливается в границах элемента управления с текстом данной подсказки.

BackColor

Возвращает или задает цвет фона для всплывающей подсказки.

CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.

(Унаследовано от Component)
Container

Возвращает объект IContainer, который содержит коллекцию Component.

(Унаследовано от Component)
CreateParams

Возвращает параметры создания для окна всплывающей подсказки.

DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.

(Унаследовано от Component)
Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.

(Унаследовано от Component)
ForeColor

Возвращает или задает цвет для всплывающей подсказки.

InitialDelay

Возвращает или задает интервал времени перед появлением всплывающей подсказки.

IsBalloon

Возвращает или задает значение, указывающее, должна ли всплывающая подсказка использовать всплывающее окно.

OwnerDraw

Возвращает или задает значение, указывающее, выводится ли всплывающая подсказка операционной системой или кодом разработчика.

ReshowDelay

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

ShowAlways

Возвращает или задает значение, указывающее, отображается ли окно всплывающей подсказки, если родительский элемент управления не активен.

Site

Получает или задает ISite объекта Component.

(Унаследовано от Component)
StripAmpersands

Возвращает или задает значение, определяющее способ обработки знаков амперсанда (&).

Tag

Получает или задает объект, содержащий предоставленные программистом данные, связанные с объектом ToolTip.

ToolTipIcon

Возвращает или задает значение, определяющее тип значка, отображаемого вместе с текстом всплывающей подсказки.

ToolTipTitle

Возвращает или задает заголовок окна всплывающей подсказки.

UseAnimation

Возвращает или задает значение, определяющее, должен ли при отображении всплывающей подсказки использоваться эффект анимации.

UseFading

Возвращает или задает значение, определяющее, должен ли при отображении всплывающей подсказки использоваться эффект затухания.

Методы

CanExtend(Object)

Возвращает значение true, если всплывающая подсказка может предложить свойство средства расширения для заданного целевого компонента.

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.

(Унаследовано от MarshalByRefObject)
Dispose()

Освобождает все ресурсы, занятые модулем Component.

(Унаследовано от Component)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы.

Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы.

(Унаследовано от Component)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
Finalize()

Освобождает неуправляемые ресурсы и выполняет другие операции очистки перед утилизацией объекта Cursor во время сборки мусора.

GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetLifetimeService()
Является устаревшей.

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.

(Унаследовано от MarshalByRefObject)
GetService(Type)

Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container.

(Унаследовано от Component)
GetToolTip(Control)

Извлекает текст всплывающей подсказки, связанный с указанным элементом управления.

GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
Hide(IWin32Window)

Скрывает заданное окно всплывающей подсказки.

InitializeLifetimeService()
Является устаревшей.

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.

(Унаследовано от MarshalByRefObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.

(Унаследовано от MarshalByRefObject)
RemoveAll()

Удаляет весь текст всплывающей подсказки, связанной с компонентом ToolTip.

SetToolTip(Control, String)

Связывает текст всплывающей подсказки с указанным элементом управления.

Show(String, IWin32Window)

Задает текст всплывающей подсказки, связанный с указанным элементом управления, и отображает всплывающую подсказку в модальном режиме.

Show(String, IWin32Window, Int32)

Задает текст всплывающей подсказки, связанный с указанным элементом управления, а затем отображает всплывающую подсказку в течение заданного времени.

Show(String, IWin32Window, Int32, Int32)

Задает текст всплывающей подсказки, связанной с указанным элементом управления, а затем отображает всплывающую подсказку в модальном режиме в заданной относительной позиции.

Show(String, IWin32Window, Int32, Int32, Int32)

Задает текст всплывающей подсказки, связанной с указанным элементом управления, а затем отображает всплывающую подсказку в течение указанного времени в заданной относительной позиции.

Show(String, IWin32Window, Point)

Задает текст всплывающей подсказки, связанной с указанным элементом управления, а затем отображает всплывающую подсказку в модальном режиме в заданной относительной позиции.

Show(String, IWin32Window, Point, Int32)

Задает текст всплывающей подсказки, связанной с указанным элементом управления, а затем отображает всплывающую подсказку в течение указанного времени в заданной относительной позиции.

StopTimer()

Останавливает таймер, скрывающий отображенные всплывающие подсказки.

ToString()

Возвращает строковое представление для этого элемента управления.

События

Disposed

Возникает при удалении компонента путем вызова метода Dispose().

(Унаследовано от Component)
Draw

Происходит при отображении всплывающей подсказки, если для свойства OwnerDraw установлено значение true, а для свойства IsBalloon — значение false.

Popup

Происходит перед первоначальным отображением всплывающей подсказки. Это событие по умолчанию для класса ToolTip.

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

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