Tool Tip. 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 .
Тип события
Примеры
В следующем примере кода показано, как пользовательское рисование ToolTip . The following code example demonstrates how to custom draw the ToolTip. В примере создается объект ToolTip и связывается с тремя Button элементами управления, расположенными в Form . The example creates a ToolTip and associates it to three Button controls located on the Form. В примере свойству задается значение OwnerDraw true и обрабатывается Draw событие. The example sets the OwnerDraw property to true and handles the Draw event. В Draw обработчике событий ToolTip Пользовательский метод рисуется по-разному в зависимости от того, на какой кнопке ToolTip отображается свойство, как указано DrawToolTipEventArgs.AssociatedControl свойством. In the Draw event handler, the ToolTip is custom drawn differently, depending on what button the ToolTip is being displayed for as indicated by the DrawToolTipEventArgs.AssociatedControl property.
Комментарии
С помощью Draw события можно настроить внешний вид ToolTip . With the Draw event, you can customize the appearance of the ToolTip.
DrawСобытие вызывается ToolTip классом при ToolTip прорисовке и ToolTip.OwnerDraw значением свойства, true а IsBalloon свойство имеет значение false . The Draw event is raised by the ToolTip class when the ToolTip is drawn and the ToolTip.OwnerDraw property value is true and the IsBalloon property is false . DrawToolTipEventArgsКласс содержит все сведения, необходимые для рисования ToolTip , включая текст подсказки, Rectangle и Graphics объект, на котором должно быть выполнено рисование. The DrawToolTipEventArgs class contains all the information needed to paint the ToolTip, including the ToolTip text, the Rectangle, and the Graphics object on which the drawing should be done. Чтобы настроить внешний вид подсказки, используйте Rectangle для определения границ всплывающей подсказки и Graphics объекта для выполнения настроенного рисования. To customize the look of the ToolTip, use the Rectangle to determine the bounds of the ToolTip, and the Graphics object to perform your customized drawing. Можно увеличить границы ToolTip перед отображением, обрабатывая Popup событие. You can increase the bounds of the ToolTip before it is shown by handling the Popup event.
Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий. For more information about handling events, see Handling and Raising Events.
Tool Tip. Owner Draw Свойство
Определение
Возвращает или задает значение, указывающее, выводится ли всплывающая подсказка операционной системой или кодом разработчика. Gets or sets a value indicating whether the ToolTip is drawn by the operating system or by code that you provide.
Значение свойства
true , если подсказка ToolTip выводится кодом разработчика; и значение false , если подсказка ToolTip отображается операционной системой. true if the ToolTip is drawn by code that you provide; false if the ToolTip is drawn by the operating system. Значение по умолчанию — false . The default is false .
Примеры
В следующем примере кода показано, как владелец нарисовать ToolTip . The following code example demonstrates how to owner draw the ToolTip. В примере создается объект ToolTip и связывается с тремя Button элементами управления, расположенными в Form . The example creates a ToolTip and associates it to three Button controls located on the Form. В примере свойству задается значение OwnerDraw true и обрабатывается Draw событие. The example sets the OwnerDraw property to true and handles the Draw event. В Draw обработчике событий ToolTip Пользовательский метод рисуется по-разному в зависимости от того, на какой кнопке ToolTip отображается свойство, как указано DrawToolTipEventArgs.AssociatedControl свойством. In the Draw event handler, the ToolTip is custom drawn differently depending upon what button the ToolTip is being displayed for as indicated by the DrawToolTipEventArgs.AssociatedControl property.
Комментарии
Как правило, объект ToolTip выводится операционной системой, но для настройки внешнего вида можно ToolTip задать OwnerDraw для свойства значение true и обработано Draw событие. Usually, a 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.
IsBalloonСвойство имеет приоритет над OwnerDraw свойством. The IsBalloon property takes precedence over the OwnerDraw property. Если для обоих свойств задано значение true , то ToolTip будет отображаться с помощью всплывающего окна, а не окна, рисуемого владельцем. If both are set to true , the ToolTip will be displayed using a balloon window rather than an owner drawn window.
Tool Tip. Show Метод
Определение
Задает текст всплывающей подсказки, а затем отображает ее. Sets the text associated with a ToolTip, and then displays it.
Перегрузки
Задает текст всплывающей подсказки, связанной с указанным элементом управления, а затем отображает всплывающую подсказку в модальном режиме в заданной относительной позиции. 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 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 displays the ToolTip modally.
Задает текст всплывающей подсказки, связанный с указанным элементом управления, а затем отображает всплывающую подсказку в течение заданного времени. Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration.
Show(String, IWin32Window, Int32, Int32)
Задает текст всплывающей подсказки, связанной с указанным элементом управления, а затем отображает всплывающую подсказку в модальном режиме в заданной относительной позиции. Sets the ToolTip text associated with the specified control, and then displays the ToolTip modally at the specified relative position.
Параметры
Строка String, содержащая новый текст всплывающей подсказки. A String containing the new ToolTip text.
Элемент управления Control, для которого отображается всплывающая подсказка. The Control to display the ToolTip for.
Смещение по горизонтали в пикселях относительно верхнего левого угла окна связанного элемента управления для отображения всплывающей подсказки. The horizontal offset, in pixels, relative to the upper-left corner of the associated control window, to display the ToolTip.
Смещение по вертикали в пикселях относительно верхнего левого угла окна связанного элемента управления для отображения всплывающей подсказки. The vertical offset, in pixels, relative to the upper-left corner of the associated control window, to display the ToolTip.
Комментарии
Эта версия перегруженного Show метода работает идентично Show(String, IWin32Window, Point) версии, за исключением того, что смещение задается как отдельные координаты x и y вместо Point . This version of the overloaded Show method operates identically to the Show(String, IWin32Window, Point) version, except that the offset is specified as separate x- and y-coordinates instead of a Point.
Приложения, работающие в режиме частичного доверия, должны утверждать AllWindows разрешение на использование этого метода, а также Show управлять отображением и расположением подсказки, независимо от действия пользователя. Applications running in partial trust must assert the AllWindows permission to use this method, as Show can control the display and location of a ToolTip independent of user action.
См. также раздел
Show(String, IWin32Window, Point, Int32)
Задает текст всплывающей подсказки, связанной с указанным элементом управления, а затем отображает всплывающую подсказку в течение указанного времени в заданной относительной позиции. Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration at the specified relative position.
Параметры
Строка String, содержащая новый текст всплывающей подсказки. A String containing the new ToolTip text.
Элемент управления Control, для которого отображается всплывающая подсказка. The Control to display the ToolTip for.
Объект Point, содержащий смещение, в пикселях, относительно верхнего левого угла окна связанного элемента управления для отображения всплывающей подсказки. A Point containing the offset, in pixels, relative to the upper-left corner of the associated control window, to display the ToolTip.
Число Int32, содержащее длительность, в миллисекундах, отображения всплывающей подсказки. An Int32 containing the duration, in milliseconds, to display the ToolTip.
Исключения
Параметр window имеет значение null . The window parameter is null .
duration меньше или равно 0. duration is less than or equal to 0.
Комментарии
pt Параметр может задавать расположение вне границ связанного элемента управления, его родительской формы или даже рабочего стола. The pt parameter can specify a position outside the bounds of the associated control, its parent form, or even the desktop. Подсказка располагается в центре связанного элемента управления. The ToolTip is positioned in the center of the associated control. Чтобы отобразить подсказку в модальном виде, следует вызвать Show(String, IWin32Window, Point) перегруженную версию этого метода. To display the ToolTip modally, call the Show(String, IWin32Window, Point) overloaded version of this method instead.
Приложения, работающие в режиме частичного доверия, должны утверждать AllWindows разрешение на использование этого метода, а также Show управлять отображением и расположением подсказки, независимо от действия пользователя. Applications running in partial trust must assert the AllWindows permission to use this method, as Show can control the display and location of a ToolTip independent of user action.
См. также раздел
Show(String, IWin32Window, Int32, Int32, Int32)
Задает текст всплывающей подсказки, связанной с указанным элементом управления, а затем отображает всплывающую подсказку в течение указанного времени в заданной относительной позиции. Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration at the specified relative position.
Параметры
Строка String, содержащая новый текст всплывающей подсказки. A String containing the new ToolTip text.
Элемент управления Control, для которого отображается всплывающая подсказка. The Control to display the ToolTip for.
Смещение по горизонтали в пикселях относительно верхнего левого угла окна связанного элемента управления для отображения всплывающей подсказки. The horizontal offset, in pixels, relative to the upper-left corner of the associated control window, to display the ToolTip.
Смещение по вертикали в пикселях относительно верхнего левого угла окна связанного элемента управления для отображения всплывающей подсказки. The vertical offset, in pixels, relative to the upper-left corner of the associated control window, to display the ToolTip.
Число Int32, содержащее длительность, в миллисекундах, отображения всплывающей подсказки. An Int32 containing the duration, in milliseconds, to display the ToolTip.
Исключения
Параметр window имеет значение null . The window parameter is null .
duration меньше или равно 0. duration is less than or equal to 0.
Комментарии
Эта версия перегруженного Show метода работает идентично Show(String, IWin32Window, Point, Int32) версии, за исключением того, что смещение задается как отдельные координаты x и y вместо Point . This version of the overloaded Show method operates identically to the Show(String, IWin32Window, Point, Int32) version, except that the offset is specified as separate x and y coordinates instead of a Point. Чтобы отобразить подсказку в модальном виде, следует вызвать Show(String, IWin32Window, Int32, Int32) перегруженную версию этого метода. To display the ToolTip modally, call the Show(String, IWin32Window, Int32, Int32) overloaded version of this method instead.
Приложения, работающие в режиме частичного доверия, должны утверждать AllWindows разрешение на использование этого метода, а также Show управлять отображением и расположением подсказки, независимо от действия пользователя. Applications running in partial trust must assert the AllWindows permission to use this method, as Show can control the display and location of a ToolTip independent of user action.
См. также раздел
Show(String, IWin32Window, Point)
Задает текст всплывающей подсказки, связанной с указанным элементом управления, а затем отображает всплывающую подсказку в модальном режиме в заданной относительной позиции. Sets the ToolTip text associated with the specified control, and then displays the ToolTip modally at the specified relative position.
Параметры
Строка String, содержащая новый текст всплывающей подсказки. A String containing the new ToolTip text.
Элемент управления Control, для которого отображается всплывающая подсказка. The Control to display the ToolTip for.
Объект Point, содержащий смещение, в пикселях, относительно верхнего левого угла окна связанного элемента управления для отображения всплывающей подсказки. A Point containing the offset, in pixels, relative to the upper-left corner of the associated control window, to display the ToolTip.
Исключения
Параметр window имеет значение null . The window parameter is null .
Комментарии
pt Параметр может задавать расположение вне границ связанного элемента управления, его родительской формы или даже рабочего стола. The pt parameter can specify a position outside the bounds of the associated control, its parent form, or even the desktop. Версия Show метода отображает подсказку для указанного элемента управления в модальном режиме, то есть подсказка будет отображаться до Hide вызова метода или до сворачивания, скрытия или закрытия родительской формы. The version of the Show method displays the ToolTip for the specified control modally; that is, the ToolTip will be displayed until the Hide method is called, or until the parent form is minimized, hidden, or dismissed.
Приложения, работающие в режиме частичного доверия, должны утверждать AllWindows разрешение на использование этого метода, а также Show управлять отображением и расположением подсказки, независимо от действия пользователя. Applications running in partial trust must assert the AllWindows permission to use this method, as Show can control the display and location of a ToolTip independent of user action.
См. также раздел
Show(String, IWin32Window)
Задает текст всплывающей подсказки, связанный с указанным элементом управления, и отображает всплывающую подсказку в модальном режиме. Sets the ToolTip text associated with the specified control, and displays the ToolTip modally.
Параметры
Строка String, содержащая новый текст всплывающей подсказки. A String containing the new ToolTip text.
Элемент управления Control, для которого отображается всплывающая подсказка. The Control to display the ToolTip for.
Исключения
Параметр window имеет значение null . The window parameter is null .
Комментарии
Версия Show метода отображает всплывающую подсказку для указанного элемента управления в модальном режиме, то есть подсказка будет отображаться до Hide вызова метода или до тех пор, пока родительская форма не будет свернута, скрыта или закрыта. The version of the Show method displays the ToolTip for the specified control modally; that is, the ToolTip will be displayed until the Hide method is called, or until the parent form is minimized, hidden, or closed. Подсказка располагается в центре связанного элемента управления. The ToolTip is positioned in the center of the associated control.
Приложения, работающие в режиме частичного доверия, должны утверждать AllWindows разрешение на использование этого метода, а также Show управлять отображением и расположением подсказки, независимо от действия пользователя. Applications running in partial trust must assert the AllWindows permission to use this method, as Show can control the display and location of a ToolTip independent of user action.
См. также раздел
Show(String, IWin32Window, Int32)
Задает текст всплывающей подсказки, связанный с указанным элементом управления, а затем отображает всплывающую подсказку в течение заданного времени. Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration.
Параметры
Строка String, содержащая новый текст всплывающей подсказки. A String containing the new ToolTip text.
Элемент управления Control, для которого отображается всплывающая подсказка. The Control to display the ToolTip for.
Число Int32, содержащее длительность, в миллисекундах, отображения всплывающей подсказки. An Int32 containing the duration, in milliseconds, to display the ToolTip.
Исключения
Параметр window имеет значение null . The window parameter is null .
duration меньше или равно 0. duration is less than or equal to 0.
Комментарии
Подсказка располагается в центре связанного элемента управления, представленного win параметром. The ToolTip is positioned in the center of the associated control represented by the win parameter. Чтобы отобразить подсказку в модальном виде, следует вызвать Show(String, IWin32Window) перегруженную версию этого метода. To display the ToolTip modally, call the Show(String, IWin32Window) overloaded version of this method instead.
Приложения, работающие в режиме частичного доверия, должны утверждать AllWindows разрешение на использование этого метода, а также Show управлять отображением и расположением подсказки, независимо от действия пользователя. Applications running in partial trust must assert the AllWindows permission to use this method, as Show can control the display and location of a ToolTip independent of user action.