DrawToolTipEventArgs.ToolTipText Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft den Text für den ToolTip ab, der gezeichnet wird.

public:
 property System::String ^ ToolTipText { System::String ^ get(); };
public string ToolTipText { get; }
public string? ToolTipText { get; }
member this.ToolTipText : string
Public ReadOnly Property ToolTipText As String

Eigenschaftswert

String

Der Text, der dem ToolTip zugeordnet wird, wenn das Draw-Ereignis auftritt.

Beispiele

Im folgenden Codebeispiel wird das benutzerdefinierte Zeichnen von ToolTipveranschaulicht. Im Beispiel wird ein ToolTip erstellt und drei Button Steuerelementen zugeordnet, die Formsich im befinden. Im Beispiel wird die OwnerDraw -Eigenschaft auf true festgelegt und das Draw -Ereignis behandelt. Draw Im Ereignishandler wird je ToolTip nachdem, für welche Schaltfläche die ToolTip angezeigt wird, wie durch die DrawToolTipEventArgs.AssociatedControl -Eigenschaft angegeben, unterschiedlich gezeichnet.

Im folgenden Codeauszug wird die Verwendung der DrawBorder -Methode und der BoundsEigenschaften , ToolTipTextund Graphics veranschaulicht. Das vollständige Codebeispiel finden Sie in der DrawToolTipEventArgs Klassenübersicht.

// 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

Hinweise

In der Regel verwenden Sie die ToolTipText -Eigenschaft, um zu bestimmen, was der QuickInfo-Text ist, wenn Sie ihre QuickInfo benutzerdefinierte Zeichnen. Sie können die Graphics.DrawString -Methode verwenden, um die Zeichnung des QuickInfo-Texts anzupassen. Wenn Sie den QuickInfo-Text mit der vom System angegebenen Formatvorlage gezeichnet haben möchten, verwenden Sie die DrawText -Methode. Der Textwert stammt aus dem Wert, der an die SetToolTip -Methode der ToolTip -Klasse übergeben wird.

Gilt für:

Weitere Informationen