DrawToolTipEventArgs.Bounds プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DrawToolTipEventArgs.Bounds プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

描画する ToolTip のサイズと位置を取得します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Bounds As Rectangle

Visual Basic (使用法)

Dim instance As DrawToolTipEventArgs
Dim value As Rectangle

value = instance.Bounds

public Rectangle Bounds { get; }

C++

public:
property Rectangle Bounds {
    Rectangle get ();
}

/** @property */
public Rectangle get_Bounds ()

JScript

public function get Bounds
 () : Rectangle

プロパティ値
描画する ToolTip の境界を表す Rectangle。

解説

既定では、境界はシステム設定と ToolTip テキストに基づき、オペレーティングシステムによって設定されます。ToolTip クラスの PopupPopup イベントを処理することで、ToolTip の表示前に、その境界を拡大できます。

使用例

ToolTip をカスタム描画する方法を次のコード例に示します。この例では、ToolTip を作成し、Form 上にある 3 つの Button コントロールに関連付けています。また、OwnerDraw プロパティを true に設定し、Draw イベントを処理しています。Draw イベントハンドラでは、どのボタンで ToolTip が表示されるかをDrawToolTipEventArgs.AssociatedControl プロパティで指定し、それによって ToolTip がカスタムで描画されます。

DrawBorder メソッドの使用方法、および Bounds、ToolTipText、および Graphics の各プロパティの使用方法を次のコード例の抜粋に示します。コード例全体については、DrawToolTipEventArgs クラスの概要を参照してください。

Visual Basic

ElseIf (e.AssociatedControl Is button2) Then
    ' Draw a custom background and text if the ToolTip is for button2.

    ' Draw the custom background.
    e.Graphics.FillRectangle(SystemBrushes.ActiveCaption, e.Bounds)

    ' Draw the standard border.
    e.DrawBorder()

    ' Draw the custom text.
    Dim sf As StringFormat = New
 StringFormat
    Try
        sf.Alignment = StringAlignment.Center
        sf.LineAlignment = StringAlignment.Center
        sf.HotkeyPrefix = System.Drawing.Text.HotkeyPrefix.None
        sf.FormatFlags = StringFormatFlags.NoWrap

        Dim f As Font = New
 Font("Tahoma", 9)
        Try
            e.Graphics.DrawString(e.ToolTipText, f, _
                SystemBrushes.ActiveCaptionText, _
                RectangleF.op_Implicit(e.Bounds), sf)
        Finally
            f.Dispose()
        End Try
    Finally
        sf.Dispose()
    End Try

// Draw a custom background and text if the ToolTip is for button2.
else if (e.AssociatedControl == button2)
{
    // Draw the custom background.
    e.Graphics.FillRectangle(SystemBrushes.ActiveCaption, e.Bounds);

    // Draw the standard border.
    e.DrawBorder();

    // Draw the custom text.
    // The using block will dispose the StringFormat automatically.
    using (StringFormat sf = new StringFormat())
    {
        sf.Alignment = StringAlignment.Center;
        sf.LineAlignment = StringAlignment.Center;
        sf.HotkeyPrefix = System.Drawing.Text.HotkeyPrefix.None;
        sf.FormatFlags = StringFormatFlags.NoWrap;
        using (Font f = new Font("Tahoma",
 9))
        {
            e.Graphics.DrawString(e.ToolTipText, f, 
                SystemBrushes.ActiveCaptionText, e.Bounds, sf);
        }
    }
}

C++

// Draw a custom background and text if the ToolTip is for button2.
else

// Draw a custom background and text if the ToolTip is for button2.
if ( e->AssociatedControl == button2 )
{
   // Draw the custom background.
   e->Graphics->FillRectangle( SystemBrushes::ActiveCaption, e->Bounds );
   
   // Draw the standard border.
   e->DrawBorder();
   
   // Draw the custom text.
   // The using block will dispose the StringFormat automatically.
   StringFormat^ sf = gcnew StringFormat;
   try
   {
      sf->Alignment = StringAlignment::Center;
      sf->LineAlignment = StringAlignment::Center;
      sf->HotkeyPrefix = System::Drawing::Text::HotkeyPrefix::None;
      sf->FormatFlags = StringFormatFlags::NoWrap;
      System::Drawing::Font^ f = gcnew System::Drawing::Font( "Tahoma",9
 );
      try
      {
         e->Graphics->DrawString( e->ToolTipText, f, SystemBrushes::ActiveCaptionText,
 e->Bounds, sf );
      }
      finally
      {
         if ( f )
            delete safe_cast<IDisposable^>(f);
      }

   }
   finally
   {
      if ( sf )
         delete safe_cast<IDisposable^>(sf);
   }
}

// Draw a custom background and text if the ToolTip is for button2.
else {
    if (e.get_AssociatedControl().Equals(button2)) {
        // Draw the custom background.
        e.get_Graphics().FillRectangle(SystemBrushes.get_ActiveCaption(),
            e.get_Bounds());
        // Draw the standard border.
        e.DrawBorder();
        
        // Draw the custom text.
        // The using block will dispose the StringFormat automatically.
        StringFormat sf = new StringFormat();
        try {
            sf.set_Alignment(StringAlignment.Center);
            sf.set_LineAlignment(StringAlignment.Center);
            sf.set_HotkeyPrefix(System.Drawing.Text.HotkeyPrefix.None);
            sf.set_FormatFlags(StringFormatFlags.NoWrap);                    
            Font f = new Font("Tahoma", 9);
            try {
                e.get_Graphics().DrawString(e.get_ToolTipText(), f,
                    SystemBrushes.get_ActiveCaptionText(),
                    RectangleF.op_Implicit(e.get_Bounds()), sf);
            }
            finally {
                f.Dispose();
            }                    
        }
        finally {
            sf.Dispose();
        }                
    }