ToolTip 클래스

정의

마우스 포인터를 컨트롤 위에 놓을 때 해당 컨트롤에 대한 간단한 설명을 표시하는 작은 사각형 모양의 팝업 창을 나타냅니다.Represents a small rectangular pop-up window that displays a brief description of a control's purpose when the user rests the pointer on the control.

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
상속
구현

예제

인스턴스를 만들고 다음 코드 예제는 ToolTip 클래스 및 사용 하 여 인스턴스를 연결를 Form 인스턴스 내에서 생성 됩니다.The following code example creates an instance of the ToolTip class and associates the instance with the Form that the instance is created within. 코드를 지연 속성을 초기화 한 다음 AutoPopDelay, InitialDelay, 및 ReshowDelay합니다.The code then initializes the delay properties AutoPopDelay, InitialDelay, and ReshowDelay. 또한 인스턴스의 합니다 ToolTip 집합 클래스를 ShowAlways 속성을 true 항상 폼 활성 상태 인지 여부에 관계 없이 표시 되도록 도구 설명 텍스트를 사용 하도록 설정 합니다.In addition the instance of the ToolTip class sets the ShowAlways property to true to enable ToolTip text to always be display regardless of whether the form is active. 이 예제에서는 폼의 두 가지 컨트롤을 사용 하 여 도구 설명 텍스트를 연결 하는 마지막으로 ButtonCheckBox합니다.Finally, the example associates ToolTip text with two controls on a form, a Button and a CheckBox. 이 코드 예제는 예제에 정의 된 메서드 내에 위치한를 Form 를 포함 하는 Button 라는 컨트롤 button1CheckBox 라는 컨트롤 checkBox1, 및 메서드는 생성자에서 호출 되는 Form합니다.The code example requires that the method defined in the example is located within a Form that contains a Button control named button1 and a CheckBox control named checkBox1, and that the method is called from the constructor of the 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 클래스를 제공할 수 있습니다 힌트 사용자 컨트롤에 대 한 포인터를 놓으면 됩니다.With the ToolTip class, you can provide hints to a user when the user places the pointer on a control. ToolTip 클래스 일반적으로 컨트롤의 용도를 사용자에 게 경고를 사용 합니다.The ToolTip class is typically used to alert users to the intended use of a control. 예를 들어 도구 설명 텍스트를 지정할 수 있습니다는 TextBox 컨트롤에 입력할 수 이름의 형식을 지정 하는 이름을 허용 하는 컨트롤입니다.For example, you can specify ToolTip text for a TextBox control that accepts a name, specifying the format of the name to be typed into the control. 힌트를 제공 하는 것 외에도 사용할 수도 있습니다는 ToolTip 런타임 상태 정보를 제공 합니다.In addition to providing hints, you can also use the ToolTip class to provide run time status information. 예를 들어 사용할 수 있습니다 합니다 ToolTip 클래스에 대 한 포인터를 이동할 때 연결 속도 및 줄 품질 데이터를 표시 하는 PictureBox 인터넷 연결 상태를 표시 하는 컨트롤입니다.For example, you can use the ToolTip class to display connection speed and line quality data when the user moves the pointer onto a PictureBox control that displays Internet connection status.

ToolTip 클래스는 모든 컨테이너에서 사용할 수 있습니다.The ToolTip class can be used in any container. 컨테이너를 명시적으로 지정 하려면 사용 된 ToolTip(IContainer) 생성자입니다.To explicitly specify a container, use the ToolTip(IContainer) constructor. 단일 ToolTip 일반적으로 구성 요소를 단일 폼에서 여러 컨트롤에 대 한 도구 설명을 만드는 사용 됩니다.A single ToolTip component typically is used to create ToolTips for multiple controls on a single form. 만든 후는 ToolTip, 별도 호출을 사용 합니다 SetToolTip 개별 컨트롤에 도구 설명 표시 텍스트를 연결 하는 방법입니다.After you create a ToolTip, use a separate call to the SetToolTip method to associate ToolTip display text to an individual control. 컨트롤에 대 한 포인터를 이동할 때 도구 설명 텍스트를 사용 하 여 표시 됩니다.Then when the user moves the pointer on a control, the ToolTip with its text is displayed. 호출할 수 있습니다 SetToolTip 컨트롤과 연결 된 텍스트를 변경 하려면 동일한 컨트롤에 대 한 번 이상.You can call SetToolTip more than once for the same control to change the text that is associated with the control. 컨트롤과 연결 된 텍스트를 가져오려면는 GetToolTip 메서드.To get the text that is associated with a control, use the GetToolTip method. 인스턴스와 연결 된 모든 도구 설명 텍스트를 제거 하는 ToolTip 클래스를 사용 하 여는 RemoveAll 메서드.To remove all ToolTip text associations with an instance of the ToolTip class, use the RemoveAll method.

참고

비활성화 된 컨트롤에 대 한 도구 설명 텍스트를 표시 되지 않습니다.ToolTip text is not displayed for controls that are disabled. 경우가 아니면 합니다 ShowAlways 속성이 true, 컨테이너 비활성 상태일 때 도구 설명이 표시 되지 않습니다.Unless the ShowAlways property is set to true, ToolTips are not displayed when their container is inactive.

ToolTip 클래스는 다음 속성 및 도구 설명의 모양과 기본 동작을 수정 하는 메서드를 제공 합니다.The ToolTip class provides the following properties and methods to modify the default behavior and appearance of a ToolTip.

범주Category 연결 된 멤버Associated members
수동 표시Manual display Active, Show, Hide, ShowAlways, Popup, StopTimerActive, Show, Hide, ShowAlways, Popup, StopTimer
도구 설명 타이밍ToolTip timing AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimerAutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimer
콘텐츠Content SetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAllSetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAll
모양Appearance BackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFadingBackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFading

애플리케이션에서 표시할 수 없습니다 있도록 모든 도구 설명 텍스트를 사용 하지 않도록 설정 하려는 경우 사용할 수 있습니다는 Active 속성입니다.If you want to disable all ToolTip text so that it cannot be displayed in your application, you can use the Active property. 도구 설명의 모양을 사용자 지정할 수 있지만 운영 체제에서 그려지는 일반적으로 ToolTip를 설정할 수 있습니다는 OwnerDraw 속성을 true 하 고 처리를 Draw 이벤트.Usually the ToolTip is drawn by the operating system, but to customize the appearance of the ToolTip, you can set the OwnerDraw property to true and handle the Draw event.

합니다 ToolTipTitle 클래스가 구현 하는 System.ComponentModel.IExtenderProvider 단일 메서드가 들어 있는 인터페이스를 CanExtend합니다.The ToolTipTitle class implements the System.ComponentModel.IExtenderProvider interface, which has a single method, CanExtend. 디자인 타임에 동일한 양식에서 컨트롤을 확장 하는 도구 설명을 추가 ToolTip 속성입니다.ToolTips extend controls on the same form at design time, adding a ToolTip property. Extender 공급자에 대 한 자세한 내용은 참조 하세요. Extender 공급자합니다.For more information about extender providers, see Extender Providers.

생성자

ToolTip()

지정된 컨테이너를 사용하지 않고 ToolTip의 새 인스턴스를 초기화합니다.Initializes a new instance of the ToolTip without a specified container.

ToolTip(IContainer)

지정된 컨테이너를 사용하여 ToolTip 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ToolTip class with a specified container.

속성

Active

도구 설명이 현재 활성화되어 있는지를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the ToolTip is currently active.

AutomaticDelay

도구 설명에 대한 자동 지연 시간을 가져오거나 설정합니다.Gets or sets the automatic delay for the ToolTip.

AutoPopDelay

지정된 도구 설명 텍스트가 있는 컨트롤 위에 포인터가 고정되었을 때 도구 설명이 표시되는 시간을 가져오거나 설정합니다.Gets or sets the period of time the ToolTip remains visible if the pointer is stationary on a control with specified ToolTip text.

BackColor

도구 설명의 배경색을 가져오거나 설정합니다.Gets or sets the background color for the ToolTip.

CanRaiseEvents

구성 요소가 이벤트를 발생시킬 수 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the component can raise an event.

(다음에서 상속됨 Component)
Container

IContainer가 포함된 Component를 가져옵니다.Gets the IContainer that contains the Component.

(다음에서 상속됨 Component)
CreateParams

도구 설명 창의 생성 매개 변수를 가져옵니다.Gets the creation parameters for the ToolTip window.

DesignMode

Component가 현재 디자인 모드인지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the Component is currently in design mode.

(다음에서 상속됨 Component)
Events

Component에 연결된 이벤트 처리기의 목록을 가져옵니다.Gets the list of event handlers that are attached to this Component.

(다음에서 상속됨 Component)
ForeColor

도구 설명의 전경색을 가져오거나 설정합니다.Gets or sets the foreground color for the ToolTip.

InitialDelay

도구 설명이 나타날 때까지 걸리는 시간을 가져오거나 설정합니다.Gets or sets the time that passes before the ToolTip appears.

IsBalloon

도구 설명에 풍선 창을 사용할지를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the ToolTip should use a balloon window.

OwnerDraw

도구 설명을 운영 체제에서 그리는지 아니면 사용자가 제공하는 코드로 그리는지 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the ToolTip is drawn by the operating system or by code that you provide.

ReshowDelay

포인터를 한 컨트롤에서 다른 컨트롤로 이동할 경우 다음 도구 설명 창이 나타나기 전에 경과해야 하는 시간을 가져오거나 설정합니다.Gets or sets the length of time that must transpire before subsequent ToolTip windows appear as the pointer moves from one control to another.

ShowAlways

부모 컨트롤이 활성화되지 않은 경우에도 도구 설명 창이 표시되는지를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether a ToolTip window is displayed, even when its parent control is not active.

Site

ComponentISite를 가져오거나 설정합니다.Gets or sets the ISite of the Component.

(다음에서 상속됨 Component)
StripAmpersands

앰퍼샌드(&) 문자의 처리 방법을 결정하는 값을 가져오거나 설정합니다.Gets or sets a value that determines how ampersand (&) characters are treated.

Tag

ToolTip과 연결된 프로그래머 제공 데이터가 포함된 개체를 가져오거나 설정합니다.Gets or sets the object that contains programmer-supplied data associated with the ToolTip.

ToolTipIcon

도구 설명 텍스트와 함께 표시되는 아이콘의 형식을 정의하는 값을 가져오거나 설정합니다.Gets or sets a value that defines the type of icon to be displayed alongside the ToolTip text.

ToolTipTitle

도구 설명 창의 제목을 가져오거나 설정합니다.Gets or sets a title for the ToolTip window.

UseAnimation

도구 설명을 표시할 때 애니메이션 효과를 사용할지를 결정하는 값을 가져오거나 설정합니다.Gets or sets a value determining whether an animation effect should be used when displaying the ToolTip.

UseFading

도구 설명을 표시할 때 페이드 효과를 사용할지를 결정하는 값을 가져오거나 설정합니다.Gets or sets a value determining whether a fade effect should be used when displaying the ToolTip.

메서드

CanExtend(Object)

도구 설명에서 지정된 대상 구성 요소에 확장 속성을 제공할 수 있으면 true를 반환합니다.Returns true if the ToolTip can offer an extender property to the specified target component.

CreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(다음에서 상속됨 MarshalByRefObject)
Dispose()

Component에서 사용하는 모든 리소스를 해제합니다.Releases all resources used by the Component.

(다음에서 상속됨 Component)
Dispose(Boolean)

Component에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
Finalize()

가비지 수집기에서 Cursor를 회수하기 전에 관리되지 않는 리소스를 해제하고 기타 정리 작업을 수행합니다.Releases the unmanaged resources and performs other cleanup operations before the Cursor is reclaimed by the garbage collector.

GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetLifetimeService()

이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(다음에서 상속됨 MarshalByRefObject)
GetService(Type)

Component 또는 해당 Container에서 제공하는 서비스를 나타내는 개체를 반환합니다.Returns an object that represents a service provided by the Component or by its Container.

(다음에서 상속됨 Component)
GetToolTip(Control)

지정된 컨트롤과 연결된 도구 설명 텍스트를 검색합니다.Retrieves the ToolTip text associated with the specified control.

GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
Hide(IWin32Window)

지정된 도구 설명 창을 숨깁니다.Hides the specified ToolTip window.

InitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.Obtains a lifetime service object to control the lifetime policy for this instance.

(다음에서 상속됨 MarshalByRefObject)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
MemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.Creates a shallow copy of the current MarshalByRefObject object.

(다음에서 상속됨 MarshalByRefObject)
RemoveAll()

현재 이 도구 설명 구성 요소와 연결된 도구 설명 텍스트를 모두 제거합니다.Removes all ToolTip text currently associated with the ToolTip component.

SetToolTip(Control, String)

도구 설명 텍스트를 지정된 컨트롤과 연결시킵니다.Associates ToolTip text with the specified control.

Show(String, IWin32Window)

지정된 컨트롤과 연결된 도구 설명 텍스트를 설정한 다음 도구 설명을 모달 형식으로 표시합니다.Sets the ToolTip text associated with the specified control, and displays the ToolTip modally.

Show(String, IWin32Window, Int32)

지정된 컨트롤과 연결된 도구 설명 텍스트를 설정한 다음 지정된 시간 동안 도구 설명을 표시합니다.Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration.

Show(String, IWin32Window, Int32, Int32)

지정된 컨트롤과 연결된 도구 설명 텍스트를 설정한 다음 지정된 상대적 위치에 도구 설명을 모달 형식으로 표시합니다.Sets the ToolTip text associated with the specified control, and then displays the ToolTip modally at the specified relative position.

Show(String, IWin32Window, Int32, Int32, Int32)

지정된 컨트롤과 연결된 도구 설명 텍스트를 설정한 다음 지정된 상대적 위치에 지정된 시간 동안 도구 설명을 모달 형식으로 표시합니다.Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration at the specified relative position.

Show(String, IWin32Window, Point)

지정된 컨트롤과 연결된 도구 설명 텍스트를 설정한 다음 지정된 상대적 위치에 도구 설명을 모달 형식으로 표시합니다.Sets the ToolTip text associated with the specified control, and then displays the ToolTip modally at the specified relative position.

Show(String, IWin32Window, Point, Int32)

지정된 컨트롤과 연결된 도구 설명 텍스트를 설정한 다음 지정된 상대적 위치에 지정된 시간 동안 도구 설명을 모달 형식으로 표시합니다.Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration at the specified relative position.

StopTimer()

표시된 도구 설명을 숨기는 타이머를 중지합니다.Stops the timer that hides displayed ToolTips.

ToString()

이 컨트롤에 대한 문자열 표현을 반환합니다.Returns a string representation for this control.

이벤트

Disposed

Dispose() 메서드를 호출하여 구성 요소가 삭제되는 경우 발생합니다.Occurs when the component is disposed by a call to the Dispose() method.

(다음에서 상속됨 Component)
Draw

OwnerDraw 속성이 true로 설정되고 IsBalloon 속성이 false인 경우에 도구 설명을 그리면 발생합니다.Occurs when the ToolTip is drawn and the OwnerDraw property is set to true and the IsBalloon property is false.

Popup

도구 설명을 처음 표시하기 전에 발생합니다.Occurs before a ToolTip is initially displayed. 이 이벤트는 ToolTip 클래스의 기본 이벤트입니다.This is the default event for the ToolTip class.

적용 대상

추가 정보