ToolTip 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
마우스 포인터를 컨트롤 위에 놓을 때 해당 컨트롤에 대한 간단한 설명을 표시하는 작은 사각형 모양의 팝업 창을 나타냅니다.
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
- 상속
- 구현
예제
다음 코드 예제에서는 클래스의 ToolTip instance 만들고 instance Form instance 만든 에 연결합니다. 그런 다음, 코드는 지연 속성 AutoPopDelay, InitialDelay및 ReshowDelay를 초기화합니다. 또한 클래스 ShowAlways 의 ToolTip instance 설정 합니다 속성 true
은 도구 설명 텍스트 폼이 활성 여부에 관계 없이 항상 표시 될 수 있도록 합니다. 마지막으로 이 예제에서는 도구 설명 텍스트를 폼의 컨트롤 2개( Button 및 )와 CheckBox연결합니다. 이 코드 예제에서는 예제에 정의된 메서드가 라는 컨트롤과 CheckBox 라는 checkBox1
button1
컨트롤이 포함된 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) |
도구 설명에서 지정된 대상 구성 요소에 확장 속성을 제공할 수 있으면 |
CreateObjRef(Type) |
원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject) |
Dispose() |
Component에서 사용하는 모든 리소스를 해제합니다. (다음에서 상속됨 Component) |
Dispose(Boolean) |
Component에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다. |
Dispose(Boolean) |
Component에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다. (다음에서 상속됨 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 속성이 |
Popup |
도구 설명을 처음 표시하기 전에 발생합니다. 이 이벤트는 ToolTip 클래스의 기본 이벤트입니다. |
적용 대상
추가 정보
.NET
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기