CToolTipCtrl Třída

Zapouzdřuje funkce "ovládacího prvku popisu", malé automaticky otevírané okno, které zobrazuje jeden řádek textu popisující účel nástroje v aplikaci.

Syntaxe

class CToolTipCtrl : public CWnd

Členové

Veřejné konstruktory

Název	Popis
CToolTipCtrl::CToolTipCtrl	CToolTipCtrl Vytvoří objekt.

Veřejné metody

Název	Popis
CToolTipCtrl::Activate	Aktivuje a deaktivuje ovládací prvek popisku.
CToolTipCtrl::AddTool	Zaregistruje nástroj pomocí ovládacího prvku popisku.
CToolTipCtrl::AdjustRect	Převede mezi obdélníkem zobrazení textu ovládacího prvku popisu a jeho obdélníkem okna.
CToolTipCtrl::Create	Vytvoří ovládací prvek popisu a připojí ho k objektu CToolTipCtrl .
CToolTipCtrl::CreateEx	Vytvoří ovládací prvek popisu se zadanými rozšířenými styly Windows a připojí ho k objektu CToolTipCtrl .
CToolTipCtrl::DelTool	Odebere nástroj z ovládacího prvku popisku.
CToolTipCtrl::GetBubbleSize	Načte velikost popisu.
CToolTipCtrl::GetCurrentTool	Načte informace, například velikost, umístění a text, v okně popisu, které zobrazuje aktuální ovládací prvek popisu.
CToolTipCtrl::GetDelayTime	Načte počáteční, automaticky otevírané okno a znovu zobrazí doby trvání, které jsou aktuálně nastavené pro ovládací prvek popisu.
CToolTipCtrl::GetMargin	Načte horní, levé, dolní a pravé okraje nastavené pro okno popisu.
CToolTipCtrl::GetMaxTipWidth	Načte maximální šířku okna popisu.
CToolTipCtrl::GetText	Načte text, který ovládací prvek popisu udržuje pro nástroj.
CToolTipCtrl::GetTipBkColor	Načte barvu pozadí v okně popisu.
CToolTipCtrl::GetTipTextColor	Načte barvu textu v okně popisu.
CToolTipCtrl::GetTitle	Načte název aktuálního ovládacího prvku popisku.
CToolTipCtrl::GetToolCount	Načte počet nástrojů, které udržuje ovládací prvek popisu.
CToolTipCtrl::GetToolInfo	Načte informace, které ovládací prvek popisu udržuje o nástroji.
CToolTipCtrl::HitTest	Otestuje bod, který určí, jestli je uvnitř ohraničujícího obdélníku daného nástroje. Pokud ano, načte informace o nástroji.
CToolTipCtrl::Pop	Odebere zobrazené okno popisu ze zobrazení.
CToolTipCtrl::Popup	Způsobí, že se aktuální ovládací prvek popisu zobrazí na souřadnicích poslední zprávy myši.
CToolTipCtrl::RelayEvent	Předá zprávu myši ovládacímu prvku popisu ke zpracování.
CToolTipCtrl::SetDelayTime	Nastaví počáteční, automaticky otevírané okno a dobu trvání pro ovládací prvek popisu.
CToolTipCtrl::SetMargin	Nastaví horní, levý, dolní a pravý okraj pro okno popisu.
CToolTipCtrl::SetMaxTipWidth	Nastaví maximální šířku okna popisu.
CToolTipCtrl::SetTipBkColor	Nastaví barvu pozadí v okně popisu.
CToolTipCtrl::SetTipTextColor	Nastaví barvu textu v okně popisu.
CToolTipCtrl::SetTitle	Přidá do popisu standardní ikonu a řetězec názvu.
CToolTipCtrl::SetToolInfo	Nastaví informace, které popis pro nástroj udržuje.
CToolTipCtrl::SetToolRect	Nastaví nový ohraničující obdélník pro nástroj.
CToolTipCtrl::SetWindowTheme	Nastaví vizuální styl okna popisu.
CToolTipCtrl::Update	Vynutí překreslení aktuálního nástroje.
CToolTipCtrl::UpdateTipText	Nastaví text popisu pro nástroj.

Poznámky

"Nástroj" je okno, například podřízené okno nebo ovládací prvek, nebo obdélníková oblast definovaná aplikací v klientské oblasti okna. Popisek je většinu času skrytý, zobrazí se pouze v případě, že uživatel umístí kurzor na nástroj a nechá ho na přibližně půl sekundy. Popis se zobrazí poblíž kurzoru a zmizí, když uživatel klikne na tlačítko myši nebo přesune kurzor mimo nástroj.

CToolTipCtrl poskytuje funkce pro řízení počátečního času a doby trvání popisu, šířky okrajů obklopující text popisu, šířku samotného okna popisu a pozadí a barvu textu popisu. Jeden ovládací prvek popisu může poskytnout informace pro více než jeden nástroj.

Třída CToolTipCtrl poskytuje funkce běžného ovládacího prvku popisu systému Windows. Tento ovládací prvek (a proto CToolTipCtrl třída) je k dispozici pouze pro programy spuštěné v systémech Windows 95/98 a systém Windows NT verze 3.51 a novější.

Další informace o povolení popisů naleznete v tématu Popisy v systému Windows, které nejsou odvozeny z CFrameWnd.

Další informace o použití CToolTipCtrlnaleznete v tématu Ovládací prvky a použití CToolTipCtrl.

Hierarchie dědičnosti

CObject

CCmdTarget

CWnd

CToolTipCtrl

Požadavky

Záhlaví: afxcmn.h

CToolTipCtrl::Activate

Voláním této funkce aktivujete nebo deaktivujete ovládací prvek popisu.

void Activate(BOOL bActivate);

Parametry

bActivate
Určuje, jestli má být ovládací prvek popisku aktivován nebo deaktivovaný.

Poznámky

Pokud bActivate je TRUE, ovládací prvek je aktivován; pokud FALSEje deaktivován.

Když je ovládací prvek popisu aktivní, zobrazí se informace popisku, když je kurzor na nástroji, který je registrován ovládacím prvku; pokud je neaktivní, informace popisku se nezobrazí, ani když je kurzor na nástroji.

Příklad

Podívejte se na příklad pro CPropertySheet::GetTabControl.

CToolTipCtrl::AddTool

Zaregistruje nástroj pomocí ovládacího prvku popisku.

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);

Parametry

pWnd
Ukazatel na okno, které obsahuje nástroj.

nIDText
ID prostředku řetězce, který obsahuje text nástroje.

lpRectTool
Ukazatel na RECT strukturu obsahující souřadnice ohraničujícího obdélníku nástroje Souřadnice jsou relativní vzhledem k levému hornímu rohu klientské oblasti okna identifikovaného objektem pWnd.

nIDTool
ID nástroje.

lpszText
Ukazatel na text nástroje Pokud tento parametr obsahuje hodnotu LPSTR_TEXTCALLBACK, TTN_NEEDTEXT zprávy s oznámením se přejdou na nadřazenou položku okna, na které pWnd odkazuje.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

nIDTool Oba lpRectTool parametry musí být platné, nebo pokud lpRectTool anoNULL, nIDTool musí být 0.

Ovládací prvek popisu lze přidružit k více než jednomu nástroji. Voláním této funkce zaregistrujete nástroj pomocí ovládacího prvku popisku, aby se informace uložené v popisu zobrazily, když je kurzor na nástroji.

Poznámka:

Popis nelze nastavit na statický ovládací prvek pomocí AddTool.

Příklad

Podívejte se na příklad pro CPropertySheet::GetTabControl.

CToolTipCtrl::AdjustRect

Převede mezi obdélníkem zobrazení textu ovládacího prvku popisu a jeho obdélníkem okna.

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

Parametry

lprc
Ukazatel na RECT strukturu, která obsahuje obdélník okna s popisem nebo obdélník zobrazení textu.

bLarger
lprc Pokud TRUEse použije k zadání obdélníku zobrazení textu a obdrží odpovídající obdélník okna. lprc Pokud FALSEse použije k zadání obdélníku okna a obdrží odpovídající obdélník zobrazení textu.

Návratová hodnota

Nenulové, pokud je obdélník úspěšně upraven; jinak 0.

Poznámky

Tato členská funkce vypočítá obdélník zobrazení textu ovládacího prvku popisu z obdélníku okna nebo obdélník okna popisu potřebného k zobrazení zadaného obdélníku zobrazení textu.

Tato členová funkce implementuje chování zprávy TTM_ADJUSTRECTWin32, jak je popsáno v sadě Windows SDK.

CToolTipCtrl::Create

Vytvoří ovládací prvek popisu a připojí ho k objektu CToolTipCtrl .

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

Parametry

pParentWnd
Určuje nadřazené okno ovládacího prvku popisu, obvykle .CDialog Nesmí to být NULL.

dwStyle
Určuje styl ovládacího prvku popisu. Další informace najdete v části Poznámky .

Návratová hodnota

Nenulové, pokud CToolTipCtrl je objekt úspěšně vytvořen; jinak 0.

Poznámky

Sestavíte ho CToolTipCtrl ve dvou krocích. Nejprve zavolejte konstruktor, který vytvoří CToolTipCtrl objekt, a pak voláním Create vytvořit ovládací prvek popisku a připojit ho k objektu CToolTipCtrl .

Parametr dwStyle může být libovolná kombinace stylů oken. Kromě toho má ovládací prvek popisku dva styly specifické pro třídu: TTS_ALWAYSTIP a TTS_NOPREFIX.

Styl	Význam
TTS_ALWAYSTIP	Určuje, že se popis zobrazí, když je kurzor na nástroji, bez ohledu na to, jestli je okno vlastníka ovládacího prvku popisu aktivní nebo neaktivní. Bez tohoto stylu se ovládací prvek popisu zobrazí, když je okno vlastníka nástroje aktivní, ale ne, když je neaktivní.
TTS_NOPREFIX	Tento styl brání systému v odstranění znaku ampersand (&) z řetězce. Pokud ovládací prvek popisu nemá TTS_NOPREFIX styl, systém automaticky odstraní ampersandové znaky, což aplikaci umožní použít stejný řetězec jako položka nabídky i jako text v ovládacím prvku popisu.

Ovládací prvek popisku má styly WS_POPUP oken WS_EX_TOOLWINDOW bez ohledu na to, jestli je zadáte při vytváření ovládacího prvku.

Chcete-li vytvořit ovládací prvek popisu s rozšířenými styly oken, volejte CToolTipCtrl::CreateEx místo Create.

Příklad

Podívejte se na příklad pro CPropertySheet::GetTabControl.

CToolTipCtrl::CreateEx

Vytvoří ovládací prvek (podřízené okno) a přidruží ho k objektu CToolTipCtrl .

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

Parametry

pParentWnd
Ukazatel na okno, které je nadřazeným objektem ovládacího prvku.

dwStyle
Určuje styl ovládacího prvku popisu. Další informace najdete v části Create Poznámky.

dwStyleEx
Určuje rozšířený styl vytvářeného ovládacího prvku. Seznam rozšířených stylů Windows najdete v parametru dwExStyle sady CreateWindowEx Windows SDK.

Návratová hodnota

Nenulové, pokud je úspěšné jinak 0.

Poznámky

Create Místo CreateEx použití rozšířených stylů Windows určených předmětu WS_EX_rozšířeného stylu Windows .

CToolTipCtrl::CToolTipCtrl

CToolTipCtrl Vytvoří objekt.

CToolTipCtrl();

Poznámky

Po vytvoření objektu je nutné volat Create .

Příklad

// Declare a CToolTipCtrl object.
CToolTipCtrl m_ToolTipCtrl;

CToolTipCtrl::DelTool

Odebere nástroj určený pWnd nástrojem a nIDTool z kolekce nástrojů podporovaných ovládacím prvku popisku.

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

Parametry

pWnd
Ukazatel na okno, které obsahuje nástroj.

nIDTool
ID nástroje.

CToolTipCtrl::GetBubbleSize

Načte velikost popisu.

CSize GetBubbleSize(LPTOOLINFO lpToolInfo) const;

Parametry

lpToolInfo
Ukazatel na strukturu popisu TOOLINFO

Návratová hodnota

Velikost popisu

Poznámky

Tato členová funkce implementuje chování zprávy TTM_GETBUBBLESIZEWin32, jak je popsáno v sadě Windows SDK.

CToolTipCtrl::GetCurrentTool

Načte informace, například velikost, umístění a text, okna popisu zobrazeného aktuálním ovládacím prvku popisku.

BOOL GetCurrentTool(LPTOOLINFO lpToolInfo) const;

Parametry

lpToolInfo
[ven] Ukazatel na TOOLINFO strukturu, která přijímá informace o aktuálním okně popisu.

Návratová hodnota

TRUEpokud jsou informace úspěšně načteny; v opačném případě . FALSE

Poznámky

Tato metoda odešle TTM_GETCURRENTTOOL zprávu popsanou v sadě Windows SDK.

Příklad

Následující příklad kódu načte informace o aktuálním okně popisu.

{
    //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

Načte počáteční, automaticky otevírané okno a dobu trvání, která jsou aktuálně nastavená pro ovládací prvek popisu.

int GetDelayTime(DWORD dwDuration) const;

Parametry

dwDuration
Příznak určující, která hodnota doby trvání se načte. Tento parametr může být jedna z následujících hodnot:

• TTDT_AUTOPOP Načtěte dobu, po kterou zůstane okno popisu viditelné, pokud je ukazatel v ohraničujícím obdélníku nástroje statický.

• TTDT_INITIAL Než se zobrazí okno popisu, načte se doba, po kterou musí ukazatel zůstat v ohraničujícím obdélníku nástroje.

• TTDT_RESHOW Načtěte dobu potřebnou k zobrazení dalších oken popisu, když se ukazatel přesune z jednoho nástroje do druhého.

Návratová hodnota

Zadaná doba zpoždění v milisekundách

Poznámky

Tato členová funkce implementuje chování zprávy TTM_GETDELAYTIMEWin32, jak je popsáno v sadě Windows SDK.

CToolTipCtrl::GetMargin

Načte horní, levý, dolní a pravý okraj nastavený pro okno popisu.

void GetMargin(LPRECT lprc) const;

Parametry

lprc
RECT Adresa struktury, která obdrží informace o okraji. Členy RECT struktury nedefinují ohraničující obdélník. Pro účely této zprávy jsou členy struktury interpretovány takto:

Člen	Reprezentace
top	Vzdálenost mezi horním okrajem a horním okrajem textu popisu v pixelech
left	Vzdálenost mezi levým okrajem a levým koncem textu tipu v pixelech
bottom	Vzdálenost mezi dolním ohraničením a dolním okrajem textu tipu v pixelech
right	Vzdálenost mezi pravým ohraničením a pravým koncem textu tipu v pixelech

Poznámky

Tato členová funkce implementuje chování zprávy TTM_GETMARGINWin32, jak je popsáno v sadě Windows SDK.

CToolTipCtrl::GetMaxTipWidth

Načte maximální šířku okna popisu.

int GetMaxTipWidth() const;

Návratová hodnota

Maximální šířka okna popisu.

Poznámky

Tato členová funkce implementuje chování zprávy TTM_GETMAXTIPWIDTHWin32, jak je popsáno v sadě Windows SDK.

CToolTipCtrl::GetText

Načte text, který ovládací prvek popisu udržuje pro nástroj.

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

Parametry

str
Odkaz na CString objekt, který přijímá text nástroje.

pWnd
Ukazatel na okno, které obsahuje nástroj.

nIDTool
ID nástroje.

Poznámky

Nástroj identifikují pWnd a nIDTool parametry. Pokud byl tento nástroj dříve registrován pomocí ovládacího prvku popisu prostřednictvím předchozího volání CToolTipCtrl::AddTool, objekt odkazovaný parametrem str je přiřazen text nástroje.

CToolTipCtrl::GetTipBkColor

Načte barvu pozadí v okně popisu.

COLORREF GetTipBkColor() const;

Návratová hodnota

Hodnota COLORREF , která představuje barvu pozadí.

Poznámky

Tato členová funkce implementuje chování zprávy TTM_GETTIPBKCOLORWin32, jak je popsáno v sadě Windows SDK.

CToolTipCtrl::GetTipTextColor

Načte barvu textu v okně popisu.

COLORREF GetTipTextColor() const;

Návratová hodnota

Hodnota COLORREF , která představuje barvu textu.

Poznámky

Tato členová funkce implementuje chování zprávy TTM_GETTIPTEXTCOLORWin32, jak je popsáno v sadě Windows SDK.

CToolTipCtrl::GetTitle

Načte název aktuálního ovládacího prvku popisku.

void GetTitle(PTTGETTITLE pttgt) const;

Parametry

pttgt
[ven] Ukazatel na TTGETTITLE strukturu, která obsahuje informace o ovládacím prvku popisku. Když tato metoda vrátí, pszTitle člen TTGETTITLE struktury odkazuje na text nadpisu.

Poznámky

Tato metoda odešle TTM_GETTITLE zprávu popsanou v sadě Windows SDK.

CToolTipCtrl::GetToolCount

Načte počet nástrojů registrovaných pomocí ovládacího prvku popisku.

int GetToolCount() const;

Návratová hodnota

Počet nástrojů zaregistrovaných v ovládacím prvku popisku

CToolTipCtrl::GetToolInfo

Načte informace, které ovládací prvek popisu udržuje o nástroji.

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

Parametry

ToolInfo
Odkaz na TOOLINFO objekt, který přijímá text nástroje.

pWnd
Ukazatel na okno, které obsahuje nástroj.

nIDTool
ID nástroje.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Členové hwnd TOOLINFO struktury, na které CToolInfo odkazuje, uId identifikujte nástroj. Pokud byl tento nástroj zaregistrován pomocí ovládacího prvku popisku prostřednictvím předchozího volání AddTool, TOOLINFO struktura je vyplněna informacemi o nástroji.

CToolTipCtrl::HitTest

Otestuje bod, který určí, jestli se nachází v ohraničujícím obdélníku daného nástroje, a pokud ano, načtěte informace o nástroji.

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

Parametry

pWnd
Ukazatel na okno, které obsahuje nástroj.

pt
Ukazatel na CPoint objekt obsahující souřadnice bodu, který se má testovat.

lpToolInfo
Ukazatel na TOOLINFO strukturu, která obsahuje informace o nástroji.

Návratová hodnota

Nenulové, pokud je bod určený informacemi o zkoušce hitu uvnitř ohraničujícího obdélníku nástroje; jinak 0.

Poznámky

Pokud tato funkce vrátí nenulovou hodnotu, je struktura, na kterou lpToolInfo odkazuje, vyplněna informacemi o nástroji, v jehož obdélníku bod leží.

Struktura TTHITTESTINFO je definována takto:

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

  Určuje popisovač nástroje.

• pt

  Určuje souřadnice bodu, pokud je bod v ohraničujícím obdélníku nástroje.

• ti

  Informace o nástroji Další informace o struktuře TOOLINFO naleznete v tématu CToolTipCtrl::GetToolInfo.

CToolTipCtrl::Pop

Odebere zobrazené okno popisu ze zobrazení.

void Pop();

Poznámky

Tato členová funkce implementuje chování zprávy TTM_POPWin32, jak je popsáno v sadě Windows SDK.

CToolTipCtrl::Popup

Způsobí, že se aktuální ovládací prvek popisu zobrazí na souřadnicích poslední zprávy myši.

void Popup();

Poznámky

Tato metoda odešle TTM_POPUP zprávu popsanou v sadě Windows SDK.

Příklad

Následující příklad kódu zobrazí okno popisu.

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

CToolTipCtrl::RelayEvent

Předá zprávu myši ovládacímu prvku popisu ke zpracování.

void RelayEvent(LPMSG lpMsg);

Parametry

lpMsg
Ukazatel na MSG strukturu, která obsahuje zprávu, která se má předat.

Poznámky

Ovládací prvek popisu zpracovává pouze následující zprávy, které jsou do něj odesílány RelayEvent:

WM_LBUTTONDOWN	WM_MOUSEMOVE
WM_LBUTTONUP	WM_RBUTTONDOWN
WM_MBUTTONDOWN	WM_RBUTTONUP
WM_MBUTTONUP

Příklad

Podívejte se na příklad pro CPropertySheet::GetTabControl.

CToolTipCtrl::SetDelayTime

Nastaví čas zpoždění ovládacího prvku popisku.

void SetDelayTime(UINT nDelay);

void SetDelayTime(
    DWORD dwDuration,
    int iTime);

Parametry

nDelay
Určuje novou dobu zpoždění v milisekundách.

dwDuration
Příznak určující, která hodnota doby trvání se načte. Podívejte CToolTipCtrl::GetDelayTime se na popis platných hodnot.

iTime
Zadaná doba zpoždění v milisekundách.

Poznámky

Doba zpoždění je doba, po kterou musí kurzor zůstat na nástroji, než se zobrazí okno popisu. Výchozí doba zpoždění je 500 milisekund.

CToolTipCtrl::SetMargin

Nastaví horní, levý, dolní a pravý okraj pro okno popisu.

void SetMargin(LPRECT lprc);

Parametry

lprc
RECT Adresa struktury, která obsahuje informace o okraji, které se mají nastavit. Členy RECT struktury nedefinují ohraničující obdélník. Přečtěte si CToolTipCtrl::GetMargin popis informací o okraji.

Poznámky

Tato členová funkce implementuje chování zprávy TTM_SETMARGINWin32, jak je popsáno v sadě Windows SDK.

CToolTipCtrl::SetMaxTipWidth

Nastaví maximální šířku okna popisu.

int SetMaxTipWidth(int iWidth);

Parametry

iWidth
Maximální šířka okna popisu, která se má nastavit.

Návratová hodnota

Předchozí maximální šířka špičky.

Poznámky

Tato členová funkce implementuje chování zprávy TTM_SETMAXTIPWIDTHWin32, jak je popsáno v sadě Windows SDK.

CToolTipCtrl::SetTipBkColor

Nastaví barvu pozadí v okně popisu.

void SetTipBkColor(COLORREF clr);

Parametry

clr
Nová barva pozadí.

Poznámky

Tato členová funkce implementuje chování zprávy TTM_SETTIPBKCOLORWin32, jak je popsáno v sadě Windows SDK.

CToolTipCtrl::SetTipTextColor

Nastaví barvu textu v okně popisu.

void SetTipTextColor(COLORREF clr);

Parametry

clr
Nová barva textu.

Poznámky

Tato členová funkce implementuje chování zprávy TTM_SETTIPTEXTCOLORWin32, jak je popsáno v sadě Windows SDK.

CToolTipCtrl::SetTitle

Přidá do popisu standardní ikonu a řetězec názvu.

BOOL SetTitle(
    UINT uIcon,
    LPCTSTR lpstrTitle);

Parametry

uIcon
Viz icon v TTM_SETTITLE sadě Windows SDK.

lpstrTitle
Ukazatel na název řetězce.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Tato členová funkce implementuje chování zprávy TTM_SETTITLEWin32, jak je popsáno v sadě Windows SDK.

CToolTipCtrl::SetToolInfo

Nastaví informace, které popis pro nástroj udržuje.

void SetToolInfo(LPTOOLINFO lpToolInfo);

Parametry

lpToolInfo
Ukazatel na TOOLINFO strukturu, která určuje informace, které se mají nastavit.

CToolTipCtrl::SetToolRect

Nastaví nový ohraničující obdélník pro nástroj.

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

Parametry

pWnd
Ukazatel na okno, které obsahuje nástroj.

nIDTool
ID nástroje.

lpRect
Ukazatel na RECT strukturu určující nový ohraničující obdélník.

CToolTipCtrl::SetWindowTheme

Nastaví vizuální styl okna popisu.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parametry

pszSubAppName
Ukazatel na řetězec Unicode, který obsahuje vizuální styl, který chcete nastavit.

Návratová hodnota

Vrácená hodnota se nepoužívá.

Poznámky

Tato členová funkce emuluje funkce TTM_SETWINDOWTHEME zprávy, jak je popsáno v sadě Windows SDK.

CToolTipCtrl::Update

Vynutí překreslení aktuálního nástroje.

void Update();

CToolTipCtrl::UpdateTipText

Aktualizuje text popisu pro nástroje tohoto ovládacího prvku.

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

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

Parametry

lpszText
Ukazatel na text nástroje

pWnd
Ukazatel na okno, které obsahuje nástroj.

nIDTool
ID nástroje.

nIDText
ID prostředku řetězce, který obsahuje text nástroje.

Viz také

CWnd Třída
Graf hierarchie
CToolBar Třída