ToolTip 클래스

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

Source:

ToolTip.cs

사용자가 컨트롤에 포인터를 놓을 때 컨트롤의 용도에 대한 간략한 설명을 표시하는 작은 사각형 팝업 창을 나타냅니다.

public ref 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 Class ToolTip
Inherits Component
Implements IExtenderProvider

상속

Object

MarshalByRefObject

Component

ToolTip

구현

IExtenderProvider

예제

다음 코드 예제에서는 클래스의 인스턴스를 ToolTip 만들고 인스턴스가 만들어진 인스턴스와 Form 연결합니다. 그런 다음, 이 코드는 지연 속성 AutoPopDelay및 InitialDelayReshowDelay. 또한 클래스의 ToolTip 인스턴스는 폼이 활성 상태인지 여부에 관계없이 도구 설명 텍스트를 항상 표시할 수 있도록 속성을 true 설정합니다ShowAlways. 마지막으로, 이 예제에서는 도구 설명 텍스트를 폼의 컨트롤 2개와 a 및 a Button 와 연결합니다 CheckBox. 이 코드 예제에서는 예제에 정의된 메서드가 명명된 컨트롤과 CheckBox 명명 button1checkBox1된 컨트롤을 포함하는 Button 메서드 내에 Form 있고 메서드가 생성자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

설명

클래스를 ToolTip 사용하면 사용자가 컨트롤에 포인터를 놓을 때 사용자에게 힌트를 제공할 수 있습니다. ToolTip 클래스는 일반적으로 컨트롤의 의도 된 사용에 대 한 사용자를 경고 하는 데 사용 합니다. 예를 들어 이름을 허용하는 컨트롤의 TextBox 도구 설명 텍스트를 지정하여 컨트롤에 입력할 이름의 형식을 지정할 수 있습니다. 힌트를 제공하는 것 외에도 클래스를 ToolTip 사용하여 런타임 상태 정보를 제공할 수도 있습니다. 예를 들어 사용자가 포인터를 ToolTip 인터넷 연결 상태를 표시하는 컨트롤로 이동할 때 클래스를 PictureBox 사용하여 연결 속도 및 선 품질 데이터를 표시할 수 있습니다.

클래스는 ToolTip 모든 컨테이너에서 사용할 수 있습니다. 컨테이너를 명시적으로 지정하려면 생성자를 사용합니다 ToolTip(IContainer) . 단일 ToolTip 구성 요소는 일반적으로 단일 폼에서 여러 컨트롤에 대한 도구 설명을 만드는 데 사용됩니다. 만든 ToolTip후에는 메서드에 대한 별도의 호출을 SetToolTip 사용하여 도구 설명 표시 텍스트를 개별 컨트롤에 연결합니다. 그런 다음 사용자가 컨트롤에서 포인터를 이동하면 텍스트가 있는 도구 설명이 표시됩니다. 동일한 컨트롤에 대해 두 번 이상 호출 SetToolTip 하여 컨트롤과 연결된 텍스트를 변경할 수 있습니다. 컨트롤과 연결된 텍스트를 얻으려면 메서드를 GetToolTip 사용합니다. 클래스의 ToolTip 인스턴스와 모든 ToolTip 텍스트 연결을 제거하려면 메서드를 RemoveAll 사용합니다.

메모

사용하지 않도록 설정된 컨트롤의 경우 도구 설명 텍스트가 표시되지 않습니다. 속성을 설정true하지 않으면 ShowAlways 컨테이너가 비활성 상태일 때 도구 설명이 표시되지 않습니다.

이 클래스는 ToolTip 도구 설명의 기본 동작과 모양을 수정하는 다음과 같은 속성과 메서드를 제공합니다.

카테고리	연결된 멤버
수동 표시	Active, Show, Hide, ShowAlways, PopupStopTimer
도구 설명 타이밍	AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelayStopTimer
Content	SetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitleRemoveAll
외관	BackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimationUseFading

애플리케이션에 표시할 수 없도록 모든 도구 설명 텍스트를 사용하지 않도록 설정하려면 이 속성을 사용할 Active 수 있습니다. 일반적으로 도구 설명은 운영 체제에 의해 그려지지만 모양을 사용자 지정ToolTip하려면 속성을 이벤트로 설정하고 OwnerDraw 처리 Draw 할 true 수 있습니다.

클래스는 ToolTipTitle 단일 메서드CanExtend가 System.ComponentModel.IExtenderProvider 있는 인터페이스를 구현합니다. 도구 설명은 디자인 타임에 동일한 폼에서 컨트롤을 확장하여 속성을 추가 ToolTip 합니다. extender 공급자에 대한 자세한 내용은 Extender 공급자를 참조하세요.

생성자

Name	Description
ToolTip()	지정된 컨테이너가 없는 새 인스턴스를 ToolTip 초기화합니다.
ToolTip(IContainer)	지정된 컨테이너를 사용하여 클래스의 ToolTip 새 인스턴스를 초기화합니다.

속성

Name	Description
Active	도구 설명이 현재 활성 상태인지 여부를 나타내는 값을 가져오거나 설정합니다.
AutomaticDelay	도구 설명의 자동 지연 시간을 가져오거나 설정합니다.
AutoPopDelay	지정한 도구 설명 텍스트가 있는 컨트롤에 포인터가 고정되어 있는 경우 도구 설명이 표시되는 기간을 가져오거나 설정합니다.
BackColor	도구 설명의 배경색을 가져오거나 설정합니다.
CreateParams	도구 설명 창에 대한 생성 매개 변수를 가져옵니다.
ForeColor	도구 설명의 전경색을 가져오거나 설정합니다.
InitialDelay	도구 설명이 표시되기까지 경과하는 시간을 가져오거나 설정합니다.
IsBalloon	도구 설명에서 풍선 창을 사용해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.
OwnerDraw	도구 설명이 운영 체제에 의해 그려지는지 또는 사용자가 제공하는 코드에 의해 그려지는지를 나타내는 값을 가져오거나 설정합니다.
ReshowDelay	포인터가 한 컨트롤에서 다른 컨트롤로 이동할 때 후속 도구 설명 창이 표시되기 전에 발생하는 시간을 가져오거나 설정합니다.
ShowAlways	부모 컨트롤이 활성화되지 않은 경우에도 도구 설명 창이 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.
StripAmpersands	앰퍼샌드(>) 문자를 처리하는 방법을 결정하는 값을 가져오거나 설정합니다.
Tag	와 연결된 프로그래머 제공 데이터가 들어 있는 개체를 ToolTip가져오거나 설정합니다.
ToolTipIcon	도구 설명 텍스트와 함께 표시할 아이콘의 형식을 정의하는 값을 가져오거나 설정합니다.
ToolTipTitle	도구 설명 창의 제목을 가져오거나 설정합니다.
UseAnimation	도구 설명을 표시할 때 애니메이션 효과를 사용해야 하는지 여부를 결정하는 값을 가져오거나 설정합니다.
UseFading	도구 설명을 표시할 때 페이드 효과를 사용해야 하는지 여부를 결정하는 값을 가져오거나 설정합니다.

메서드

Name	Description
CanExtend(Object)	도구 설명이 지정된 대상 구성 요소에 extender 속성을 제공할 수 있는지를 반환 true 합니다.
Dispose(Boolean)	관리되지 않는 리소스를 Component 해제하고 관리되는 리소스를 선택적으로 해제합니다.
Finalize()	관리되지 않는 리소스를 해제하고 가비지 수집기에서 회수하기 전에 Cursor 다른 정리 작업을 수행합니다.
GetToolTip(Control)	지정된 컨트롤과 연결된 도구 설명 텍스트를 검색합니다.
Hide(IWin32Window)	지정된 도구 설명 창을 숨깁니다.
RemoveAll()	현재 ToolTip 구성 요소와 연결된 모든 도구 설명 텍스트를 제거합니다.
SetToolTip(Control, String)	도구 설명 텍스트를 지정된 컨트롤과 연결합니다.
Show(String, IWin32Window, Int32, Int32, Int32)	지정된 컨트롤과 연결된 도구 설명 텍스트를 설정한 다음 지정된 상대 위치에 지정된 기간 동안 도구 설명을 표시합니다.
Show(String, IWin32Window, Int32, Int32)	지정된 컨트롤과 연결된 도구 설명 텍스트를 설정한 다음 지정된 상대 위치에 도구 설명을 모듈식으로 표시합니다.
Show(String, IWin32Window, Int32)	지정된 컨트롤과 연결된 도구 설명 텍스트를 설정한 다음 지정된 기간 동안 도구 설명을 표시합니다.
Show(String, IWin32Window, Point, Int32)	지정된 컨트롤과 연결된 도구 설명 텍스트를 설정한 다음 지정된 상대 위치에 지정된 기간 동안 도구 설명을 표시합니다.
Show(String, IWin32Window, Point)	지정된 컨트롤과 연결된 도구 설명 텍스트를 설정한 다음 지정된 상대 위치에 도구 설명을 모듈식으로 표시합니다.
Show(String, IWin32Window)	지정된 컨트롤과 연결된 도구 설명 텍스트를 설정하고 도구 설명을 모듈식으로 표시합니다.
StopTimer()	표시된 도구 설명을 숨기는 타이머를 중지합니다.
ToString()	이 컨트롤에 대한 문자열 표현을 반환합니다.

이벤트

Name	Description
Draw	도구 설명이 그려지고 OwnerDraw 속성이 설정 trueIsBalloon 되고 속성 false이 될 때 발생합니다.
Popup	도구 설명이 처음 표시되기 전에 발생합니다. 클래스의 기본 이벤트입니다 ToolTip .

추가 정보

• ToolTipIcon
• HelpProvider
• Extender 공급자
• 도구 설명 구성 요소(Windows Forms)