CTooltipManager 클래스
도구 설명에 대한 런타임 정보를 유지합니다. CTooltipManager 클래스는 응용 프로그램당 한 번씩 인스턴스화됩니다.
구문
class CTooltipManager : public CObject
멤버
공용 메서드
| 이름 | 설명 |
|---|---|
| CTooltipManager::CreateToolTip | 지정된 Windows 컨트롤 형식에 대한 도구 설명 컨트롤을 만듭니다. |
| CTooltipManager::D eleteToolTip | 도구 설명 컨트롤을 삭제합니다. |
| CTooltipManager::SetTooltipParams | 지정된 Windows 컨트롤 형식에 대한 도구 설명 컨트롤의 시각적 모양을 사용자 지정합니다. |
| CTooltipManager::SetTooltipText | 도구 설명 컨트롤에 대한 텍스트 및 설명을 설정합니다. |
| CTooltipManager::UpdateTooltips |
설명
CMFCToolTipCtrl 클래스CMFCToolTipInfo를 함께 CTooltipManager 사용하여 애플리케이션에서 사용자 지정된 도구 설명을 구현합니다. 이러한 도구 설명 클래스를 사용하는 방법에 대한 예제는 CMFCToolTipCtrl 클래스 항목을 참조하세요.
상속 계층 구조
요구 사항
헤더: 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), ¶ms);
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();