DrawToolTipEventArgs.ToolTipText Eigenschaft

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

Der Text, der dem ToolTip Zeitpunkt des Auftretens des Draw Ereignisses zugeordnet ist.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die benutzerdefinierte Zeichnung des Steuerelements ToolTiperstellt wird. Im Beispiel wird ein Steuerelement ToolTip erstellt und drei Button Steuerelementen zugeordnet, die sich auf dem FormSteuerelement befinden. Im Beispiel wird die OwnerDraw Eigenschaft auf "true" festgelegt und das Draw Ereignis behandelt. Draw Im Ereignishandler wird die ToolTip Benutzerdefinierte gezeichnet, je nachdem, für welche Schaltfläche die ToolTip durch die DrawToolTipEventArgs.AssociatedControl Eigenschaft angegebene Schaltfläche angezeigt wird.

Im folgenden Codeauszug wird die Verwendung der DrawBorder Methode und der Verwendung der BoundsEigenschaften und der Methoden ToolTipTextveranschaulicht Graphics . DrawToolTipEventArgs Die Klassenübersicht finden Sie im vollständigen Codebeispiel.

// 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. Mit der Graphics.DrawString Methode können Sie die Zeichnung des QuickInfo-Texts anpassen. Wenn Sie den QuickInfo-Text mithilfe der vom System angegebenen Formatvorlage gezeichnet haben möchten, verwenden Sie die DrawText Methode. Der Textwert stammt aus dem An die SetToolTip Methode der ToolTip Klasse übergebenen Wert.

Weitere Informationen

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