`CToolTipCtrl` 클래스

아티클
10/12/2023

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

구문

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 이상에서 실행되는 프로그램에서만 사용할 수 있습니다.

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

사용 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 모두 유효해야 합니다. 그렇지 않으면 lpRectToolNULLnIDTool 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`

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

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 도구를 식별하여 TOOLINFOCToolInfo 참조하는 구조체의 멤버 및 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 클래스

CToolTipCtrl 클래스

구문

멤버

공용 생성자

공용 메서드

설명

상속 계층 구조

요구 사항

CToolTipCtrl::Activate

매개 변수

설명

예시

CToolTipCtrl::AddTool

매개 변수

Return Value

설명

예시

CToolTipCtrl::AdjustRect

매개 변수

Return Value

설명

CToolTipCtrl::Create

매개 변수

Return Value

설명

예시

CToolTipCtrl::CreateEx

매개 변수

Return Value

설명

CToolTipCtrl::CToolTipCtrl

설명

예시

CToolTipCtrl::DelTool

매개 변수

CToolTipCtrl::GetBubbleSize

매개 변수

Return Value

설명

CToolTipCtrl::GetCurrentTool

매개 변수

Return Value

설명

예시

CToolTipCtrl::GetDelayTime

매개 변수

Return Value

설명

CToolTipCtrl::GetMargin

매개 변수

설명

CToolTipCtrl::GetMaxTipWidth

Return Value

설명

CToolTipCtrl::GetText

매개 변수

설명

CToolTipCtrl::GetTipBkColor

Return Value

설명

CToolTipCtrl::GetTipTextColor

Return Value

설명

CToolTipCtrl::GetTitle

매개 변수

설명

CToolTipCtrl::GetToolCount

Return Value

CToolTipCtrl::GetToolInfo

매개 변수

Return Value

설명

CToolTipCtrl::HitTest

매개 변수

Return Value

설명

CToolTipCtrl::Pop

설명

CToolTipCtrl::Popup

설명

`CToolTipCtrl` 클래스

`CToolTipCtrl::Activate`

`CToolTipCtrl::AddTool`

`CToolTipCtrl::AdjustRect`

`CToolTipCtrl::Create`

`CToolTipCtrl::CreateEx`

`CToolTipCtrl::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`