Как установить всплывающую подсказку в C #?

В Windows Forms всплывающая подсказка представляет собой крошечное всплывающее окно, которое появляется, когда вы помещаете указатель или курсор на элемент управления, и целью этого элемента управления является краткое описание элемента управления, представленного в форме окна. Во всплывающей подсказке вы можете проверить, активна или нет всплывающая подсказка, используя Active Property .
Значением по умолчанию для этого свойства является True. Когда для свойства Active установлено значение true, это означает, что окно всплывающей подсказки будет отображаться на экране, а когда для свойства Active установлено значение false, это означает, что поле всплывающей подсказки не появляется на экране. Вы можете установить это свойство двумя различными способами:

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

• Шаг 1: Создайте форму окна, как показано на рисунке ниже:
  Visual Studio -> Файл -> Создать -> Проект -> WindowsFormApp
  
• Шаг 2. Перетащите всплывающую подсказку из панели инструментов и поместите ее в форму. Когда вы перетаскиваете эту всплывающую подсказку на форму, она автоматически добавляет свойства (называемые всплывающей подсказкой на всплывающей подсказке) всех элементов управления, присутствующих в текущих окнах из.

Шаг 3: После перетаскивания вы перейдете к свойствам всплывающей подсказки и установите значение свойства Active.

Выход:

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

Здесь значение этого свойства имеет тип System.Boolean . Таким образом, чтобы активировать всплывающую подсказку, установите для этого свойства значение true. В противном случае, ложь. Следующие шаги показывают, как динамически установить свойство Active всплывающей подсказки:

• Шаг 1. Создание всплывающей подсказки с помощью конструктора ToolTip () предоставляется классом ToolTip.
• Шаг 2: После создания всплывающей подсказки установите свойство Active всплывающей подсказки, предоставляемой классом ToolTip.
• Шаг 3: И наконец добавьте эту подсказку к элементам управления, используя метод SetToolTip (). Этот метод содержит имя элемента управления и текст, который вы хотите отобразить в поле «Подсказка».

Windows forms всплывающая подсказка

Уроки Windows Forms C++/C#

Подсказка ToolTip в MVS C++/C#

В этом уроке мы рассмотрим, по своей сути очень маленький, но одновременно очень актуальный элемент – подсказка «TollTip». Конечно же все на раз замечали, как при наведении курсором мыши на какой-нибудь элемент интерфейса программы, появляется маленькое текстовое окошко, в котором написана какая та информация, касающаяся данного элемента. Этим же сейчас мы и займёмся. Для примера возьмём программу из предшествующего урока. Нам останется дописать буквально пару строк. Задача следующая – при наведении курсора мыши на текстовое поле, будет появляться маленькое текстовое поле, сообщающее о том, что здесь нужно ввести ваше имя. Перенесите на форму из панели инструментов два «label», один “button” и поlсказку «ToolTip». После стрелки «toolTip1->» указывается стиль подсказки – «Balloon», затем в скобках пишется элемент, возле которого должна появляться подсказки, а после запятой в кавычках пишется сам текст подсказки. Вот код реализации:

#pragma endregion private: System::Void Form1_Load(System::Object^ sender, System::EventArgs^ e) < this->Text = «Форма приветствия»; label1->Text = «Name: «; label2->Text = «Напишите ваше имя.»; button1->Text = «Ввод»; //————- реализация ToolTip toolTip1->SetToolTip(textBox1, «Введите\nваше имя»); toolTip1->IsBalloon = true; > private: System::Void button1_Click(System::Object^ sender, System::EventArgs^ e) < MessageBox::Show("Здравствуй " + textBox1->Text + «!», «Приветсвите»); > >; >

Результат: Следующий урок >>

Tool Tip. Popup Событие

Определение

Происходит перед первоначальным отображением всплывающей подсказки. Occurs before a ToolTip is initially displayed. Это событие по умолчанию для класса ToolTip. This is the default event for the ToolTip class.

Тип события

Примеры

В следующем примере кода показано использование этого элемента. The following code example demonstrates the use of this member. В этом примере обработчик событий сообщает о возникновении Popup события. In the example, an event handler reports on the occurrence of the Popup event. Этот отчет поможет вам узнать, когда происходит событие и может помочь при отладке. This report helps you to learn when the event occurs and can assist you in debugging. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рассмотрите возможность замены MessageBox.Show Console.WriteLine или добавления сообщения в многострочный TextBox . To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Чтобы выполнить пример кода, вставьте его в проект, содержащий экземпляр типа ToolTip с именем ToolTip1 . To run the example code, paste it into a project that contains an instance of type ToolTip named ToolTip1 . Затем убедитесь, что обработчик событий связан с Popup событием. Then ensure that the event handler is associated with the Popup event.

Комментарии

PopupСобытие вызывается при каждом отображении подсказки либо через явный вызов одного из Show методов, либо когда ToolTip класс неявно отображает подсказку. The Popup event is raised whenever a ToolTip is displayed, either through an explicit call to one of the Show methods or when the ToolTip class implicitly displays a ToolTip. Это событие может быть отменено. This event can be canceled.

Вызов свойств в этом событии вызывает повторное создание базового маркера окна, например IsBalloon , приведет к возникновению исключения. Calling properties in this event that cause the underlying window handle to be recreated, such as IsBalloon, will result in an exception being thrown.

Практическое руководство. Определение текста всплывающих подсказок для отдельных ячеек элемента управления DataGridView в Windows Forms How to: Add ToolTips to Individual Cells in a Windows Forms DataGridView Control

По умолчанию подсказки используются для отображения значений DataGridView ячеек, которые слишком малы для отображения всего содержимого. By default, ToolTips are used to display the values of DataGridView cells that are too small to show their entire contents. Однако это поведение можно переопределить, чтобы задать текстовые значения ToolTip для отдельных ячеек. You can override this behavior, however, to set ToolTip-text values for individual cells. Это полезно для вывода дополнительных сведений о ячейке или для предоставления пользователям альтернативного описания содержимого ячейки. This is useful to display to users additional information about a cell or to provide to users an alternate description of the cell contents. Например, если имеется строка, отображающая значки состояния, может потребоваться написать текстовые объяснения с помощью всплывающих подсказок. For example, if you have a row that displays status icons, you may want to provide text explanations using ToolTips.

Можно также отключить отображение подсказок на уровне ячейки, задав DataGridView.ShowCellToolTips для свойства значение false . You can also disable the display of cell-level ToolTips by setting the DataGridView.ShowCellToolTips property to false .

Добавление подсказки в ячейку To add a ToolTip to a cell

Компиляция кода Compiling the Code

Для этого примера требуются: This example requires:

DataGridViewЭлемент управления с именем dataGridView1 , который содержит столбец с именем Rating для отображения строковых значений из одного до четырех символов звездочки («*»). A DataGridView control named dataGridView1 that contains a column named Rating for displaying string values of one through four asterisk («*») symbols. CellFormattingСобытие элемента управления должно быть связано с методом обработчика событий, показанным в примере. The CellFormatting event of the control must be associated with the event handler method shown in the example.

Tool Tip Класс

Определение

Представляет небольшое прямоугольное всплывающее окно, в котором отображается краткое описание назначения элемента управления, когда пользователь наводит указатель мыши на элемент управления. Represents a small rectangular pop-up window that displays a brief description of a control’s purpose when the user rests the pointer on the control.

Примеры

В следующем примере кода создается экземпляр ToolTip класса и связывается с экземпляром Form , в котором создается экземпляр. The following code example creates an instance of the ToolTip class and associates the instance with the Form that the instance is created within. Затем код инициализирует свойства задержки AutoPopDelay , InitialDelay и ReshowDelay . The code then initializes the delay properties AutoPopDelay, InitialDelay, and ReshowDelay. Кроме того, экземпляр ToolTip класса задает для свойства значение ShowAlways , чтобы true Разрешить отображение текста подсказки всегда независимо от того, активна ли эта форма. In addition the instance of the ToolTip class sets the ShowAlways property to true to enable ToolTip text to always be display regardless of whether the form is active. Наконец, в примере текст подсказки связывается с двумя элементами управления в форме — Button и CheckBox . Finally, the example associates ToolTip text with two controls on a form, a Button and a CheckBox. В этом примере кода требуется, чтобы метод, определенный в примере, размещался в Form , который содержит Button элемент управления с именем button1 и CheckBox элемент управления с именем checkBox1 , а также что метод вызывается из конструктора Form . The code example requires that the method defined in the example is located within a Form that contains a Button control named button1 and a CheckBox control named checkBox1 , and that the method is called from the constructor of the Form.

Комментарии

С помощью ToolTip класса можно предоставить указания пользователю, когда пользователь помещает указатель мыши на элемент управления. With the ToolTip class, you can provide hints to a user when the user places the pointer on a control. ToolTipКласс обычно используется для оповещения пользователей о предполагаемом использовании элемента управления. The ToolTip class is typically used to alert users to the intended use of a control. Например, можно указать текст подсказки для TextBox элемента управления, который принимает имя, указав формат имени, вводимого в элемент управления. For example, you can specify ToolTip text for a TextBox control that accepts a name, specifying the format of the name to be typed into the control. Кроме указания, можно также использовать ToolTip класс для предоставления сведений о состоянии времени выполнения. In addition to providing hints, you can also use the ToolTip class to provide run time status information. Например, можно использовать ToolTip класс для отображения скорости подключения и данных качества линии, когда пользователь перемещает указатель мыши на PictureBox элемент управления, отображающий состояние подключения к Интернету. For example, you can use the ToolTip class to display connection speed and line quality data when the user moves the pointer onto a PictureBox control that displays Internet connection status.

ToolTipКласс может использоваться в любом контейнере. The ToolTip class can be used in any container. Чтобы явно указать контейнер, используйте ToolTip(IContainer) конструктор. To explicitly specify a container, use the ToolTip(IContainer) constructor. Для ToolTip создания подсказок для нескольких элементов управления в одной форме обычно используется один компонент. A single ToolTip component typically is used to create ToolTips for multiple controls on a single form. После создания ToolTip Используйте отдельный вызов SetToolTip метода, чтобы связать отображаемый текст подсказки с отдельным элементом управления. After you create a ToolTip, use a separate call to the SetToolTip method to associate ToolTip display text to an individual control. Затем, когда пользователь перемещает указатель мыши на элемент управления, отображается подсказка с текстом. Then when the user moves the pointer on a control, the ToolTip with its text is displayed. Можно вызвать SetToolTip несколько раз для одного и того же элемента управления, чтобы изменить текст, связанный с элементом управления. You can call SetToolTip more than once for the same control to change the text that is associated with the control. Чтобы получить текст, связанный с элементом управления, используйте GetToolTip метод. To get the text that is associated with a control, use the GetToolTip method. Чтобы удалить все связи текста всплывающих подсказок с экземпляром ToolTip класса, используйте RemoveAll метод. To remove all ToolTip text associations with an instance of the ToolTip class, use the RemoveAll method.

Текст подсказки не отображается для отключенных элементов управления. ToolTip text is not displayed for controls that are disabled. Если ShowAlways свойство не имеет значение true , подсказки не отображаются, если их контейнер неактивен. Unless the ShowAlways property is set to true , ToolTips are not displayed when their container is inactive.

ToolTipКласс предоставляет следующие свойства и методы для изменения поведения по умолчанию и внешнего вида всплывающей подсказки. The ToolTip class provides the following properties and methods to modify the default behavior and appearance of a ToolTip.

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

Если вы хотите отключить весь текст подсказки, чтобы он не отображался в приложении, можно использовать Active свойство. If you want to disable all ToolTip text so that it cannot be displayed in your application, you can use the Active property. Как правило, всплывающая подсказка нарисовывается операционной системой, но для настройки внешнего вида ToolTip можно задать OwnerDraw свойству значение true и выполнить обработку Draw события. Usually the ToolTip is drawn by the operating system, but to customize the appearance of the ToolTip, you can set the OwnerDraw property to true and handle the Draw event.

ToolTipTitleКласс реализует System.ComponentModel.IExtenderProvider интерфейс, который имеет один метод CanExtend . The ToolTipTitle class implements the System.ComponentModel.IExtenderProvider interface, which has a single method, CanExtend. Подсказки расширяют элементы управления в той же форме во время разработки, добавляя ToolTip свойство. ToolTips extend controls on the same form at design time, adding a ToolTip property. Дополнительные сведения о поставщиках расширений см. в разделе поставщики расширителей. For more information about extender providers, see Extender Providers.

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

Инициализирует новый экземпляр класса ToolTip без указания контейнера. Initializes a new instance of the ToolTip without a specified container.

Инициализирует новый экземпляр класса ToolTip, используя заданный контейнер. Initializes a new instance of the ToolTip class with a specified container.

Свойства

Возвращает или задает значение, указывающее, активна ли в настоящий момент всплывающая подсказка. Gets or sets a value indicating whether the ToolTip is currently active.

Возвращает или задает автоматическую задержку всплывающей подсказки. Gets or sets the automatic delay for the ToolTip.

Возвращает или задает интервал времени, в течение которого всплывающая подсказка отображается на экране, когда указатель мыши останавливается в границах элемента управления с текстом данной подсказки. Gets or sets the period of time the ToolTip remains visible if the pointer is stationary on a control with specified ToolTip text.

Возвращает или задает цвет фона для всплывающей подсказки. Gets or sets the background color for the ToolTip.

Возвращает значение, показывающее, может ли компонент вызывать событие. Gets a value indicating whether the component can raise an event.

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

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

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

Возвращает параметры создания для окна всплывающей подсказки. Gets the creation parameters for the ToolTip window.

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время. Gets a value that indicates whether the Component is currently in design mode.

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

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component. Gets the list of event handlers that are attached to this Component.

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

Возвращает или задает цвет для всплывающей подсказки. Gets or sets the foreground color for the ToolTip.

Возвращает или задает интервал времени перед появлением всплывающей подсказки. Gets or sets the time that passes before the ToolTip appears.

Возвращает или задает значение, указывающее, должна ли всплывающая подсказка использовать всплывающее окно. Gets or sets a value indicating whether the ToolTip should use a balloon window.

Возвращает или задает значение, указывающее, выводится ли всплывающая подсказка операционной системой или кодом разработчика. Gets or sets a value indicating whether the ToolTip is drawn by the operating system or by code that you provide.

Возвращает или задает интервал времени, который должен пройти перед появлением окна очередной всплывающей подсказки при перемещении указателя мыши с одного элемента управления на другой. Gets or sets the length of time that must transpire before subsequent ToolTip windows appear as the pointer moves from one control to another.

Возвращает или задает значение, указывающее, отображается ли окно всплывающей подсказки, если родительский элемент управления не активен. Gets or sets a value indicating whether a ToolTip window is displayed, even when its parent control is not active.

Получает или задает ISite объекта Component. Gets or sets the ISite of the Component.

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

Возвращает или задает значение, определяющее способ обработки знаков амперсанда (&). Gets or sets a value that determines how ampersand (&) characters are treated.

Получает или задает объект, содержащий предоставленные программистом данные, связанные с объектом ToolTip. Gets or sets the object that contains programmer-supplied data associated with the ToolTip.

Возвращает или задает значение, определяющее тип значка, отображаемого вместе с текстом всплывающей подсказки. Gets or sets a value that defines the type of icon to be displayed alongside the ToolTip text.

Возвращает или задает заголовок окна всплывающей подсказки. Gets or sets a title for the ToolTip window.

Возвращает или задает значение, определяющее, должен ли при отображении всплывающей подсказки использоваться эффект анимации. Gets or sets a value determining whether an animation effect should be used when displaying the ToolTip.

Возвращает или задает значение, определяющее, должен ли при отображении всплывающей подсказки использоваться эффект затухания. Gets or sets a value determining whether a fade effect should be used when displaying the ToolTip.

Методы

Возвращает значение true , если всплывающая подсказка может предложить свойство средства расширения для заданного целевого компонента. Returns true if the ToolTip can offer an extender property to the specified target component.

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

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

Освобождает все ресурсы, занятые модулем Component. Releases all resources used by the Component.

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

Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы. Releases the unmanaged resources used by the Component and optionally releases the managed resources.

Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы. Releases the unmanaged resources used by the Component and optionally releases the managed resources.

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

Определяет, равен ли указанный объект текущему объекту. Determines whether the specified object is equal to the current object.

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

Освобождает неуправляемые ресурсы и выполняет другие операции очистки перед утилизацией объекта Cursor во время сборки мусора. Releases the unmanaged resources and performs other cleanup operations before the Cursor is reclaimed by the garbage collector.

Служит хэш-функцией по умолчанию. Serves as the default hash function.

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

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container. Returns an object that represents a service provided by the Component or by its Container.

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

Извлекает текст всплывающей подсказки, связанный с указанным элементом управления. Retrieves the ToolTip text associated with the specified control.

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

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

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

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. Obtains a lifetime service object to control the lifetime policy for this instance.

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

Создает неполную копию текущего объекта Object. Creates a shallow copy of the current Object.

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

Создает неполную копию текущего объекта MarshalByRefObject. Creates a shallow copy of the current MarshalByRefObject object.

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

Удаляет весь текст всплывающей подсказки, связанной с компонентом ToolTip. Removes all ToolTip text currently associated with the ToolTip component.

Связывает текст всплывающей подсказки с указанным элементом управления. Associates ToolTip text with the specified control.

Задает текст всплывающей подсказки, связанный с указанным элементом управления, и отображает всплывающую подсказку в модальном режиме. Sets the ToolTip text associated with the specified control, and displays the ToolTip modally.

Задает текст всплывающей подсказки, связанный с указанным элементом управления, а затем отображает всплывающую подсказку в течение заданного времени. Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration.

Задает текст всплывающей подсказки, связанной с указанным элементом управления, а затем отображает всплывающую подсказку в модальном режиме в заданной относительной позиции. Sets the ToolTip text associated with the specified control, and then displays the ToolTip modally at the specified relative position.

Задает текст всплывающей подсказки, связанной с указанным элементом управления, а затем отображает всплывающую подсказку в течение указанного времени в заданной относительной позиции. Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration at the specified relative position.

Задает текст всплывающей подсказки, связанной с указанным элементом управления, а затем отображает всплывающую подсказку в модальном режиме в заданной относительной позиции. Sets the ToolTip text associated with the specified control, and then displays the ToolTip modally at the specified relative position.

Задает текст всплывающей подсказки, связанной с указанным элементом управления, а затем отображает всплывающую подсказку в течение указанного времени в заданной относительной позиции. Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration at the specified relative position.

Останавливает таймер, скрывающий отображенные всплывающие подсказки. Stops the timer that hides displayed ToolTips.

Возвращает строковое представление для этого элемента управления. Returns a string representation for this control.

События

Возникает при удалении компонента путем вызова метода Dispose(). Occurs when the component is disposed by a call to the Dispose() method.

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

Происходит при отображении всплывающей подсказки, если для свойства OwnerDraw установлено значение true , а для свойства IsBalloon — значение false . Occurs when the ToolTip is drawn and the OwnerDraw property is set to true and the IsBalloon property is false .

Происходит перед первоначальным отображением всплывающей подсказки. Occurs before a ToolTip is initially displayed. Это событие по умолчанию для класса ToolTip. This is the default event for the ToolTip class.