DrawToolTipEventArgs.ToolTipText Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DrawToolTipEventArgs.cs

Возвращает текст для рисуемого 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 событие. В обработчике DrawToolTip событий настраивается по-разному в зависимости от ToolTip кнопки, отображаемой свойством DrawToolTipEventArgs.AssociatedControl .

Приведенный ниже фрагмент кода демонстрирует использование DrawBorder метода и использование BoundsToolTipTextсвойств и 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)