DrawToolTipEventArgs.Bounds Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft die Größe und die Position des zu zeichnenden ToolTip ab.

public:
 property System::Drawing::Rectangle Bounds { System::Drawing::Rectangle get(); };

public System.Drawing.Rectangle Bounds { get; }

member this.Bounds : System.Drawing.Rectangle

Public ReadOnly Property Bounds As Rectangle

Eigenschaftswert

Rectangle

Ein Rectangle, das die Begrenzungen des zu zeichnenden ToolTip darstellt.

Beispiele

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

Der folgende Codeauszug veranschaulicht die Verwendung der DrawBorder -Methode und die Verwendung der BoundsEigenschaften , ToolTipTextund Graphics . 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

Standardmäßig werden die Grenzen vom Betriebssystem basierend auf den Systemeinstellungen und dem ToolTip Text festgelegt. Sie können die Grenzen von ToolTip erhöhen, bevor es angezeigt wird, indem Sie das PopupPopup -Ereignis der ToolTip -Klasse behandeln.