ToolTip 클래스

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

마우스 포인터를 컨트롤 위에 놓을 때 해당 컨트롤에 대한 간단한 설명을 표시하는 작은 사각형 모양의 팝업 창을 나타냅니다.

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 instance 만들고 instance Form instance 만든 에 연결합니다. 그런 다음, 코드는 지연 속성 AutoPopDelay, InitialDelay및 ReshowDelay를 초기화합니다. 또한 클래스 ShowAlways 의 ToolTip instance 설정 합니다 속성 true 은 도구 설명 텍스트 폼이 활성 여부에 관계 없이 항상 표시 될 수 있도록 합니다. 마지막으로 이 예제에서는 도구 설명 텍스트를 폼의 컨트롤 2개( Button 및 )와 CheckBox연결합니다. 이 코드 예제에서는 예제에 정의된 메서드가 라는 컨트롤과 CheckBox 라는 checkBox1button1 컨트롤이 포함된 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 instance 모든 ToolTip 텍스트 연결을 제거하려면 메서드를 RemoveAll 사용합니다.

참고

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

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

범주	연결된 멤버
수동 디스플레이	Active, Show, Hide, ShowAlways, Popup, StopTimer
도구 설명 타이밍	AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimer
Content	SetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAll
모양	BackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFading

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

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

생성자

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

속성

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

메서드

CanExtend(Object)	도구 설명에서 지정된 대상 구성 요소에 확장 속성을 제공할 수 있으면 true를 반환합니다.
CreateObjRef(Type)	원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject)
Dispose()	Component에서 사용하는 모든 리소스를 해제합니다. (다음에서 상속됨 Component)
Dispose(Boolean)	Component에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
Finalize()	가비지 수집기에서 Cursor를 회수하기 전에 관리되지 않는 리소스를 해제하고 기타 정리 작업을 수행합니다.
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetLifetimeService()	이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다. (다음에서 상속됨 MarshalByRefObject)
GetService(Type)	Component 또는 해당 Container에서 제공하는 서비스를 나타내는 개체를 반환합니다. (다음에서 상속됨 Component)
GetToolTip(Control)	지정된 컨트롤과 연결된 도구 설명 텍스트를 검색합니다.
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
Hide(IWin32Window)	지정된 도구 설명 창을 숨깁니다.
InitializeLifetimeService()	이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다. (다음에서 상속됨 MarshalByRefObject)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
MemberwiseClone(Boolean)	현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다. (다음에서 상속됨 MarshalByRefObject)
RemoveAll()	현재 이 도구 설명 구성 요소와 연결된 도구 설명 텍스트를 모두 제거합니다.
SetToolTip(Control, String)	도구 설명 텍스트를 지정된 컨트롤과 연결시킵니다.
Show(String, IWin32Window)	지정된 컨트롤과 연결된 도구 설명 텍스트를 설정한 다음 도구 설명을 모달 형식으로 표시합니다.
Show(String, IWin32Window, Int32)	지정된 컨트롤과 연결된 도구 설명 텍스트를 설정한 다음 지정된 시간 동안 도구 설명을 표시합니다.
Show(String, IWin32Window, Int32, Int32)	지정된 컨트롤과 연결된 도구 설명 텍스트를 설정한 다음 지정된 상대적 위치에 도구 설명을 모달 형식으로 표시합니다.
Show(String, IWin32Window, Int32, Int32, Int32)	지정된 컨트롤과 연결된 도구 설명 텍스트를 설정한 다음 지정된 상대적 위치에 지정된 시간 동안 도구 설명을 모달 형식으로 표시합니다.
Show(String, IWin32Window, Point)	지정된 컨트롤과 연결된 도구 설명 텍스트를 설정한 다음 지정된 상대적 위치에 도구 설명을 모달 형식으로 표시합니다.
Show(String, IWin32Window, Point, Int32)	지정된 컨트롤과 연결된 도구 설명 텍스트를 설정한 다음 지정된 상대적 위치에 지정된 시간 동안 도구 설명을 모달 형식으로 표시합니다.
StopTimer()	표시된 도구 설명을 숨기는 타이머를 중지합니다.
ToString()	이 컨트롤에 대한 문자열 표현을 반환합니다.

이벤트

Disposed	Dispose() 메서드를 호출하여 구성 요소를 삭제할 때 발생합니다. (다음에서 상속됨 Component)
Draw	OwnerDraw 속성이 true로 설정되고 IsBalloon 속성이 false인 경우에 도구 설명을 그리면 발생합니다.
Popup	도구 설명을 처음 표시하기 전에 발생합니다. 이 이벤트는 ToolTip 클래스의 기본 이벤트입니다.

추가 정보

• ToolTipIcon
• HelpProvider
• Extender 공급자
• ToolTip 구성 요소(Windows Forms)