DrawToolTipEventArgs.Graphics Eigenschaft

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 die Gezeichnet werden ToolTipsoll.

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.

Der folgende Codeauszug veranschaulicht die Verwendung der DrawText Eigenschaften und DrawBackgroundGraphics Methoden. DrawToolTipEventArgs Die Klassenübersicht finden Sie im vollständigen Codebeispiel.

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

Mit dem Graphics Objekt können Sie die Zeichnung bestimmter visueller Aspekte eines Objekts ToolTipanpassen. Sie können beispielsweise ihren eigenen QuickInfo-Hintergrund mithilfe der Graphics.FillRectangle Methode zeichnen.

Jede benutzerdefinierte Zeichnung, die außerhalb des durch die Bounds Eigenschaft angegebenen Rechtecks erfolgt, wird nicht angezeigt. Sie können die Grenzen der ToolTip vor dem Anzeigen angezeigten Grenzen erhöhen, indem Sie das ToolTip.Popup Ereignis behandeln.

Die DrawToolTipEventArgs Klasse stellt außerdem die DrawBackgroundMethoden DrawText und DrawBorder Methoden zum Zeichnen einzelner Teile der ToolTip Standardmethode bereit, die vom Betriebssystem verwendet werden. Sie können diese Methoden zusammen mit den Graphics Objektmethoden verwenden, um einige Teile Ihres QuickInfo-Standards zu erstellen, während Sie andere Teile anpassen.