DrawToolTipEventArgs.ToolTipText Proprietà

Definizione

Ottiene il testo per l'oggetto ToolTip da creare.Gets the text for the ToolTip that is being drawn.

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

Valore della proprietà

String

Testo associato all'oggetto ToolTip quando si verifica l'evento Draw.The text that is associated with the ToolTip when the Draw event occurs.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come creare un oggetto personalizzato ToolTip .The following code example demonstrates how to custom draw the ToolTip. Nell'esempio viene creato un oggetto ToolTip e lo si associa a tre Button controlli che si trovano in Form .The example creates a ToolTip and associates it to three Button controls located on the Form. Nell'esempio la proprietà viene impostata OwnerDraw su true e viene gestito l' Draw evento.The example sets the OwnerDraw property to true and handles the Draw event. Nel Draw gestore eventi, ToolTip è personalizzato disegnata in modo diverso a seconda del pulsante ToolTip visualizzato per come indicato dalla DrawToolTipEventArgs.AssociatedControl Proprietà.In the Draw event handler, the ToolTip is custom drawn differently depending on what button the ToolTip is being displayed for as indicated by the DrawToolTipEventArgs.AssociatedControl property.

Nell'estratto di codice riportato di seguito viene illustrato l'utilizzo del DrawBorder metodo e l'utilizzo delle Bounds ToolTipText proprietà, e Graphics .The code excerpt below demonstrates using the DrawBorder method and using the Bounds, ToolTipText, and Graphics properties. DrawToolTipEventArgsPer l'esempio di codice completo, vedere Cenni preliminari sulla classe.See the DrawToolTipEventArgs class overview for the complete code example.

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

Commenti

In genere si usa la ToolTipText proprietà per determinare il testo della descrizione comando quando si disegna una descrizione comando personalizzata.Typically you would use the ToolTipText property to determine what the ToolTip text is when you are custom drawing your ToolTip. È possibile usare il Graphics.DrawString metodo per personalizzare il disegno del testo della descrizione comando.You can use the Graphics.DrawString method to customize the drawing of the ToolTip text. Se si desidera che il testo della descrizione comando venga disegnato utilizzando lo stile specificato dal sistema, utilizzare il DrawText metodo.If you want to have the ToolTip text drawn using the system specified style, use the DrawText method. Il valore di testo deriva dal valore passato al SetToolTip metodo della ToolTip classe.The text value comes from the value passed to the SetToolTip method of the ToolTip class.

Si applica a

Vedi anche