Определяет текст подсказки, появляющийся в виде микроокошка ToolTip для элемента управления. Вы можете установить свойство ToolTipText для элемента управления только в том случае, когда свойство ShowTips формы или панели инструментов, которые содержат этот элемент управления, установлено в True (.T.). Доступно как в design time, так и в run time.
Последнее утверждение, приведенное в оригинале, неверно. Правильнее было бы указать следующее: "Вы увидите появляющуюся подсказку в виде микроокошка ToolTip только в том случае, если свойство ShowTips формы или панели инструментов, которые содержат этот элемент управления, установлено в True (.T.)". Ничто не мешает вам заранее установить значения этого свойства для элементов управления, которые обладают этим свойством, независимо от установки свойства ShowTips формы или панели инструментов. Более того, для удобства пользователя вы можете создать в меню, например, в "Инструментах" пункт - "Показывать подсказки для элементов управления" и изменять глобальную переменную, которая будет считываться формой или панелью инструментов в момент инициализации и присваивать это значение свойству ShowTips формы или панели инструментов. (Примечание переводчика).

Control.ToolTipText [= cExpr]

Expand imageВозвращаемое значение

cExpr

Указывает текст, который будет использоваться для ToolTip. Максимальное число символов, которое вы можете указать для cExpr равно 4,095.

Expand imageПримечания

Применяется к: CheckBox | Column | ComboBox | CommandButton | CommandGroup | Container | Control | EditBox | Grid | Header | Image | Label | Line | ListBox | OLE Bound Control | OptionButton | OptionGroup | PageFrame | Shape | Spinner | TextBox

Visual FoxPro поддерживает перенос слов для ToolTips.

Когда вы определяете значение свойства ToolTipText для размещаемых в контейнерах элементах управления, таких какColumn, Header или OptionButton то при перемещении курсора мыши над обоими объектами, и контейнером, и содержащемся в нем элементом управления, преимущество будет иметь свойство ToolTipText самого глубокого в иерархии объекта, в случае если для обоих установлено значение для ToolTipText.

Для элементов управления, содержащихся в контейнерах, за исключением Grid , в случае, если вложенный в контейнер объект не содержит значения в свойстве ToolTipText, но сам контейнер содержит какое-то значение в разбираемом свойстве, Visual FoxPro не будет отображать ToolTip при перемещении мыши над вложенным в контейнер объектом - элементом управления.

Если для объектов, содержащихся в элементе управления Grid не установлено значение свойства ToolTipText, но оно установлено для контенера, Visual FoxPro отобразит ToolTip определенное для контейнера. Например, если указатель мыши перемещается над объектом Header, а для него не определено значение свойтсва ToolTipText, Visual FoxPro отобразит ToolTip колонки, если, конечно же, оно установлено.

Visual FoxPro отобразит подсказку для элемента управления, содержащегося в колонке, например, для TextBox, у которого установлено значение свойства ToolTipText только в том случае, когда элемент управления получит фокус. Если же для этого элемента управления свойство ToolTipText не было установлено, то при получении фокуса будет отображет ToolTip колонки.

Expand imageПримеры

Пример 1

Приведенный ниже код примера иллюстрирует использование ToolTips для элементов управления, содержащехся в контейнере, причем этот контейнер не является элементом управления grid. Приведенный пример показывает, как отображаются ToolTips для элементов управления CommandButton и CommandGroup когда каждый элемент имеет фокус, например, когда вы перемещаете указатель мыши поверх командной кнопки или группы командных кнопок.

  CopyCode imageСкопировать код
CommandGroup1.ToolTipText = "Hi, I'm a CommandGroup."
CommandGroup1.Command1.ToolTipText = "Hi, I'm Command 1."
CommandGroup1.Command2.ToolTipText = "Hi, I'm Command 2."

В следующей секии кода ToolTip для Command2 не отображется при получении им фокуса, поскольку для него не определено текст для ToolTip.

  CopyCode imageСкопировать код
CommandGroup1.ToolTipText = "Hi, I'm a CommandGroup."
CommandGroup1.Command1.ToolTipText = "Hi, I'm Command 1."

Пример 2

Приведенный ниже код примера иллюстрирует как отображаются ToolTips для элементов управления, содержащихся в grid. Приведенный пример показывает, как отображается ToolTip для элемента управленияTextBox при получении им фокуса.

  CopyCode imageСкопировать код
Grid1.ToolTipText = "Hi, I'm a Grid."
Grid1.Column1.ToolTipText = "Hi, I'm a Column."
Grid1.Column1.Header1.ToolTipText = "Hi, I'm a Header."
Grid1.Column1.Text1.ToolTipText = "Hi! I'm the Textbox!"

В приведенной ниже секции кода ToolTip для TextBox не отображается при получении им фокуса, поскольку у этого элемента управления не определен текст для ToolTip.

  CopyCode imageСкопировать код
Grid1.ToolTipText = "Hi, I'm a Grid."
Grid1.Column1.ToolTipText = "Hi, I'm a Column."
Grid1.Column1.Header1.ToolTipText = "Hi, I'm a Header."

В приведенной ниже секции кода ToolTip для column появляется, когда элемент управления Header получает фокус, поскольку для заголока header не определен текст для ToolTip.

  CopyCode imageСкопировать код
Grid1.ToolTipText = "Hi, I'm a Grid."
Grid1.Column1.ToolTipText = "Hi, I'm a Column."

В приведенной ниже секции кода ToolTip для grid появляется при получении объектами Column или Header фокуса, поскольку для этих элементов управления не определен текст для ToolTip.

  CopyCode imageСкопировать код
Grid1.ToolTipText = "Hi, I'm a Grid."

Expand imageСмотрите также