DrawToolTipEventArgs.Graphics Proprietà

Definizione

Ottiene la superficie grafica utilizzata per creare l'oggetto ToolTip.Gets the graphics surface used to draw the ToolTip.

public:
 property System::Drawing::Graphics ^ Graphics { System::Drawing::Graphics ^ get(); };
public System.Drawing.Graphics Graphics { get; }
member this.Graphics : System.Drawing.Graphics
Public ReadOnly Property Graphics As Graphics

Valore della proprietà

Graphics

Oggetto Graphics sul quale creare l'oggetto ToolTip.The Graphics on which to draw the ToolTip.

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 dei DrawText DrawBackground metodi e e l'utilizzo della Graphics Proprietà.The code excerpt below demonstrates using the DrawText and DrawBackground methods and using the Graphics property. DrawToolTipEventArgsPer l'esempio di codice completo, vedere Cenni preliminari sulla classe.See the DrawToolTipEventArgs class overview for the complete code example.

// Draw a custom 3D border if the ToolTip is for button1.
if ( e->AssociatedControl == button1 )
{
   // Draw the standard background.
   e->DrawBackground();
   
   // Draw the custom border to appear 3-dimensional.
   array<Point>^ temp1 = {Point(0,e->Bounds.Height - 1),Point(0,0),Point(e->Bounds.Width - 1,0)};
   e->Graphics->DrawLines( SystemPens::ControlLightLight, temp1 );
   array<Point>^ temp2 = {Point(0,e->Bounds.Height - 1),Point(e->Bounds.Width - 1,e->Bounds.Height - 1),Point(e->Bounds.Width - 1,0)};
   e->Graphics->DrawLines( SystemPens::ControlDarkDark, temp2 );
   
   // Specify custom text formatting flags.
   TextFormatFlags sf = static_cast<TextFormatFlags>(TextFormatFlags::VerticalCenter | TextFormatFlags::HorizontalCenter | TextFormatFlags::NoFullWidthCharacterBreak);
   
   // Draw the standard text with customized formatting options.
   e->DrawText( sf );
}
// Draw a custom 3D border if the ToolTip is for button1.
if (e.AssociatedControl == button1)
{
    // Draw the standard background.
    e.DrawBackground();

    // Draw the custom border to appear 3-dimensional.
    e.Graphics.DrawLines(SystemPens.ControlLightLight, new Point[] {
        new Point (0, e.Bounds.Height - 1), 
        new Point (0, 0), 
        new Point (e.Bounds.Width - 1, 0)
    });
    e.Graphics.DrawLines(SystemPens.ControlDarkDark, new Point[] {
        new Point (0, e.Bounds.Height - 1), 
        new Point (e.Bounds.Width - 1, e.Bounds.Height - 1), 
        new Point (e.Bounds.Width - 1, 0)
    });

    // Specify custom text formatting flags.
    TextFormatFlags sf = TextFormatFlags.VerticalCenter |
                         TextFormatFlags.HorizontalCenter |
                         TextFormatFlags.NoFullWidthCharacterBreak;

    // Draw the standard text with customized formatting options.
    e.DrawText(sf);
}
' Draw a custom 3D border if the ToolTip is for button1.
If (e.AssociatedControl Is button1) Then
    ' Draw the standard background.
    e.DrawBackground()

    ' Draw the custom border to appear 3-dimensional.
    e.Graphics.DrawLines( _
        SystemPens.ControlLightLight, New Point() { _
        New Point(0, e.Bounds.Height - 1), _
        New Point(0, 0), _
        New Point(e.Bounds.Width - 1, 0)})
    e.Graphics.DrawLines( _
        SystemPens.ControlDarkDark, New Point() { _
        New Point(0, e.Bounds.Height - 1), _
        New Point(e.Bounds.Width - 1, e.Bounds.Height - 1), _
        New Point(e.Bounds.Width - 1, 0)})

    ' Specify custom text formatting flags.
    Dim sf As TextFormatFlags = TextFormatFlags.VerticalCenter Or _
                         TextFormatFlags.HorizontalCenter Or _
                         TextFormatFlags.NoFullWidthCharacterBreak

    ' Draw standard text with customized formatting options.
    e.DrawText(sf)

Commenti

Usare l' Graphics oggetto per personalizzare il disegno di determinati aspetti visivi di un oggetto ToolTip .You use the Graphics object to customize the drawing of certain visual aspects of a ToolTip. Ad esempio, è possibile creare lo sfondo della descrizione comando usando il Graphics.FillRectangle metodo.For example, you can draw your own ToolTip background by using the Graphics.FillRectangle method.

Qualsiasi disegno personalizzato che viene eseguito all'esterno del rettangolo specificato dalla Bounds proprietà non verrà visualizzato.Any custom drawing that is done outside of the rectangle specified by the Bounds property will not show up. È possibile aumentare i limiti di ToolTip prima che venga visualizzato gestendo l' ToolTip.Popup evento.You can increase the bounds of the ToolTip before it is shown by handling the ToolTip.Popup event.

La DrawToolTipEventArgs classe fornisce inoltre i DrawBackground DrawText metodi, e DrawBorder per creare singole parti di ToolTip nel modo standard utilizzato dal sistema operativo.The DrawToolTipEventArgs class also provides the DrawBackground, DrawText and DrawBorder methods to draw individual parts of the ToolTip in the standard way used by the operating system. È possibile utilizzare questi metodi, insieme ai Graphics metodi dell'oggetto, per creare alcune parti dello standard della descrizione comando, personalizzando le altre parti.You can use these methods, together with the Graphics object methods, to make some parts of your ToolTip standard, while customizing other parts.

Si applica a