ToolTip Klas

Definitie

public ref class ToolTip sealed : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider

public ref class ToolTip : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider

public sealed class ToolTip : System.ComponentModel.Component, System.ComponentModel.IExtenderProvider

public class ToolTip : System.ComponentModel.Component, System.ComponentModel.IExtenderProvider

type ToolTip = class
    inherit Component
    interface IExtenderProvider

Public NotInheritable Class ToolTip
Inherits Component
Implements IExtenderProvider

Public Class ToolTip
Inherits Component
Implements IExtenderProvider

Overname

Object

MarshalByRefObject

Component

ToolTip

Implementeringen

IExtenderProvider

Voorbeelden

In het volgende codevoorbeeld wordt een exemplaar van de ToolTip klasse gemaakt en wordt het exemplaar gekoppeld aan het Form exemplaar dat binnen is gemaakt. De code initialiseert vervolgens de vertragingseigenschappen AutoPopDelay, InitialDelayen ReshowDelay. Daarnaast stelt het exemplaar van de ToolTip klasse de ShowAlways eigenschap in om true tooltiptekst altijd weer te geven, ongeacht of het formulier actief is. Ten slotte koppelt het voorbeeld knopinfotekst aan twee besturingselementen in een formulier, a Button en a CheckBox. Het codevoorbeeld vereist dat de in het voorbeeld gedefinieerde methode zich bevindt in een Form besturingselement met een Button benoemd button1 besturingselement en een CheckBox besturingselement met de naam checkBox1, en dat de methode wordt aangeroepen vanuit de constructor van de Form.

// This example assumes that the Form_Load event handling method
// is connected to the Load event of the form.
void Form1_Load( Object^ sender, System::EventArgs^ e )
{
   // Create the ToolTip and associate with the Form container.
   ToolTip^ toolTip1 = gcnew ToolTip;
   
   // Set up the delays for the ToolTip.
   toolTip1->AutoPopDelay = 5000;
   toolTip1->InitialDelay = 1000;
   toolTip1->ReshowDelay = 500;
   // Force the ToolTip text to be displayed whether or not the form is active.
   toolTip1->ShowAlways = true;
   
   // Set up the ToolTip text for the Button and Checkbox.
   toolTip1->SetToolTip( this->button1, "My button1" );
   toolTip1->SetToolTip( this->checkBox1, "My checkBox1" );
}

// This example assumes that the Form_Load event handling method
// is connected to the Load event of the form.
private void Form1_Load(object sender, System.EventArgs e)
{
   // Create the ToolTip and associate with the Form container.
   ToolTip toolTip1 = new ToolTip();

   // Set up the delays for the ToolTip.
   toolTip1.AutoPopDelay = 5000;
   toolTip1.InitialDelay = 1000;
   toolTip1.ReshowDelay = 500;
   // Force the ToolTip text to be displayed whether or not the form is active.
   toolTip1.ShowAlways = true;
      
   // Set up the ToolTip text for the Button and Checkbox.
   toolTip1.SetToolTip(this.button1, "My button1");
   toolTip1.SetToolTip(this.checkBox1, "My checkBox1");
}

' This example assumes that the Form_Load event handling method
' is connected to the Load event of the form.
Private Sub Form1_Load(sender As Object, e As System.EventArgs) Handles MyBase.Load
   ' Create the ToolTip and associate with the Form container.
   Dim toolTip1 As New ToolTip()
   
   ' Set up the delays for the ToolTip.
   toolTip1.AutoPopDelay = 5000
   toolTip1.InitialDelay = 1000
   toolTip1.ReshowDelay = 500
   ' Force the ToolTip text to be displayed whether or not the form is active.
   toolTip1.ShowAlways = True
   
   ' Set up the ToolTip text for the Button and Checkbox.
   toolTip1.SetToolTip(Me.button1, "My button1")
   toolTip1.SetToolTip(Me.checkBox1, "My checkBox1")
End Sub

Opmerkingen

Met de ToolTip klasse kunt u hints aan een gebruiker geven wanneer de gebruiker de aanwijzer op een besturingselement plaatst. De ToolTip klasse wordt meestal gebruikt om gebruikers te waarschuwen voor het beoogde gebruik van een besturingselement. U kunt bijvoorbeeld knopinfotekst opgeven voor een TextBox besturingselement dat een naam accepteert, waarbij u de notatie van de naam opgeeft die in het besturingselement moet worden getypt. Naast hints kunt u ook de ToolTip klasse gebruiken om uitvoeringsstatusinformatie op te geven. U kunt de ToolTip klasse bijvoorbeeld gebruiken om verbindingssnelheid- en regelkwaliteitsgegevens weer te geven wanneer de gebruiker de aanwijzer verplaatst naar een PictureBox besturingselement dat de status van de internetverbinding weergeeft.

De ToolTip klasse kan in elke container worden gebruikt. Als u expliciet een container wilt opgeven, gebruikt u de ToolTip(IContainer) constructor. Een enkel ToolTip onderdeel wordt doorgaans gebruikt voor het maken van knopinfo voor meerdere besturingselementen op één formulier. Nadat u een ToolTipbestand hebt gemaakt, gebruikt u een afzonderlijke aanroep van de SetToolTip methode om knopinfo-weergavetekst aan een afzonderlijk besturingselement te koppelen. Wanneer de gebruiker de aanwijzer op een besturingselement verplaatst, wordt de knopinfo met de bijbehorende tekst weergegeven. U kunt SetToolTip meerdere keren bellen voor hetzelfde besturingselement om de tekst te wijzigen die aan het besturingselement is gekoppeld. Gebruik de GetToolTip methode om de tekst op te halen die aan een besturingselement is gekoppeld. Als u alle tekstkoppelingen voor knopinfo met een exemplaar van de ToolTip klasse wilt verwijderen, gebruikt u de RemoveAll methode.

De ToolTip klasse bevat de volgende eigenschappen en methoden om het standaardgedrag en het uiterlijk van een Knopinfo te wijzigen.

Als u alle knopinfo-tekst wilt uitschakelen zodat deze niet kan worden weergegeven in uw toepassing, kunt u de Active eigenschap gebruiken. Meestal wordt de Knopinfo getekend door het besturingssysteem, maar om het uiterlijk van de ToolTipeigenschap aan te passen, kunt u de OwnerDraw eigenschap true instellen en de Draw gebeurtenis afhandelen.

De ToolTipTitle klasse implementeert de System.ComponentModel.IExtenderProvider interface, die één methode heeft. CanExtend Met Knopinfo worden besturingselementen op hetzelfde formulier tijdens het ontwerp uitgebreid, waarbij een ToolTip eigenschap wordt toegevoegd. Zie Extender Providers voor meer informatie over extender-providers.

Zie ook

• ToolTipIcon
• HelpProvider
• Extender Providers
• ToolTip Component (Windows Forms)