DrawToolTipEventArgs.Graphics Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft die zum Zeichnen des ToolTip verwendete Grafikoberfläche ab.

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

Graphics

Die Graphics, auf der der ToolTip gezeichnet werden soll.

Beispiele

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

Der folgende Codeauszug veranschaulicht die Verwendung der DrawText Methoden und und DrawBackground die Verwendung der Graphics -Eigenschaft. Das vollständige Codebeispiel finden Sie in der DrawToolTipEventArgs Klassenübersicht.

// 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. Sie können beispielsweise ihren eigenen QuickInfo-Hintergrund mit der Graphics.FillRectangle -Methode zeichnen.

Benutzerdefinierte Zeichnungen, die außerhalb des durch die Bounds -Eigenschaft angegebenen Rechtecks ausgeführt werden, werden nicht angezeigt. Sie können die Grenzen von ToolTip erhöhen, bevor es angezeigt wird, indem Sie das ToolTip.Popup -Ereignis behandeln.

Die DrawToolTipEventArgs -Klasse stellt auch die DrawBackgroundMethoden , DrawText und DrawBorder bereit, um einzelne Teile von auf ToolTip die vom Betriebssystem verwendete Standardmethode zu zeichnen. Sie können diese Methoden zusammen mit den Graphics Objektmethoden verwenden, um teile des QuickInfo-Standards zu erstellen und andere Teile anzupassen.