CToolTipCtrl osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Beágyazza az "elemleírás-vezérlő" funkcióit, egy kis előugró ablakot, amely egyetlen szövegsort jelenít meg, amely leírja egy eszköz célját egy alkalmazásban.

Szemantika

class CToolTipCtrl : public CWnd

Tagok

Nyilvános konstruktorok

Név	Description
CToolTipCtrl::CToolTipCtrl	Egy CToolTipCtrl objektumot hoz létre.

Nyilvános metódusok

Név	Description
CToolTipCtrl::Activate	Aktiválja és inaktiválja az elemleírás-vezérlőt.
CToolTipCtrl::AddTool	Regisztrál egy eszközt az elemleírás-vezérlővel.
CToolTipCtrl::AdjustRect	Átalakítja az elemleírás-vezérlő szövegmegjelenítési téglalapja és az ablak téglalapja között.
CToolTipCtrl::Create	Elemleírás-vezérlőt hoz létre, és csatolja egy CToolTipCtrl objektumhoz.
CToolTipCtrl::CreateEx	Elemleírás-vezérlőt hoz létre a megadott Bővített Windows-stílusokkal, és csatolja egy CToolTipCtrl objektumhoz.
CToolTipCtrl::DelTool	Eltávolít egy eszközt az elemleírás-vezérlőből.
CToolTipCtrl::GetBubbleSize	Lekéri az elemleírás méretét.
CToolTipCtrl::GetCurrentTool	Beolvassa az aktuális elemleírás-vezérlő által megjelenített elemleírás-ablak méretét, pozícióját és szövegét.
CToolTipCtrl::GetDelayTime	Lekéri az elemleírás-vezérlőhöz jelenleg beállított kezdeti, előugró és újbóli megjelenítési időtartamokat.
CToolTipCtrl::GetMargin	Lekéri az elemleírás-ablakhoz beállított felső, bal, alsó és jobb margókat.
CToolTipCtrl::GetMaxTipWidth	Lekéri egy elemleírás ablakának maximális szélességét.
CToolTipCtrl::GetText	Lekéri azt a szöveget, amelyet egy elemleírás-vezérlő tart fenn egy eszközhöz.
CToolTipCtrl::GetTipBkColor	Lekéri a háttérszínt egy elemleírás-ablakban.
CToolTipCtrl::GetTipTextColor	Beolvassa a szöveg színét egy elemleírás-ablakban.
CToolTipCtrl::GetTitle	Lekéri az aktuális elemleírás-vezérlő címét.
CToolTipCtrl::GetToolCount	Lekéri az elemleírás-vezérlő által karbantartott eszközök számát.
CToolTipCtrl::GetToolInfo	Lekéri azokat az információkat, amelyeket egy elemleírás-vezérlő tart fenn az eszközről.
CToolTipCtrl::HitTest	Tesztel egy pontot annak megállapításához, hogy az az adott eszköz határolókeretén belül van-e. Ha igen, lekéri az eszköz adatait.
CToolTipCtrl::Pop	Eltávolít egy megjelenített elemleírás-ablakot a nézetből.
CToolTipCtrl::Popup	Az aktuális elemleírás-vezérlő az utolsó egérüzenet koordinátáin jelenik meg.
CToolTipCtrl::RelayEvent	Egérüzenetet ad át egy elemleírás-vezérlőnek a feldolgozáshoz.
CToolTipCtrl::SetDelayTime	Beállítja az elemleírás-vezérlő kezdeti, előugró és újbóli megjelenítési időtartamát.
CToolTipCtrl::SetMargin	Az elemleírás ablakának felső, bal, alsó és jobb margóit állítja be.
CToolTipCtrl::SetMaxTipWidth	Az elemleírások ablakának maximális szélességét adja meg.
CToolTipCtrl::SetTipBkColor	Beállítja a háttérszínt egy elemleírás-ablakban.
CToolTipCtrl::SetTipTextColor	A szöveg színét egy elemleírás-ablakban állítja be.
CToolTipCtrl::SetTitle	Szabványos ikont és címsztringet ad hozzá egy elemleíráshoz.
CToolTipCtrl::SetToolInfo	Beállítja azokat az információkat, amelyeket egy elemleírás tart fenn egy eszközhöz.
CToolTipCtrl::SetToolRect	Új határolókeretet állít be egy eszközhöz.
CToolTipCtrl::SetWindowTheme	Beállítja az elemleírás ablakának vizuális stílusát.
CToolTipCtrl::Update	Kényszeríti az aktuális eszközt az újrarajzolt eszközre.
CToolTipCtrl::UpdateTipText	Beállítja egy eszköz elemleírásának szövegét.

Megjegyzések

Az "eszköz" egy ablak, például gyermekablak vagy vezérlő, vagy egy alkalmazás által definiált téglalap alakú terület az ablak ügyfélterületén belül. Az elemleírások általában rejtve vannak, és csak akkor jelennek meg, ha a felhasználó egy eszközre helyezi a kurzort, és körülbelül fél másodpercig ott hagyja. Az elemleírás a kurzor közelében jelenik meg, és eltűnik, amikor a felhasználó egy egérgombra kattint, vagy a kurzort leküldi az eszközről.

CToolTipCtrl Lehetővé teszi az elemleírás kezdeti idejének és időtartamának, az elemleírás szövegét körülvevő margószélességeknek, magának az elemleírás-ablaknak a szélességét, valamint az elemleírás hátterét és szövegszínét. Egyetlen elemleírás-vezérlő több eszköz adatait is szolgáltathatja.

Az CToolTipCtrl osztály a Windows általános elemleírás-vezérlőjének funkcióit biztosítja. Ez a vezérlő (és ezért az CToolTipCtrl osztály) csak a Windows 95/98 és a Windows NT 3.51-ös és újabb verzióiban futó programokhoz érhető el.

Az elemleírások engedélyezésével kapcsolatos további információkért lásd: Eszköztippek a Windowsban nem származik.CFrameWnd

A használatról CToolTipCtrltovábbi információt a Vezérlők és a Használat CToolTipCtrlcímű témakörben talál.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CToolTipCtrl

Requirements

Fejléc:afxcmn.h

CToolTipCtrl::Activate

A függvény meghívása elemleírás-vezérlő aktiválásához vagy inaktiválásához.

void Activate(BOOL bActivate);

Paraméterek

bActivate
Megadja, hogy az elemleírás-vezérlőt aktiválni vagy inaktiválni kell-e.

Megjegyzések

Ha bActivate igen TRUE, a vezérlő aktiválva van, ha FALSEpedig inaktiválva van.

Ha egy elemleírás-vezérlő aktív, az elemleírás-információk akkor jelennek meg, amikor a kurzor egy olyan eszközre kerül, amely regisztrálva van a vezérlővel; inaktív állapotban az elemleírás adatai nem jelennek meg, még akkor sem, ha a kurzor egy eszközre van kapcsolva.

Example

Lásd a példát a CPropertySheet::GetTabControl.

CToolTipCtrl::AddTool

Regisztrál egy eszközt az elemleírás-vezérlővel.

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

Paraméterek

pWnd
Mutasson az eszközt tartalmazó ablakra.

nIDText
Az eszköz szövegét tartalmazó sztringerőforrás azonosítója.

lpRectTool
Mutasson egy RECT szerkezetre, amely az eszköz határoló téglalapjának koordinátáit tartalmazza. A koordináták az ablak ügyfélterületének bal felső sarkához viszonyítva jelennek meg pWnd.

nIDTool
Az eszköz azonosítója.

lpszText
Mutasson az eszköz szövegére. Ha ez a paraméter tartalmazza az értéket LPSTR_TEXTCALLBACK, TTN_NEEDTEXT az értesítési üzenetek a rámutató pWnd ablak szülőjére kerülnek.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A lpRectTool paramétereknek nIDTool és a paramétereknek egyaránt érvényesnek kell lenniük, vagy ha lpRectTool igen NULL, nIDTool akkor 0-nak kell lenniük.

Az elemleírás-vezérlők több eszközzel is társíthatók. Hívja meg ezt a függvényt, hogy regisztráljon egy eszközt az elemleírás-vezérlővel, hogy az elemleírásban tárolt információk megjelenjenek, amikor a kurzor az eszközre kerül.

Megjegyzés:

Elemleírást nem állíthat be statikus vezérlőre a következő használatával AddTool: .

Example

Lásd a példát a CPropertySheet::GetTabControl.

CToolTipCtrl::AdjustRect

Átalakítja az elemleírás-vezérlő szövegmegjelenítési téglalapja és az ablak téglalapja között.

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

Paraméterek

lprc
Mutató egy RECT olyan szerkezetre, amely egy elemleírásos ablak téglalapját vagy egy szövegmegjelenítési téglalapot tartalmaz.

bLarger
Ha TRUEa program lprc egy szövegmegjelenítési téglalap megadására szolgál, és megkapja a megfelelő ablak téglalapot. Ha FALSEa beállítás lprc egy ablak téglalapjának megadására szolgál, és megkapja a megfelelő szövegmegjelenítési téglalapot.

Visszaadott érték

Nonzero, ha a téglalapot sikeresen igazítottuk; egyéb esetben 0.

Megjegyzések

Ez a tagfüggvény kiszámítja egy elemleírás-vezérlő szövegmegjelenítési téglalapját az ablak téglalapjából, vagy a megadott szövegmegjelenítési téglalap megjelenítéséhez szükséges elemleírás-ablak téglalapot.

Ez a tagfüggvény implementálja a Win32-üzenet TTM_ADJUSTRECTviselkedését a Windows SDK-ban leírtak szerint.

CToolTipCtrl::Create

Elemleírás-vezérlőt hoz létre, és csatolja egy CToolTipCtrl objektumhoz.

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

Paraméterek

pParentWnd
Az elemleírás-vezérlő szülőablakát adja meg, általában egy CDialog. Nem lehet NULL.

dwStyle
Megadja az elemleírás-vezérlő stílusát. További információért tekintse meg a Megjegyzések szakaszt.

Visszaadott érték

Nonzero, ha az CToolTipCtrl objektum sikeresen létrejött, ellenkező esetben 0.

Megjegyzések

Két lépésben hozhat létre egy CToolTipCtrl elemet. Először hívja meg a konstruktort az CToolTipCtrl objektum létrehozásához, majd hívja meg Create az elemleírás-vezérlő létrehozását és az CToolTipCtrl objektumhoz való csatolását.

A dwStyle paraméter az ablakstílusok tetszőleges kombinációja lehet. Emellett az elemleírás-vezérlőknek két osztályspecifikus stílusuk van: TTS_ALWAYSTIP és TTS_NOPREFIX.

Stílus	Meaning
TTS_ALWAYSTIP	Megadja, hogy az elemleírás akkor jelenik meg, amikor a kurzor egy eszközre kerül, függetlenül attól, hogy az elemleírás-vezérlő tulajdonosablaka aktív vagy inaktív. E stílus nélkül az elemleírás-vezérlő akkor jelenik meg, ha az eszköz tulajdonosi ablaka aktív, inaktív állapotban azonban nem.
TTS_NOPREFIX	Ez a stílus megakadályozza, hogy a rendszer sztringből eltávolítsa az ampersand (&) karaktert. Ha egy elemleírás-vezérlő nem rendelkezik a TTS_NOPREFIX stílussal, a rendszer automatikusan csíkozza az erősítőket és a karaktereket, így az alkalmazás ugyanazt a sztringet használhatja, mint egy menüelem és egy elemleírás-vezérlő szövege.

Az elemleírás-vezérlők stílusa WS_POPUP és WS_EX_TOOLWINDOW ablakstílusa attól függetlenül, hogy a vezérlőelem létrehozásakor megadja-e őket.

Ha bővített ablakstílusokkal szeretne elemleírás-vezérlőt létrehozni, hívja meg ahelyettCreate, hogy a CToolTipCtrl::CreateEx .

Example

Lásd a példát a CPropertySheet::GetTabControl.

CToolTipCtrl::CreateEx

Létrehoz egy vezérlőt (egy gyermekablakot), és társítja azt az CToolTipCtrl objektummal.

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

Paraméterek

pParentWnd
A vezérlő szülőablakára mutató mutató.

dwStyle
Megadja az elemleírás-vezérlő stílusát. További információért tekintse meg a Megjegyzések szakaszt Create .

dwStyleEx
A létrehozott vezérlőelem kiterjesztett stílusát adja meg. A bővített Windows-stílusok listáját a dwExStyle Windows SDK paraméterében CreateWindowEx találja.

Visszaadott érték

Nonzero, ha sikeres, egyébként 0.

Megjegyzések

Create A CreateEx bővített Windows-stílusok helyett használja a Windows bővített stílus előszavában WS_EX_megadott stílusokat.

CToolTipCtrl::CToolTipCtrl

Egy CToolTipCtrl objektumot hoz létre.

CToolTipCtrl();

Megjegyzések

Az objektum létrehozása után hívnia Create kell.

Example

// Declare a CToolTipCtrl object.
CToolTipCtrl m_ToolTipCtrl;

CToolTipCtrl::DelTool

Eltávolítja az elemleírás-vezérlő által támogatott eszközök gyűjteményéből és által pWndnIDTool megadott eszközt.

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

Paraméterek

pWnd
Mutasson az eszközt tartalmazó ablakra.

nIDTool
Az eszköz azonosítója.

CToolTipCtrl::GetBubbleSize

Lekéri az elemleírás méretét.

CSize GetBubbleSize(LPTOOLINFO lpToolInfo) const;

Paraméterek

lpToolInfo
Az elemleírás szerkezetére TOOLINFO mutató mutató.

Visszaadott érték

Az elemleírás mérete.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TTM_GETBUBBLESIZEviselkedését a Windows SDK-ban leírtak szerint.

CToolTipCtrl::GetCurrentTool

Beolvassa az aktuális elemleírás-vezérlő által megjelenített elemleírás ablakának méretét, pozícióját és szövegét.

BOOL GetCurrentTool(LPTOOLINFO lpToolInfo) const;

Paraméterek

lpToolInfo
[kifelé] Mutasson egy TOOLINFO olyan struktúrára, amely információt kap az aktuális elemleírás ablakáról.

Visszaadott érték

TRUEha az adatok lekérése sikeresen megtörtént; egyéb esetben. FALSE

Megjegyzések

Ez a metódus elküldi a TTM_GETCURRENTTOOL Windows SDK-ban leírt üzenetet.

Example

Az alábbi kódpéldában az aktuális elemleírás ablakára vonatkozó információkat olvashatja le.

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

Lekéri az elemleírás-vezérlőhöz jelenleg beállított kezdeti, előugró és újbóli megjelenítési időtartamokat.

int GetDelayTime(DWORD dwDuration) const;

Paraméterek

dwDuration
A beolvasandó időtartam értékét meghatározó jelölő. Ez a paraméter a következő értékek egyike lehet:

• TTDT_AUTOPOP Kérje le, hogy az elemleírás ablaka mennyi ideig marad látható, ha a mutató egy eszköz határoló téglalapján belül van.

• TTDT_INITIAL Az elemleírás ablakának megjelenése előtt lekérheti, hogy mennyi ideig kell a mutatónak az eszköz határoló téglalapján belül maradnia.

• TTDT_RESHOW Kérje le, hogy mennyi ideig tart, amíg a mutató az egyik eszközről a másikra lép.

Visszaadott érték

A megadott késleltetési idő ezredmásodpercben

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TTM_GETDELAYTIMEviselkedését a Windows SDK-ban leírtak szerint.

CToolTipCtrl::GetMargin

Lekéri az elemleírás-ablakhoz beállított felső, bal, alsó és jobb margókat.

void GetMargin(LPRECT lprc) const;

Paraméterek

lprc
Egy RECT olyan struktúra címe, amely megkapja a margó adatait. A szerkezet tagjai RECT nem határoznak meg határoló téglalapot. Ennek az üzenetnek a célja a struktúratagok értelmezése a következőképpen történik:

Tag	Képviselet
top	A felső szegély és az elemleírás felső része közötti távolság képpontban.
left	A bal oldali szegély és a tippszöveg bal vége közötti távolság képpontban.
bottom	Távolság az alsó szegély és a tippszöveg alsó része között képpontban.
right	A jobb oldali szegély és a tippszöveg jobb vége közötti távolság képpontban.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TTM_GETMARGINviselkedését a Windows SDK-ban leírtak szerint.

CToolTipCtrl::GetMaxTipWidth

Lekéri egy elemleírás ablakának maximális szélességét.

int GetMaxTipWidth() const;

Visszaadott érték

Az elemleírás-ablak maximális szélessége.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TTM_GETMAXTIPWIDTHviselkedését a Windows SDK-ban leírtak szerint.

CToolTipCtrl::GetText

Lekéri azt a szöveget, amelyet egy elemleírás-vezérlő tart fenn egy eszközhöz.

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

Paraméterek

str
Hivatkozás az CString eszköz szövegét fogadó objektumra.

pWnd
Mutasson az eszközt tartalmazó ablakra.

nIDTool
Az eszköz azonosítója.

Megjegyzések

A pWnd paraméterek azonosítják nIDTool az eszközt. Ha az eszközt korábban regisztrálták az elemleírás-vezérlővel egy korábbi híváson CToolTipCtrl::AddToolkeresztül, a paraméter által str hivatkozott objektum lesz hozzárendelve az eszköz szövegéhez.

CToolTipCtrl::GetTipBkColor

Lekéri a háttérszínt egy elemleírás-ablakban.

COLORREF GetTipBkColor() const;

Visszaadott érték

A COLORREF háttérszínt jelképező érték.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TTM_GETTIPBKCOLORviselkedését a Windows SDK-ban leírtak szerint.

CToolTipCtrl::GetTipTextColor

Beolvassa a szöveg színét egy elemleírás-ablakban.

COLORREF GetTipTextColor() const;

Visszaadott érték

A COLORREF szöveg színét jelképező érték.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TTM_GETTIPTEXTCOLORviselkedését a Windows SDK-ban leírtak szerint.

CToolTipCtrl::GetTitle

Lekéri az aktuális elemleírás-vezérlő címét.

void GetTitle(PTTGETTITLE pttgt) const;

Paraméterek

pttgt
[kifelé] Mutató az TTGETTITLE elemleírás-vezérlővel kapcsolatos információkat tartalmazó szerkezetre. Amikor ez a metódus visszatér, a pszTitleTTGETTITLE struktúra tagja a cím szövegére mutat.

Megjegyzések

Ez a metódus elküldi a TTM_GETTITLE Windows SDK-ban leírt üzenetet.

CToolTipCtrl::GetToolCount

Lekéri az elemleírás-vezérlővel regisztrált eszközök számát.

int GetToolCount() const;

Visszaadott érték

Az elemleírás-vezérlővel regisztrált eszközök száma.

CToolTipCtrl::GetToolInfo

Lekéri azokat az információkat, amelyeket egy elemleírás-vezérlő tart fenn az eszközről.

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

Paraméterek

ToolInfo
Hivatkozás az TOOLINFO eszköz szövegét fogadó objektumra.

pWnd
Mutasson az eszközt tartalmazó ablakra.

nIDTool
Az eszköz azonosítója.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Az hwnd eszköz azonosításával CToolInfo hivatkozott struktúra és uId azok tagjaiTOOLINFO. Ha az eszközt regisztrálták az elemleírás-vezérlővel egy korábbi híváson AddToolkeresztül, a TOOLINFO struktúra tele van az eszközzel kapcsolatos információkkal.

CToolTipCtrl::HitTest

Tesztel egy pontot annak meghatározásához, hogy az az adott eszköz határoló téglalapja alatt van-e, és ha igen, lekéri az eszközre vonatkozó információkat.

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

Paraméterek

pWnd
Mutasson az eszközt tartalmazó ablakra.

pt
Mutasson egy CPoint olyan objektumra, amely a tesztelni kívánt pont koordinátáit tartalmazza.

lpToolInfo
Mutató az TOOLINFO eszközre vonatkozó információkat tartalmazó szerkezetre.

Visszaadott érték

Nonzero, ha a találatteszt adatai által megadott pont az eszköz határoló téglalapján belül van; egyéb esetben 0.

Megjegyzések

Ha ez a függvény nemzero értéket ad vissza, a hivatkozott lpToolInfo struktúra meg van töltve azon eszköz információival, amelynek téglalapján belül a pont található.

A TTHITTESTINFO struktúra a következőképpen van definiálva:

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

  Az eszköz fogópontját adja meg.

• pt

  Megadja egy pont koordinátáit, ha a pont az eszköz határoló téglalapjában van.

• ti

  Az eszközre vonatkozó információk. A szerkezettel kapcsolatos további információkért TOOLINFO lásd: CToolTipCtrl::GetToolInfo.

CToolTipCtrl::Pop

Eltávolít egy megjelenített elemleírás-ablakot a nézetből.

void Pop();

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TTM_POPviselkedését a Windows SDK-ban leírtak szerint.

CToolTipCtrl::Popup

Az aktuális elemleírás-vezérlő az utolsó egérüzenet koordinátáin jelenik meg.

void Popup();

Megjegyzések

Ez a metódus elküldi a TTM_POPUP Windows SDK-ban leírt üzenetet.

Example

Az alábbi kódpéldában egy elemleírás ablak látható.

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

CToolTipCtrl::RelayEvent

Egérüzenetet ad át egy elemleírás-vezérlőnek a feldolgozáshoz.

void RelayEvent(LPMSG lpMsg);

Paraméterek

lpMsg
Mutasson egy MSG olyan struktúrára, amely tartalmazza a továbbítandó üzenetet.

Megjegyzések

Az elemleírás-vezérlő csak a következő üzeneteket dolgozza fel, amelyeket a rendszer elküld neki RelayEvent:

WM_LBUTTONDOWN	WM_MOUSEMOVE
WM_LBUTTONUP	WM_RBUTTONDOWN
WM_MBUTTONDOWN	WM_RBUTTONUP
WM_MBUTTONUP

Example

Lásd a példát a CPropertySheet::GetTabControl.

CToolTipCtrl::SetDelayTime

Beállítja az elemleírás-vezérlő késleltetési idejét.

void SetDelayTime(UINT nDelay);

void SetDelayTime(
    DWORD dwDuration,
    int iTime);

Paraméterek

nDelay
Ezredmásodpercben adja meg az új késleltetési időt.

dwDuration
A beolvasandó időtartam értékét meghatározó jelölő. Tekintse meg CToolTipCtrl::GetDelayTime az érvényes értékek leírását.

iTime
A megadott késleltetési idő ezredmásodpercben.

Megjegyzések

A késleltetési idő az az időtartam, amíg a kurzornak az elemleírás ablak megjelenése előtt az eszközön kell maradnia. Az alapértelmezett késleltetési idő 500 ezredmásodperc.

CToolTipCtrl::SetMargin

Az elemleírás ablakának felső, bal, alsó és jobb margóit állítja be.

void SetMargin(LPRECT lprc);

Paraméterek

lprc
A RECT beállítandó margóadatokat tartalmazó struktúra címe. A szerkezet tagjai RECT nem határoznak meg határoló téglalapot. Tekintse meg CToolTipCtrl::GetMargin a margó információinak leírását.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TTM_SETMARGINviselkedését a Windows SDK-ban leírtak szerint.

CToolTipCtrl::SetMaxTipWidth

Az elemleírások ablakának maximális szélességét adja meg.

int SetMaxTipWidth(int iWidth);

Paraméterek

iWidth
A beállítandó elemleírások maximális szélessége.

Visszaadott érték

Az előző maximális csúcsszélesség.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TTM_SETMAXTIPWIDTHviselkedését a Windows SDK-ban leírtak szerint.

CToolTipCtrl::SetTipBkColor

Beállítja a háttérszínt egy elemleírás-ablakban.

void SetTipBkColor(COLORREF clr);

Paraméterek

clr
Az új háttérszín.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TTM_SETTIPBKCOLORviselkedését a Windows SDK-ban leírtak szerint.

CToolTipCtrl::SetTipTextColor

A szöveg színét egy elemleírás-ablakban állítja be.

void SetTipTextColor(COLORREF clr);

Paraméterek

clr
Az új szövegszín.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TTM_SETTIPTEXTCOLORviselkedését a Windows SDK-ban leírtak szerint.

CToolTipCtrl::SetTitle

Szabványos ikont és címsztringet ad hozzá egy elemleíráshoz.

BOOL SetTitle(
    UINT uIcon,
    LPCTSTR lpstrTitle);

Paraméterek

uIcon
Lásd icon a Windows SDK-ban TTM_SETTITLE .

lpstrTitle
Mutasson a címsztringre.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TTM_SETTITLEviselkedését a Windows SDK-ban leírtak szerint.

CToolTipCtrl::SetToolInfo

Beállítja azokat az információkat, amelyeket egy elemleírás tart fenn egy eszközhöz.

void SetToolInfo(LPTOOLINFO lpToolInfo);

Paraméterek

lpToolInfo
A beállítandó TOOLINFO információkat meghatározó struktúra mutatója.

CToolTipCtrl::SetToolRect

Új határolókeretet állít be egy eszközhöz.

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

Paraméterek

pWnd
Mutasson az eszközt tartalmazó ablakra.

nIDTool
Az eszköz azonosítója.

lpRect
Mutató az RECT új határoló téglalapot meghatározó struktúrára.

CToolTipCtrl::SetWindowTheme

Beállítja az elemleírás ablakának vizuális stílusát.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Paraméterek

pszSubAppName
A beállított vizualizációstílust tartalmazó Unicode-sztringre mutató mutató.

Visszaadott érték

A visszatérési érték nem használatos.

Megjegyzések

Ez a tagfüggvény a Windows SDK-ban leírtak szerint emulálja az TTM_SETWINDOWTHEME üzenet funkcióit.

CToolTipCtrl::Update

Kényszeríti az aktuális eszközt az újrarajzolt eszközre.

void Update();

CToolTipCtrl::UpdateTipText

Frissíti a vezérlő eszközeinek elemleírás-szövegét.

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

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

Paraméterek

lpszText
Mutasson az eszköz szövegére.

pWnd
Mutasson az eszközt tartalmazó ablakra.

nIDTool
Az eszköz azonosítója.

nIDText
Az eszköz szövegét tartalmazó sztringerőforrás azonosítója.

Lásd még

CWnd osztály
hierarchiadiagram
CToolBar osztály