Bagikan melalui

DrawToolTipEventArgs.ToolTipText Properti

  • Referensi

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll

Mendapatkan teks untuk ToolTip yang sedang digambar.

public:
 property System::String ^ ToolTipText { System::String ^ get(); };
public string ToolTipText { get; }
public string? ToolTipText { get; }
member this.ToolTipText : string
Public ReadOnly Property ToolTipText As String

Nilai Properti

String

Teks yang terkait dengan ToolTip kapan Draw peristiwa terjadi.

Contoh

Contoh kode berikut menunjukkan cara menggambar ToolTipkustom . Contoh membuat ToolTip dan mengaitkannya ke tiga Button kontrol yang terletak di Form. Contoh mengatur OwnerDraw properti ke true dan menangani Draw peristiwa. Di penanganan Draw aktivitas, ToolTip digambar khusus secara berbeda tergantung pada tombol ToolTip apa yang ditampilkan seperti yang ditunjukkan oleh DrawToolTipEventArgs.AssociatedControl properti .

Kutipan kode di bawah ini menunjukkan menggunakan DrawBorder metode dan menggunakan Boundsproperti , ToolTipText, dan Graphics . DrawToolTipEventArgs Lihat gambaran umum kelas untuk contoh kode lengkap.

// 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.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);
        }
    }
}

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

Keterangan

Biasanya Anda akan menggunakan ToolTipText properti untuk menentukan teks TipsAlat saat Anda menggambar TipsAlat Anda secara kustom. Anda dapat menggunakan Graphics.DrawString metode untuk mengkustomisasi gambar teks TipsAlat. Jika Anda ingin teks TipsAlat digambar menggunakan gaya yang ditentukan sistem, gunakan metode .DrawText Nilai teks berasal dari nilai yang diteruskan ke SetToolTip metode ToolTip kelas .

Berlaku untuk

Lihat juga