DrawToolTipEventArgs.Graphics Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DrawToolTipEventArgs.cs

Возвращает область графики, используемую для рисования 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. В примере создается ToolTip и связывается с тремя Button элементами управления, расположенными в элементе Formуправления. В примере свойство OwnerDraw имеет значение true и обрабатывается Draw событие. В обработчике DrawToolTip событий настраивается по-разному в зависимости от ToolTip кнопки, отображаемой свойством DrawToolTipEventArgs.AssociatedControl .

Приведенный ниже фрагмент кода демонстрирует использование 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 до его отображения, обрабатывая ToolTip.Popup событие.

Класс DrawToolTipEventArgs также предоставляет DrawBorderDrawBackgroundDrawText методы для рисования отдельных частей стандартного способа, используемого ToolTip операционной системой. Эти методы можно использовать вместе с Graphics методами объекта, чтобы сделать некоторые части стандартной подсказки, настраивая другие части.