DrawToolTipEventArgs.Graphics Eigenschaft

Definition

Ruft die zum Zeichnen des ToolTip verwendete Grafikoberfläche ab.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

Eigenschaftswert

Die Graphics, auf der der ToolTip gezeichnet werden soll.The Graphics on which to draw the ToolTip.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ToolTipbenutzerdefinierte gezeichnet wird.The following code example demonstrates how to custom draw the ToolTip. Im Beispiel wird ein ToolTip erstellt und den drei Button Steuerelementen in Formzugeordnet.The example creates a ToolTip and associates it to three Button controls located on the Form. Im Beispiel wird die OwnerDraw -Eigenschaft auf true festgelegt Draw und das-Ereignis behandelt.The example sets the OwnerDraw property to true and handles the Draw event. Im- ToolTip ToolTip Ereignishandler wird der benutzerdefinierte gezeichnet, abhängig von der Schaltfläche, für die der angezeigt wird, wie DrawToolTipEventArgs.AssociatedControl von der-Eigenschaft angegeben. DrawIn 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.

Der folgende Code Ausschnitt veranschaulicht die Verwendung DrawText der DrawBackground -und-Methoden Graphics und die Verwendung der-Eigenschaft.The code excerpt below demonstrates using the DrawText and DrawBackground methods and using the Graphics property. Das gesamte DrawToolTipEventArgs Codebeispiel finden Sie in der Übersicht über die-Klasse.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)

Hinweise

Sie verwenden das Graphics -Objekt, um die Zeichnung bestimmter visueller Aspekte einer ToolTipanzupassen.You use the Graphics object to customize the drawing of certain visual aspects of a ToolTip. Beispielsweise können Sie mit der Graphics.FillRectangle -Methode ihren eigenen QuickInfo-Hintergrund zeichnen.For example, you can draw your own ToolTip background by using the Graphics.FillRectangle method.

Alle benutzerdefinierten Zeichnungen, die außerhalb des durch die Bounds -Eigenschaft angegebenen Rechtecks vorgenommen werden, werden nicht angezeigt.Any custom drawing that is done outside of the rectangle specified by the Bounds property will not show up. Sie können die Grenzen des ToolTip erhöhen, bevor es angezeigt wird, indem Sie das ToolTip.Popup -Ereignis behandeln.You can increase the bounds of the ToolTip before it is shown by handling the ToolTip.Popup event.

Die DrawToolTipEventArgs DrawBackground DrawText -KlasseDrawBorder stellt außerdem die-Methode, die-Methode und die-Methode bereit, um einzelne Teile der aufdervomBetriebssystemverwendetenStandardmethodezuzeichnen.ToolTipThe 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. Sie können diese Methoden zusammen mit den Graphics Objektmethoden verwenden, um einige Teile des QuickInfo-Standards zu erstellen und gleichzeitig andere Teile anzupassen.You can use these methods, together with the Graphics object methods, to make some parts of your ToolTip standard, while customizing other parts.

Gilt für: