Udostępnij za pośrednictwem


Klasa CTooltipManager

Przechowuje informacje o środowisku uruchomieniowym dotyczące etykietek narzędzi. Klasa CTooltipManager jest tworzone pojedynczo na aplikację.

Składnia

class CTooltipManager : public CObject

Członkowie

Metody publiczne

Nazwa/nazwisko opis
CTooltipManager::CreateToolTip Tworzy kontrolkę etykietki narzędzia dla określonych typów kontrolek systemu Windows.
CTooltipManager::D eleteToolTip Usuwa kontrolkę etykietki narzędzia.
CTooltipManager::SetTooltipParams Dostosowuje wygląd wizualizacji kontrolki etykietki narzędzia dla określonych typów kontrolek systemu Windows.
CTooltipManager::SetTooltipText Ustawia tekst i opis kontrolki etykietki narzędzia.
CTooltipManager::UpdateTooltips

Uwagi

Użyj klasy CMFCToolTipCtrl, CMFCToolTipInfoi CTooltipManager razem, aby zaimplementować dostosowane etykietki narzędzi w aplikacji. Przykład użycia tych klas etykietek narzędzi można znaleźć w temacie Klasa CMFCToolTipCtrl.

Hierarchia dziedziczenia

Cobject

Ctooltipmanager

Wymagania

Nagłówek: afxtooltipmanager.h

CTooltipManager::CreateToolTip

Tworzy kontrolkę etykietki narzędzia.

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

Parametry

pToolTip
[out] Odwołanie do wskaźnika etykietki narzędzia. Jest ona ustawiona tak, aby wskazywała nowo utworzoną etykietkę narzędzia po powrocie funkcji.

pWndParent
[in] Element nadrzędny etykietki narzędzia.

nType
[in] Typ etykietki narzędzia.

Wartość zwracana

Nonzero, jeśli etykietka narzędzia została utworzona pomyślnie.

Uwagi

Należy wywołać polecenie CTooltipManager::D eleteToolTip , aby usunąć kontrolkę etykietki narzędzia przekazaną z powrotem w narzędziu pToolTip.

Narzędzie CTooltipManager ustawia parametry wyświetlania wizualizacji dla każdej etykietki narzędzia tworzonej na podstawie typu etykietki narzędzia, który określa nType . Aby zmienić parametry dla co najmniej jednego typu etykietki narzędzia, wywołaj metodę CTooltipManager::SetTooltipParams.

Prawidłowe typy etykietek narzędzi są wymienione w poniższej tabeli:

Typ etykietki narzędzia Kategoria kontrolki Przykładowe typy
AFX_TOOLTIP_TYPE_BUTTON Przycisk. Cmfcbutton
AFX_TOOLTIP_TYPE_CAPTIONBAR Pasek podpis. Cmfccaptionbar
AFX_TOOLTIP_TYPE_DEFAULT Każda kontrolka, która nie pasuje do innej kategorii. Brak.
AFX_TOOLTIP_TYPE_DOCKBAR Okienko z możliwością dokowania. Cdockablepane
AFX_TOOLTIP_TYPE_EDIT Pole tekstowe. Brak.
AFX_TOOLTIP_TYPE_MINIFRAME Miniframe. Cpaneframewnd
AFX_TOOLTIP_TYPE_PLANNER Planista. Brak.
AFX_TOOLTIP_TYPE_RIBBON Pasek wstążki. CMFCRibbonBar, CMFCRibbonPanelMenuBar
AFX_TOOLTIP_TYPE_TAB Kontrolka karty. Cmfctabctrl
AFX_TOOLTIP_TYPE_TOOLBAR Pasek narzędzi. CMFCToolBar, CMFCPopupMenuBar
AFX_TOOLTIP_TYPE_TOOLBOX Przybornik. Brak.

CTooltipManager::D eleteToolTip

Usuwa kontrolkę etykietki narzędzia.

static void DeleteToolTip(CToolTipCtrl*& pToolTip);

Parametry

pToolTip
[in, out] Odwołanie do wskaźnika do etykietki narzędzia do zniszczenia.

Uwagi

Wywołaj tę metodę dla każdej klasy CToolTipCtrl utworzonej przez CTooltipManager::CreateToolTip. Kontrolka nadrzędna powinna wywołać tę metodę z programu OnDestroy obsługi. Jest to wymagane, aby poprawnie usunąć etykietkę narzędzia ze struktury. Ta metoda ustawia wartość pToolTip na wartość NULL przed zwróceniem.

CTooltipManager::SetTooltipParams

Dostosowuje wygląd kontrolki etykietki narzędzia dla określonych typów kontrolek systemu Windows.

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

Parametry

nTypes
[in] Określa typy kontrolek.

PRTC
[in] Klasa środowiska uruchomieniowego niestandardowej etykietki narzędzia.

pParams
[in] Parametry etykietki narzędzia.

Uwagi

Ta metoda ustawia klasę środowiska uruchomieniowego i początkowe parametry używane przez narzędzie CToolTipManager podczas tworzenia etykietek narzędzi. Gdy kontrolka wywołuje CTooltipManager::CreateToolTip i przekazuje typ etykietki narzędzia, który jest jednym z typów wskazanych przez nTypes, menedżer etykietek narzędzi tworzy kontrolkę etykietki narzędzia, która jest wystąpieniem klasy środowiska uruchomieniowego określonego przez pRTC i przekazuje parametry określone przez pParams do nowej etykietki narzędzia.

Po wywołaniu tej metody wszyscy istniejący właściciele etykietek narzędzi otrzymają komunikat AFX_WM_UPDATETOOLTIPS i muszą ponownie utworzyć etykietki narzędzi przy użyciu narzędzia CTooltipManager::CreateToolTip.

nTypes może być dowolną kombinacją prawidłowych typów etykietek narzędzi, których używa CTooltipManager::CreateToolTip , lub może być AFX_TOOLTIP_TYPE_ALL. W przypadku przekazania AFX_TOOLTIP_TYPE_ALL wszystkie typy etykietek narzędzi będą miały wpływ.

Przykład

W poniższym przykładzie pokazano, jak używać SetTooltipParams metody CTooltipManager klasy . Ten fragment kodu jest częścią przykładu Draw Client.

CMFCToolTipInfo params;
params.m_bVislManagerTheme = TRUE;

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

CTooltipManager::SetTooltipText

Ustawia tekst i opis etykietki narzędzia.

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

Parametry

Pti
[in] Wskaźnik do obiektu TOOLINFO.

pToolTip
[in, out] Wskaźnik do kontrolki etykietki narzędzia, dla której ma być ustawiony tekst i opis.

nType
[in] Określa typ kontrolki, z którą jest skojarzona ta etykietka narzędzia.

strText
[in] Tekst, który ma być ustawiony jako tekst etykietki narzędzia.

lpszDescr
[in] Wskaźnik do opisu etykietki narzędzia. Może mieć wartość NULL.

Uwagi

Wartość parametru nType musi być taka sama jak parametr nType CTooltipManager::CreateToolTip podczas tworzenia etykietki narzędzia.

CTooltipManager::UpdateTooltips

Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.

void UpdateTooltips();

Uwagi

Zobacz też

Wykres hierarchii
Klasy
Klasa CMFCToolTipCtrl
Klasa CMFCToolTipInfo