DrawToolTipEventArgs.ToolTipText Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает текст для рисуемого элемента ToolTip.

public:
 property System::String ^ ToolTipText { System::String ^ get(); };

public string? ToolTipText { get; }

member this.ToolTipText : string

Public ReadOnly Property ToolTipText As String

Значение свойства

String

Текст, который связан с ToolTip, когда происходит событие Draw.

Примеры

В следующем примере кода показано, как настроить рисование ToolTip. В этом примере создается ToolTip и связывается с тремя Button элементами управления, расположенными в Form. В примере свойству OwnerDraw присваивается значение true и обрабатывается Draw событие . В обработчике Draw событий настраивается по-разному в зависимости от того, ToolTip для какой кнопки ToolTip отображается , как указано свойством DrawToolTipEventArgs.AssociatedControl .

В приведенном ниже фрагменте кода демонстрируется использование DrawBorder метода и свойств Bounds, ToolTipTextи Graphics . Полный DrawToolTipEventArgs пример кода см. в обзоре класса.

// Draw a custom background and text if the ToolTip is for button2.
else

// Draw a custom background and text if the ToolTip is for button2.
if ( e->AssociatedControl == button2 )
{
   // Draw the custom background.
   e->Graphics->FillRectangle( SystemBrushes::ActiveCaption, e->Bounds );
   
   // Draw the standard border.
   e->DrawBorder();
   
   // Draw the custom text.
   // The using block will dispose the StringFormat automatically.
   StringFormat^ sf = gcnew StringFormat;
   try
   {
      sf->Alignment = StringAlignment::Center;
      sf->LineAlignment = StringAlignment::Center;
      sf->HotkeyPrefix = System::Drawing::Text::HotkeyPrefix::None;
      sf->FormatFlags = StringFormatFlags::NoWrap;
      System::Drawing::Font^ f = gcnew System::Drawing::Font( "Tahoma",9 );
      try
      {
         e->Graphics->DrawString( e->ToolTipText, f, SystemBrushes::ActiveCaptionText, e->Bounds, sf );
      }
      finally
      {
         if ( f )
            delete safe_cast<IDisposable^>(f);
      }

   }
   finally
   {
      if ( sf )
         delete safe_cast<IDisposable^>(sf);
   }
}

// Draw a custom background and text if the ToolTip is for button2.
else if (e.AssociatedControl == button2)
{
    // Draw the custom background.
    e.Graphics.FillRectangle(SystemBrushes.ActiveCaption, e.Bounds);

    // Draw the standard border.
    e.DrawBorder();

    // Draw the custom text.
    // The using block will dispose the StringFormat automatically.
    using (StringFormat sf = new StringFormat())
    {
        sf.Alignment = StringAlignment.Center;
        sf.LineAlignment = StringAlignment.Center;
        sf.HotkeyPrefix = System.Drawing.Text.HotkeyPrefix.None;
        sf.FormatFlags = StringFormatFlags.NoWrap;
        using (Font f = new Font("Tahoma", 9))
        {
            e.Graphics.DrawString(e.ToolTipText, f, 
                SystemBrushes.ActiveCaptionText, e.Bounds, sf);
        }
    }
}

ElseIf (e.AssociatedControl Is button2) Then
    ' Draw a custom background and text if the ToolTip is for button2.

    ' Draw the custom background.
    e.Graphics.FillRectangle(SystemBrushes.ActiveCaption, e.Bounds)

    ' Draw the standard border.
    e.DrawBorder()

    ' Draw the custom text.
    Dim sf As StringFormat = New StringFormat
    Try
        sf.Alignment = StringAlignment.Center
        sf.LineAlignment = StringAlignment.Center
        sf.HotkeyPrefix = System.Drawing.Text.HotkeyPrefix.None
        sf.FormatFlags = StringFormatFlags.NoWrap

        Dim f As Font = New Font("Tahoma", 9)
        Try
            e.Graphics.DrawString(e.ToolTipText, f, _
                SystemBrushes.ActiveCaptionText, _
                RectangleF.op_Implicit(e.Bounds), sf)
        Finally
            f.Dispose()
        End Try
    Finally
        sf.Dispose()
    End Try

Комментарии

Обычно свойство используется для ToolTipText определения текста подсказки при настраиваемом рисовании подсказки. Метод можно использовать для Graphics.DrawString настройки рисования текста всплывающей подсказки. Если вы хотите, чтобы текст подсказки рисовался с использованием заданного системой стиля, используйте DrawText метод . Текстовое значение поступает из значения, переданного SetToolTip методу ToolTip класса .

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

• DrawText
• SetToolTip(Control, String)
• Draw
• DrawString(String, Font, Brush, Single, Single)