CToolTipCtrl 수업

애플리케이션에서 도구의 용도를 설명하는 한 줄의 텍스트를 표시하는 작은 팝업 창인 "도구 설명 컨트롤"의 기능을 캡슐화합니다.

구문

class CToolTipCtrl : public CWnd

멤버

공용 생성자

속성	설명
CToolTipCtrl::CToolTipCtrl	CToolTipCtrl 개체를 생성합니다.

공용 메서드

이름	설명
CToolTipCtrl::Activate	도구 설명 컨트롤을 활성화하고 비활성화합니다.
CToolTipCtrl::AddTool	도구 설명 컨트롤에 도구를 등록합니다.
CToolTipCtrl::AdjustRect	도구 설명 컨트롤의 텍스트 표시 사각형과 창 사각형 사이를 변환합니다.
CToolTipCtrl::Create	도구 설명 컨트롤을 만들어 개체에 CToolTipCtrl 연결합니다.
CToolTipCtrl::CreateEx	지정된 Windows 확장 스타일을 사용하여 도구 설명 컨트롤을 만들고 개체에 CToolTipCtrl 연결합니다.
CToolTipCtrl::DelTool	도구 설명 컨트롤에서 도구를 제거합니다.
CToolTipCtrl::GetBubbleSize	도구 설명의 크기를 검색합니다.
CToolTipCtrl::GetCurrentTool	현재 도구 설명 컨트롤이 표시하는 도구 설명 창의 크기, 위치 및 텍스트와 같은 정보를 검색합니다.
CToolTipCtrl::GetDelayTime	도구 설명 컨트롤에 대해 현재 설정된 초기, 팝업 및 다시 표시 기간을 검색합니다.
CToolTipCtrl::GetMargin	도구 설명 창에 대해 설정된 위쪽, 왼쪽, 아래쪽 및 오른쪽 여백을 검색합니다.
CToolTipCtrl::GetMaxTipWidth	도구 설명 창의 최대 너비를 검색합니다.
CToolTipCtrl::GetText	도구 설명 컨트롤이 도구에 대해 유지 관리하는 텍스트를 검색합니다.
CToolTipCtrl::GetTipBkColor	도구 설명 창에서 배경색을 검색합니다.
CToolTipCtrl::GetTipTextColor	도구 설명 창에서 텍스트 색을 검색합니다.
CToolTipCtrl::GetTitle	현재 도구 설명 컨트롤의 제목을 검색합니다.
CToolTipCtrl::GetToolCount	도구 설명 컨트롤에서 유지 관리하는 도구 수를 검색합니다.
CToolTipCtrl::GetToolInfo	도구 설명 컨트롤이 도구에 대해 유지 관리하는 정보를 검색합니다.
CToolTipCtrl::HitTest	점을 테스트하여 지정된 도구의 경계 사각형 내에 있는지 여부를 확인합니다. 그렇다면 도구에 대한 정보를 검색합니다.
CToolTipCtrl::Pop	표시된 도구 설명 창을 보기에서 제거합니다.
CToolTipCtrl::Popup	현재 도구 설명 컨트롤이 마지막 마우스 메시지의 좌표에 표시되도록 합니다.
CToolTipCtrl::RelayEvent	처리를 위해 도구 설명 컨트롤에 마우스 메시지를 전달합니다.
CToolTipCtrl::SetDelayTime	도구 설명 컨트롤의 초기, 팝업 및 다시 표시 기간을 설정합니다.
CToolTipCtrl::SetMargin	도구 설명 창의 위쪽, 왼쪽, 아래쪽 및 오른쪽 여백을 설정합니다.
CToolTipCtrl::SetMaxTipWidth	도구 설명 창의 최대 너비를 설정합니다.
CToolTipCtrl::SetTipBkColor	도구 설명 창의 배경색을 설정합니다.
CToolTipCtrl::SetTipTextColor	도구 설명 창의 텍스트 색을 설정합니다.
CToolTipCtrl::SetTitle	도구 설명에 표준 아이콘과 제목 문자열을 추가합니다.
CToolTipCtrl::SetToolInfo	도구 설명이 도구에 대해 유지 관리하는 정보를 설정합니다.
CToolTipCtrl::SetToolRect	도구에 대한 새 경계 사각형을 설정합니다.
CToolTipCtrl::SetWindowTheme	도구 설명 창의 비주얼 스타일을 설정합니다.
CToolTipCtrl::Update	현재 도구를 다시 그려야 합니다.
CToolTipCtrl::UpdateTipText	도구의 도구 설명 텍스트를 설정합니다.

설명

"도구"는 자식 창 또는 컨트롤과 같은 창 또는 창의 클라이언트 영역 내에서 애플리케이션 정의 사각형 영역입니다. 도구 설명은 사용자가 도구에 커서를 놓고 약 1/2초 동안 그대로 두는 경우에만 나타나는 대부분의 경우 숨겨집니다. 도구 설명은 커서 근처에 나타나고 사용자가 마우스 단추를 클릭하거나 도구에서 커서를 이동하면 사라집니다.

CToolTipCtrl 에서는 도구 설명의 초기 시간과 지속 시간, 도구 설명 텍스트를 둘러싼 여백 너비, 도구 설명 창 자체의 너비, 도구 설명의 배경 및 텍스트 색을 제어하는 기능을 제공합니다. 단일 도구 설명 컨트롤은 둘 이상의 도구에 대한 정보를 제공할 수 있습니다.

이 클래스는 CToolTipCtrl Windows 공통 도구 설명 컨트롤의 기능을 제공합니다. 이 컨트롤(따라서 CToolTipCtrl 클래스)은 Windows 95/98 및 Windows NT 버전 3.51 이상에서 실행되는 프로그램에서만 사용할 수 있습니다.

도구 설명을 사용하도록 설정하는 방법에 대한 자세한 내용은 파생되지 CFrameWnd않은 Windows의 도구 팁을 참조하세요.

사용 CToolTipCtrl방법에 대한 자세한 내용은 컨트롤 및 사용을 CToolTipCtrl참조하세요.

상속 계층 구조

CObject

CCmdTarget

CWnd

CToolTipCtrl

요구 사항

머리글: afxcmn.h

CToolTipCtrl::Activate

도구 설명 컨트롤을 활성화하거나 비활성화하려면 이 함수를 호출합니다.

void Activate(BOOL bActivate);

매개 변수

bActivate
도구 설명 컨트롤을 활성화할지 비활성화할지 여부를 지정합니다.

설명

이 TRUE경우 bActivate 컨트롤이 활성화되고, 이 경우 FALSE비활성화됩니다.

도구 설명 컨트롤이 활성화되면 커서가 컨트롤에 등록된 도구에 있을 때 도구 설명 정보가 나타납니다. 비활성 상태이면 커서가 도구에 있는 경우에도 도구 설명 정보가 표시되지 않습니다.

예시

CPropertySheet::GetTabControl에 대한 예를 참조하세요.

CToolTipCtrl::AddTool

도구 설명 컨트롤에 도구를 등록합니다.

BOOL AddTool(
    CWnd* pWnd,
    UINT nIDText,
    LPCRECT lpRectTool = NULL,
    UINT_PTR nIDTool = 0);

BOOL AddTool(
    CWnd* pWnd,
    LPCTSTR lpszText = LPSTR_TEXTCALLBACK,
    LPCRECT lpRectTool = NULL,
    UINT_PTR nIDTool = 0);

매개 변수

pWnd
도구가 포함된 창에 대한 포인터입니다.

nIDText
도구의 텍스트를 포함하는 문자열 리소스의 ID입니다.

lpRectTool
RECT 도구 경계 사각형의 좌표를 포함하는 구조체에 대한 포인터입니다. 좌표는 로 식별되는 pWnd창의 클라이언트 영역의 왼쪽 위 모서리를 기준으로 합니다.

nIDTool
도구의 ID입니다.

lpszText
도구의 텍스트에 대한 포인터입니다. 이 매개 변수에 값 LPSTR_TEXTCALLBACKTTN_NEEDTEXT 이 포함된 경우 알림 메시지는 가리키는 창 pWnd 의 부모로 이동합니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

설명

매개 변수와 매개 변수는 lpRectTool 모두 유효해야 합니다. 그렇지 않으면 lpRectTool NULLnIDTool 0이어야 합니다.nIDTool

도구 설명 컨트롤을 둘 이상의 도구와 연결할 수 있습니다. 도구 설명 컨트롤에 도구를 등록하려면 이 함수를 호출하여 도구 설명에 저장된 정보가 도구에 있을 때 표시됩니다.

참고 항목

를 사용하여 AddTool도구 설명을 정적 컨트롤로 설정할 수 없습니다.

예시

CPropertySheet::GetTabControl에 대한 예를 참조하세요.

CToolTipCtrl::AdjustRect

도구 설명 컨트롤의 텍스트 표시 사각형과 창 사각형 사이를 변환합니다.

BOOL AdjustRect(
    LPRECT lprc,
    BOOL bLarger = TRUE);

매개 변수

lprc
RECT 도구 설명 창 사각형 또는 텍스트 표시 사각형을 포함하는 구조체에 대한 포인터입니다.

bLarger
lprc 이면 TRUE텍스트 표시 사각형을 지정하는 데 사용되며 해당 창 사각형을 받습니다. lprc 이면 FALSE창 사각형을 지정하는 데 사용되며 해당 텍스트 표시 사각형을 받습니다.

Return Value

사각형이 성공적으로 조정된 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

이 멤버 함수는 창 사각형에서 도구 설명 컨트롤의 텍스트 표시 사각형을 계산하거나 지정된 텍스트 표시 사각형을 표시하는 데 필요한 도구 설명 창 사각형을 계산합니다.

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TTM_ADJUSTRECT의 동작을 구현합니다.

CToolTipCtrl::Create

도구 설명 컨트롤을 만들어 개체에 CToolTipCtrl 연결합니다.

virtual BOOL Create(CWnd* pParentWnd, DWORD dwStyle = 0);

매개 변수

pParentWnd
도구 설명 컨트롤의 부모 창(일반적으로 .)을 CDialog지정합니다. 해서는 안 됩니다 NULL.

dwStyle
도구 설명 컨트롤의 스타일을 지정합니다. 자세한 내용은 설명 부분을 참조하세요.

Return Value

개체가 CToolTipCtrl 성공적으로 만들어지면 0이 아니고, 그렇지 않으면 0입니다.

설명

두 단계로 구성 CToolTipCtrl 합니다. 먼저 생성자를 호출하여 개체를 CToolTipCtrl 생성한 다음, 도구 설명 컨트롤을 만들어 개체에 CToolTipCtrl 연결하도록 호출 Create 합니다.

매개 변수는 dwStyle 창 스타일의 조합 일 수 있습니다. 또한 도구 설명 컨트롤에는 두 가지 클래스별 스타일 TTS_ALWAYSTIP 과 .TTS_NOPREFIX

스타일	의미
TTS_ALWAYSTIP	도구 설명 컨트롤의 소유자 창이 활성인지 비활성 상태인지에 관계없이 도구 설명이 도구에 있을 때 표시되도록 지정합니다. 이 스타일이 없으면 도구 설명 컨트롤은 도구의 소유자 창이 활성 상태일 때 표시되지만 비활성 상태일 때는 나타나지 않습니다.
TTS_NOPREFIX	이 스타일을 사용하면 시스템에서 문자열에서 앰퍼샌드(&) 문자를 제거할 수 없습니다. 도구 설명 컨트롤에 스타일이 TTS_NOPREFIX 없으면 시스템에서 앰퍼샌드 문자를 자동으로 제거하여 애플리케이션이 메뉴 항목과 도구 설명 컨트롤의 텍스트 모두와 동일한 문자열을 사용할 수 있도록 합니다.

도구 설명 컨트롤에는 컨트롤을 WS_POPUP 만들 때 지정할지 여부에 관계없이 창 스타일과 WS_EX_TOOLWINDOW 창 스타일이 있습니다.

확장 창 스타일을 사용하여 도구 설명 컨트롤을 만들려면 대신 호출 CToolTipCtrl::CreateEx 합니다 Create.

예시

CPropertySheet::GetTabControl에 대한 예를 참조하세요.

CToolTipCtrl::CreateEx

컨트롤(자식 창)을 만들어 개체와 연결 CToolTipCtrl 합니다.

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwStyle = 0,
    DWORD dwStyleEx = 0);

매개 변수

pParentWnd
컨트롤의 부모 창에 대한 포인터입니다.

dwStyle
도구 설명 컨트롤의 스타일을 지정합니다. 자세한 내용은 주의 섹션 Create 을 참조하세요.

dwStyleEx
만들 컨트롤의 확장 스타일을 지정합니다. 확장된 Windows 스타일 목록은 Windows SDK의 매개 변수 CreateWindowEx 를 참조 dwExStyle 하세요.

Return Value

성공하면 0이 아닌 경우 0입니다.

설명

Windows 확장 스타일 서문WS_EX_으로 지정된 확장 Windows 스타일을 적용하는 대신 Create 사용합니다CreateEx.

CToolTipCtrl::CToolTipCtrl

CToolTipCtrl 개체를 생성합니다.

CToolTipCtrl();

설명

개체를 생성한 후 호출 Create 해야 합니다.

예시

// Declare a CToolTipCtrl object.
CToolTipCtrl m_ToolTipCtrl;

CToolTipCtrl::DelTool

도구 설명 컨트롤에서 지원하는 도구 컬렉션에서 지정 pWnd nIDTool 한 도구를 제거합니다.

void DelTool(
    CWnd* pWnd,
    UINT_PTR nIDTool = 0);

매개 변수

pWnd
도구가 포함된 창에 대한 포인터입니다.

nIDTool
도구의 ID입니다.

CToolTipCtrl::GetBubbleSize

도구 설명의 크기를 검색합니다.

CSize GetBubbleSize(LPTOOLINFO lpToolInfo) const;

매개 변수

lpToolInfo
도구 설명의 구조에 대한 포인터입니다 TOOLINFO .

Return Value

도구 설명의 크기입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TTM_GETBUBBLESIZE의 동작을 구현합니다.

CToolTipCtrl::GetCurrentTool

현재 도구 설명 컨트롤에 표시되는 도구 설명 창의 크기, 위치 및 텍스트와 같은 정보를 검색합니다.

BOOL GetCurrentTool(LPTOOLINFO lpToolInfo) const;

매개 변수

lpToolInfo
[out] TOOLINFO 현재 도구 설명 창에 대한 정보를 받는 구조체에 대한 포인터입니다.

Return Value

TRUE정보가 성공적으로 검색되면 FALSE

설명

이 메서드는 TTM_GETCURRENTTOOL Windows SDK에 설명된 메시지를 보냅니다.

예시

다음 코드 예제에서는 현재 도구 설명 창에 대 한 정보를 검색 합니다.

{
    //Get information about the current tooltip. 
    TOOLINFO tInfo = {0};
    tInfo.cbSize = sizeof(TOOLINFO);
    CToolBarCtrl& m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
    CToolTipCtrl* m_toolTip = m_toolBarCtrl.GetToolTips();
    BOOL bRet = m_toolTip->GetCurrentTool( &tInfo );
}

CToolTipCtrl::GetDelayTime

도구 설명 컨트롤에 대해 현재 설정된 초기, 팝업 및 다시 표시 기간을 검색합니다.

int GetDelayTime(DWORD dwDuration) const;

매개 변수

dwDuration
검색할 기간 값을 지정하는 플래그입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

• TTDT_AUTOPOP 포인터가 도구의 경계 사각형 내에 고정되어 있는 경우 도구 설명 창이 표시되는 기간을 검색합니다.

• TTDT_INITIAL 도구 설명 창이 나타나기 전에 포인터가 도구의 경계 사각형 내에서 고정된 상태로 유지되어야 하는 시간을 검색합니다.

• TTDT_RESHOW 포인터가 한 도구에서 다른 도구로 이동할 때 후속 도구 설명 창이 표시되는 데 걸리는 시간을 검색합니다.

Return Value

지정된 지연 시간(밀리초)

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TTM_GETDELAYTIME의 동작을 구현합니다.

CToolTipCtrl::GetMargin

도구 설명 창에 대해 설정된 위쪽, 왼쪽, 아래쪽 및 오른쪽 여백을 검색합니다.

void GetMargin(LPRECT lprc) const;

매개 변수

lprc
RECT 여백 정보를 받을 구조체의 주소입니다. 구조체의 RECT 멤버는 경계 사각형을 정의하지 않습니다. 이 메시지의 목적을 위해 구조체 멤버는 다음과 같이 해석됩니다.

멤버	표현
top	위쪽 테두리와 도구 설명 텍스트 위쪽 사이의 거리(픽셀)입니다.
left	팁 텍스트의 왼쪽 테두리와 왼쪽 끝 사이의 거리(픽셀)입니다.
bottom	아래쪽 테두리와 팁 텍스트 아래쪽 사이의 거리(픽셀)입니다.
right	오른쪽 테두리와 팁 텍스트의 오른쪽 끝 사이의 거리(픽셀)입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TTM_GETMARGIN의 동작을 구현합니다.

CToolTipCtrl::GetMaxTipWidth

도구 설명 창의 최대 너비를 검색합니다.

int GetMaxTipWidth() const;

Return Value

도구 설명 창의 최대 너비입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TTM_GETMAXTIPWIDTH의 동작을 구현합니다.

CToolTipCtrl::GetText

도구 설명 컨트롤이 도구에 대해 유지 관리하는 텍스트를 검색합니다.

void GetText(
    CString& str,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0) const;

매개 변수

str
CString 도구의 텍스트를 받는 개체에 대한 참조입니다.

pWnd
도구가 포함된 창에 대한 포인터입니다.

nIDTool
도구의 ID입니다.

설명

및 nIDTool 매개 변수는 pWnd 도구를 식별합니다. 해당 도구가 이전에 호출을 통해 도구 설명 컨트롤에 CToolTipCtrl::AddTool등록된 경우 매개 변수에서 참조하는 개체에 str 도구의 텍스트가 할당됩니다.

CToolTipCtrl::GetTipBkColor

도구 설명 창에서 배경색을 검색합니다.

COLORREF GetTipBkColor() const;

Return Value

COLORREF 배경색을 나타내는 값입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TTM_GETTIPBKCOLOR의 동작을 구현합니다.

CToolTipCtrl::GetTipTextColor

도구 설명 창에서 텍스트 색을 검색합니다.

COLORREF GetTipTextColor() const;

Return Value

COLORREF 텍스트 색을 나타내는 값입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TTM_GETTIPTEXTCOLOR의 동작을 구현합니다.

CToolTipCtrl::GetTitle

현재 도구 설명 컨트롤의 제목을 검색합니다.

void GetTitle(PTTGETTITLE pttgt) const;

매개 변수

pttgt
[out] TTGETTITLE 도구 설명 컨트롤에 대한 정보를 포함하는 구조체에 대한 포인터입니다. 이 메서드가 반환되면 pszTitle 구조체의 멤버가 TTGETTITLE 제목 텍스트를 가리킵니다.

설명

이 메서드는 TTM_GETTITLE Windows SDK에 설명된 메시지를 보냅니다.

CToolTipCtrl::GetToolCount

도구 설명 컨트롤에 등록된 도구 수를 검색합니다.

int GetToolCount() const;

Return Value

도구 설명 컨트롤에 등록된 도구 수입니다.

CToolTipCtrl::GetToolInfo

도구 설명 컨트롤이 도구에 대해 유지 관리하는 정보를 검색합니다.

BOOL GetToolInfo(
    CToolInfo& ToolInfo,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0) const;

매개 변수

ToolInfo
TOOLINFO 도구의 텍스트를 받는 개체에 대한 참조입니다.

pWnd
도구가 포함된 창에 대한 포인터입니다.

nIDTool
도구의 ID입니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

설명

hwnd 도구를 식별하여 TOOLINFO CToolInfo 참조하는 구조체의 멤버 및 uId 멤버입니다. 해당 도구가 이전 호출을 통해 도구 설명 컨트롤에 AddToolTOOLINFO 등록된 경우 구조는 도구에 대한 정보로 채워집니다.

CToolTipCtrl::HitTest

점을 테스트하여 지정된 도구의 경계 사각형 내에 있는지 여부를 확인하고, 있는 경우 도구에 대한 정보를 검색합니다.

BOOL HitTest(
    CWnd* pWnd,
    CPoint pt,
    LPTOOLINFO lpToolInfo) const;

매개 변수

pWnd
도구가 포함된 창에 대한 포인터입니다.

pt
테스트할 CPoint 점의 좌표를 포함하는 개체에 대한 포인터입니다.

lpToolInfo
도구에 TOOLINFO 대한 정보를 포함하는 구조체에 대한 포인터입니다.

Return Value

적중 테스트 정보로 지정된 점이 도구의 경계 사각형 내에 있으면 0이 아닌 경우 그렇지 않으면 0입니다.

설명

이 함수가 0이 아닌 값을 반환하면 가리키는 lpToolInfo 구조체가 해당 사각형 내의 도구에 대한 정보로 채워집니다.

구조체 TTHITTESTINFO 는 다음과 같이 정의됩니다.

typedef struct _TT_HITTESTINFO { // tthti
    HWND hwnd;   // handle of tool or window with tool
    POINT pt;    // client coordinates of point to test
    TOOLINFO ti; // receives information about the tool
} TTHITTESTINFO, FAR * LPHITTESTINFO;

• hwnd

  도구의 핸들을 지정합니다.

• pt

  점이 도구의 경계 사각형에 있는 경우 점의 좌표를 지정합니다.

• ti

  도구에 대한 정보입니다. 구조에 대한 자세한 내용은 다음을 TOOLINFO 참조하세요 CToolTipCtrl::GetToolInfo.

CToolTipCtrl::Pop

보기에서 표시된 도구 설명 창을 제거합니다.

void Pop();

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TTM_POP의 동작을 구현합니다.

CToolTipCtrl::Popup

현재 도구 설명 컨트롤이 마지막 마우스 메시지의 좌표에 표시되도록 합니다.

void Popup();

설명

이 메서드는 TTM_POPUP Windows SDK에 설명된 메시지를 보냅니다.

예시

다음 코드 예제에서는 도구 설명 창을 표시합니다.

{
   // Display the most recent tooltip.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   CToolTipCtrl *m_toolTip = m_toolBarCtrl.GetToolTips();
   m_toolTip->Popup();
}

CToolTipCtrl::RelayEvent

처리를 위해 도구 설명 컨트롤에 마우스 메시지를 전달합니다.

void RelayEvent(LPMSG lpMsg);

매개 변수

lpMsg
릴레이할 MSG 메시지를 포함하는 구조체에 대한 포인터입니다.

설명

도구 설명 컨트롤은 다음 메시지만 처리합니다. 이 메시지는 다음에 의해 RelayEvent전송됩니다.

WM_LBUTTONDOWN	WM_MOUSEMOVE
WM_LBUTTONUP	WM_RBUTTONDOWN
WM_MBUTTONDOWN	WM_RBUTTONUP
WM_MBUTTONUP

예시

CPropertySheet::GetTabControl에 대한 예를 참조하세요.

CToolTipCtrl::SetDelayTime

도구 설명 컨트롤의 지연 시간을 설정합니다.

void SetDelayTime(UINT nDelay);

void SetDelayTime(
    DWORD dwDuration,
    int iTime);

매개 변수

nDelay
새 지연 시간을 밀리초 단위로 지정합니다.

dwDuration
검색할 기간 값을 지정하는 플래그입니다. 유효한 값에 대한 설명은 참조 CToolTipCtrl::GetDelayTime 하세요.

iTime
지정된 지연 시간(밀리초)입니다.

설명

지연 시간은 도구 설명 창이 나타나기 전에 커서가 도구에 남아 있어야 하는 시간입니다. 기본 지연 시간은 500밀리초입니다.

CToolTipCtrl::SetMargin

도구 설명 창의 위쪽, 왼쪽, 아래쪽 및 오른쪽 여백을 설정합니다.

void SetMargin(LPRECT lprc);

매개 변수

lprc
RECT 설정할 여백 정보를 포함하는 구조체의 주소입니다. 구조체의 RECT 멤버는 경계 사각형을 정의하지 않습니다. 여백 정보에 대한 설명은 참조 CToolTipCtrl::GetMargin 하세요.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TTM_SETMARGIN의 동작을 구현합니다.

CToolTipCtrl::SetMaxTipWidth

도구 설명 창의 최대 너비를 설정합니다.

int SetMaxTipWidth(int iWidth);

매개 변수

iWidth
설정할 최대 도구 설명 창 너비입니다.

Return Value

이전의 최대 팁 너비입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TTM_SETMAXTIPWIDTH의 동작을 구현합니다.

CToolTipCtrl::SetTipBkColor

도구 설명 창의 배경색을 설정합니다.

void SetTipBkColor(COLORREF clr);

매개 변수

clr
새 배경색입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TTM_SETTIPBKCOLOR의 동작을 구현합니다.

CToolTipCtrl::SetTipTextColor

도구 설명 창의 텍스트 색을 설정합니다.

void SetTipTextColor(COLORREF clr);

매개 변수

clr
새 텍스트 색입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TTM_SETTIPTEXTCOLOR의 동작을 구현합니다.

CToolTipCtrl::SetTitle

도구 설명에 표준 아이콘과 제목 문자열을 추가합니다.

BOOL SetTitle(
    UINT uIcon,
    LPCTSTR lpstrTitle);

매개 변수

uIcon
Windows SDK에서 TTM_SETTITLE 참조 icon 하세요.

lpstrTitle
제목 문자열에 대한 포인터입니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TTM_SETTITLE의 동작을 구현합니다.

CToolTipCtrl::SetToolInfo

도구 설명이 도구에 대해 유지 관리하는 정보를 설정합니다.

void SetToolInfo(LPTOOLINFO lpToolInfo);

매개 변수

lpToolInfo
설정할 정보를 지정하는 구조체에 대한 포인터 TOOLINFO 입니다.

CToolTipCtrl::SetToolRect

도구에 대한 새 경계 사각형을 설정합니다.

void SetToolRect(
    CWnd* pWnd,
    UINT_PTR nIDTool,
    LPCRECT lpRect);

매개 변수

pWnd
도구가 포함된 창에 대한 포인터입니다.

nIDTool
도구의 ID입니다.

lpRect
새 경계 사각형을 RECT 지정하는 구조체에 대한 포인터입니다.

CToolTipCtrl::SetWindowTheme

도구 설명 창의 비주얼 스타일을 설정합니다.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

매개 변수

pszSubAppName
설정할 비주얼 스타일을 포함하는 유니코드 문자열에 대한 포인터입니다.

Return Value

반환 값은 사용되지 않습니다.

설명

이 멤버 함수는 Windows SDK에 TTM_SETWINDOWTHEME 설명된 대로 메시지의 기능을 에뮬레이트합니다.

CToolTipCtrl::Update

현재 도구를 다시 그려야 합니다.

void Update();

CToolTipCtrl::UpdateTipText

이 컨트롤의 도구에 대한 도구 설명 텍스트를 업데이트합니다.

void UpdateTipText(
    LPCTSTR lpszText,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0);

void UpdateTipText(
    UINT nIDText,
    CWnd* pWnd,
    UINT_PTR nIDTool = 0);

매개 변수

lpszText
도구의 텍스트에 대한 포인터입니다.

pWnd
도구가 포함된 창에 대한 포인터입니다.

nIDTool
도구의 ID입니다.

nIDText
도구의 텍스트를 포함하는 문자열 리소스의 ID입니다.

참고 항목

CWnd 클래스
계층 구조 차트
CToolBar 클래스