CTooltipManager 클래스

도구 설명에 대한 런타임 정보를 유지합니다. CTooltipManager 클래스는 응용 프로그램당 한 번씩 인스턴스화됩니다.

구문

class CTooltipManager : public CObject

멤버

공용 메서드

이름	설명
CTooltipManager::CreateToolTip	지정된 Windows 컨트롤 형식에 대한 도구 설명 컨트롤을 만듭니다.
CTooltipManager::D eleteToolTip	도구 설명 컨트롤을 삭제합니다.
CTooltipManager::SetTooltipParams	지정된 Windows 컨트롤 형식에 대한 도구 설명 컨트롤의 시각적 모양을 사용자 지정합니다.
CTooltipManager::SetTooltipText	도구 설명 컨트롤에 대한 텍스트 및 설명을 설정합니다.
CTooltipManager::UpdateTooltips

설명

CMFCToolTipCtrl 클래스CMFCToolTipInfo를 함께 CTooltipManager 사용하여 애플리케이션에서 사용자 지정된 도구 설명을 구현합니다. 이러한 도구 설명 클래스를 사용하는 방법에 대한 예제는 CMFCToolTipCtrl 클래스 항목을 참조하세요.

상속 계층 구조

CObject

CTooltipManager

요구 사항

헤더: afxtooltipmanager.h

CTooltipManager::CreateToolTip

도구 설명 컨트롤을 만듭니다.

static BOOL CreateToolTip(
    CToolTipCtrl*& pToolTip,
    CWnd* pWndParent,
    UINT nType);

매개 변수

pToolTip
[out] 도구 설명 포인터에 대한 참조입니다. 함수가 반환되면 새로 만든 도구 설명을 가리키도록 설정됩니다.

pWndParent
[in] 도구 설명의 부모입니다.

nType
[in] 도구 설명의 형식입니다.

Return Value

도구 설명이 성공적으로 만들어진 경우 0이 아닌 경우

설명

pToolTip에서 다시 전달되는 도구 설명 컨트롤을 삭제하려면 CTooltipManager::D eleteToolTip을 호출해야 합니다.

CTooltipManager는 nType이 지정하는 도구 설명 형식에 따라 만드는 각 도구 설명의 시각적 표시 매개 변수를 설정합니다. 하나 이상의 도구 설명 형식에 대한 매개 변수를 변경하려면 CTooltipManager::SetTooltipParams를 호출 합니다.

유효한 도구 설명 유형은 다음 표에 나와 있습니다.

도구 설명 유형	컨트롤 범주	예제 형식
AFX_TOOLTIP_TYPE_BUTTON	단추입니다.	CMFCButton
AFX_TOOLTIP_TYPE_CAPTIONBAR	캡션 막대.	CMFCCaptionBar
AFX_TOOLTIP_TYPE_DEFAULT	다른 범주에 맞지 않는 모든 컨트롤입니다.	없음
AFX_TOOLTIP_TYPE_DOCKBAR	도킹 가능한 창입니다.	CDockablePane
AFX_TOOLTIP_TYPE_EDIT	텍스트 상자입니다.	없음
AFX_TOOLTIP_TYPE_MINIFRAME	미니 프레임.	CPaneFrameWnd
AFX_TOOLTIP_TYPE_PLANNER	플래너.	없음
AFX_TOOLTIP_TYPE_RIBBON	리본 표시줄입니다.	CMFCRibbonBar, CMFCRibbonPanelMenuBar
AFX_TOOLTIP_TYPE_TAB	탭 컨트롤입니다.	CMFCTabCtrl
AFX_TOOLTIP_TYPE_TOOLBAR	도구 모음입니다.	CMFCToolBar, CMFCPopupMenuBar
AFX_TOOLTIP_TYPE_TOOLBOX	도구 상자입니다.	없음

CTooltipManager::D eleteToolTip

도구 설명 컨트롤을 삭제합니다.

static void DeleteToolTip(CToolTipCtrl*& pToolTip);

매개 변수

pToolTip
[in, out] 제거할 도구 설명에 대한 포인터에 대한 참조입니다.

설명

CTooltipManager::CreateToolTip에서 만든 각 CToolTipCtrl 클래스에 대해 이 메서드를 호출합니다. 부모 컨트롤은 해당 처리기에서 이 메서드를 OnDestroy 호출해야 합니다. 프레임워크에서 도구 설명을 올바르게 제거하려면 이 작업이 필요합니다. 이 메서드는 반환하기 전에 pToolTip을 NULL로 설정합니다.

CTooltipManager::SetTooltipParams

지정된 Windows 컨트롤 형식에 대한 도구 설명 컨트롤의 모양을 사용자 지정합니다.

void SetTooltipParams(
    UINT nTypes,
    CRuntimeClass* pRTC=RUNTIME_CLASS(CMFCToolTipCtrl),
    CMFCToolTipInfo* pParams=NULL);

매개 변수

nTypes
[in] 컨트롤 형식을 지정합니다.

pRTC
[in] 사용자 지정 도구 설명의 런타임 클래스입니다.

pParams
[in] 도구 설명 매개 변수입니다.

설명

이 메서드는 CToolTipManager가 도구 설명을 만들 때 사용하는 런타임 클래스 및 초기 매개 변수를 설정합니다. 컨트롤이 CTooltipManager::CreateToolTip을 호출하고 nTypes로 표시된 형식 중 하나인 도구 설명 형식을 전달하는 경우 도구 설명 관리자는 pRTC로 지정된 런타임 클래스의 인스턴스인 도구 설명 컨트롤을 만들고 pParams로 지정된 매개 변수를 새 도구 설명에 전달합니다.

이 메서드를 호출하면 모든 기존 도구 설명 소유자가 AFX_WM_UPDATETOOLTIPS 메시지를 수신하고 CTooltipManager::CreateToolTip을 사용하여 도구 설명을 다시 만들어야 합니다.

nType은 CTooltipManager::CreateToolTip에서 사용하는 유효한 도구 설명 형식의 조합이거나 AFX_TOOLTIP_TYPE_ALL 수 있습니다. AFX_TOOLTIP_TYPE_ALL 전달하면 모든 도구 설명 형식이 영향을 받습니다.

예시

다음 예제에서는 클래스의 메서드를 SetTooltipParams 사용 하는 방법을 보여 줍니다 CTooltipManager . 이 코드 조각은 클라이언트 그리기 샘플의 일부입니다.

CMFCToolTipInfo params;
params.m_bVislManagerTheme = TRUE;

theApp.GetTooltipManager()->SetTooltipParams(AFX_TOOLTIP_TYPE_ALL, RUNTIME_CLASS(CMFCToolTipCtrl), &params);

CTooltipManager::SetTooltipText

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

static void SetTooltipText(
    TOOLINFO* pTI,
    CToolTipCtrl* pToolTip,
    UINT nType,
    const CString strText,
    LPCTSTR lpszDescr=NULL);

매개 변수

Pti
[in] TOOLINFO 개체에 대한 포인터입니다.

pToolTip
[in, out] 텍스트 및 설명을 설정할 도구 설명 컨트롤에 대한 포인터입니다.

nType
[in] 이 도구 설명이 연결된 컨트롤의 형식을 지정합니다.

strText
[in] 도구 설명 텍스트로 설정할 텍스트입니다.

lpszDescr
[in] 도구 설명 설명에 대한 포인터입니다. NULL일 수 있습니다.

설명

nType 값은 도구 설명을 만들 때 CTooltipManager::CreateToolTip의 nType 매개 변수와 동일한 값이어야 합니다.

CTooltipManager::UpdateTooltips

자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.

void UpdateTooltips();

설명

참고 항목

계층 구조 차트
클래스
CMFCToolTipCtrl 클래스
CMFCToolTipInfo 클래스