DrawToolTipEventArgs.Graphics 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

获取用于绘制 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

属性值

Graphics

要在其上绘制 Graphics 的 ToolTip。

示例

下面的代码示例演示如何自定义绘制 ToolTip。 该示例创建 ，并将其关联到 位于 上的Form三个ButtonToolTip控件。 该示例将 OwnerDraw 属性设置为 true 并处理 Draw 事件。 在事件处理程序中Draw，ToolTip根据 属性指示DrawToolTipEventArgs.AssociatedControl显示的按钮ToolTip，以不同的方式自定义绘制 。

下面的代码摘录演示如何使用 DrawText 和 DrawBackground 方法以及 使用 Graphics 属性。 有关完整的代码示例， DrawToolTipEventArgs 请参阅类概述。

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

注解

使用 Graphics 对象自定义 的某些视觉方面的 ToolTip绘图。 例如，可以使用 方法绘制自己的工具提示背景 Graphics.FillRectangle 。

在 属性指定的 Bounds 矩形之外完成的任何自定义绘图都不会显示。 可以通过处理 ToolTip.Popup 事件来增加 的边界ToolTip，然后再显示它。

类 DrawToolTipEventArgs 还提供 DrawBackground、 DrawText 和 DrawBorder 方法，用于以操作系统使用的标准方式绘制 的各个 ToolTip 部分。 可以将这些方法与对象方法一起使用 Graphics ，以生成工具提示标准的某些部分，同时自定义其他部件。