CToolTipCtrl-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

De functionaliteit van een 'knopinfobesturingselement' wordt ingekapseld in een klein pop-upvenster waarin één regel tekst wordt weergegeven waarin het doel van een hulpprogramma in een toepassing wordt beschreven.

Syntaxis

class CToolTipCtrl : public CWnd

Leden

Openbare constructors

Naam	Description
CToolTipCtrl::CToolTipCtrl	Maakt een CToolTipCtrl object.

Openbare methoden

Naam	Description
CToolTipCtrl::Activate	Hiermee wordt het besturingselement knopinfo geactiveerd en gedeactiveerd.
CToolTipCtrl::AddTool	Registreert een hulpprogramma met het besturingselement knopinfo.
CToolTipCtrl::AdjustRect	Converteert tussen de tekstweergaverechthoek van een besturingselement voor knopinfo en de bijbehorende vensterrechthoek.
CToolTipCtrl::Create	Hiermee maakt u een besturingselement voor knopinfo en koppelt u dit aan een CToolTipCtrl object.
CToolTipCtrl::CreateEx	Hiermee maakt u een besturingselement voor knopinfo met de opgegeven uitgebreide Stijlen van Windows en koppelt u dit aan een CToolTipCtrl object.
CToolTipCtrl::DelTool	Hiermee verwijdert u een hulpmiddel uit het besturingselement knopinfo.
CToolTipCtrl::GetBubbleSize	Haalt de grootte van de knopinfo op.
CToolTipCtrl::GetCurrentTool	Hiermee haalt u informatie op, zoals de grootte, positie en tekst, van het knopinfovenster dat door het huidige besturingselement voor knopinfo wordt weergegeven.
CToolTipCtrl::GetDelayTime	Hiermee haalt u de initiële, pop-up- en weergaveduur op die momenteel is ingesteld voor een besturingselement voor knopinfo.
CToolTipCtrl::GetMargin	Haalt de boven-, linker-, onderste en rechtermarges op die zijn ingesteld voor een knopinfovenster.
CToolTipCtrl::GetMaxTipWidth	Hiermee haalt u de maximale breedte voor een knopinfovenster op.
CToolTipCtrl::GetText	Hiermee haalt u de tekst op die door een besturingselement voor knopinfo voor een hulpmiddel wordt onderhouden.
CToolTipCtrl::GetTipBkColor	Hiermee haalt u de achtergrondkleur op in een knopinfovenster.
CToolTipCtrl::GetTipTextColor	Hiermee haalt u de tekstkleur op in een knopinfovenster.
CToolTipCtrl::GetTitle	Hiermee haalt u de titel van het huidige besturingselement voor knopinfo op.
CToolTipCtrl::GetToolCount	Hiermee haalt u het aantal hulpprogramma's op dat wordt onderhouden door een besturingselement voor knopinfo.
CToolTipCtrl::GetToolInfo	Haalt de informatie op die een besturingselement voor knopinfo over een hulpprogramma onderhoudt.
CToolTipCtrl::HitTest	Test een punt om te bepalen of deze zich binnen de begrenzingsrechthoek van het opgegeven hulpmiddel bevindt. Als dat het zo is, haalt u informatie over het hulpprogramma op.
CToolTipCtrl::Pop	Hiermee verwijdert u een weergegeven knopinfovenster uit de weergave.
CToolTipCtrl::Popup	Hiermee wordt het huidige besturingselement voor knopinfo weergegeven op de coördinaten van het laatste muisbericht.
CToolTipCtrl::RelayEvent	Geeft een muisbericht door aan een besturingselement voor knopinfo voor verwerking.
CToolTipCtrl::SetDelayTime	Hiermee stelt u de initiële, pop-up- en opnieuw weergeven duur in voor een besturingselement voor knopinfo.
CToolTipCtrl::SetMargin	Hiermee stelt u de boven-, linker-, onder- en rechtermarges in voor een knopinfovenster.
CToolTipCtrl::SetMaxTipWidth	Hiermee stelt u de maximale breedte voor een knopinfovenster in.
CToolTipCtrl::SetTipBkColor	Hiermee stelt u de achtergrondkleur in een knopinfovenster in.
CToolTipCtrl::SetTipTextColor	Hiermee stelt u de tekstkleur in een knopinfovenster in.
CToolTipCtrl::SetTitle	Hiermee voegt u een standaardpictogram en een titeltekenreeks toe aan knopinfo.
CToolTipCtrl::SetToolInfo	Hiermee stelt u de informatie in die een knopinfo voor een hulpprogramma onderhoudt.
CToolTipCtrl::SetToolRect	Hiermee stelt u een nieuwe begrenzingsrechthoek in voor een hulpmiddel.
CToolTipCtrl::SetWindowTheme	Hiermee stelt u de visuele stijl van het knopinfovenster in.
CToolTipCtrl::Update	Hiermee dwingt u af dat het huidige hulpprogramma opnieuw wordt getekend.
CToolTipCtrl::UpdateTipText	Hiermee stelt u de knopinfotekst voor een hulpmiddel in.

Opmerkingen

Een hulpprogramma is een venster, zoals een onderliggend venster of besturingselement, of een door de toepassing gedefinieerd rechthoekig gebied binnen het clientgebied van een venster. Knopinfo wordt meestal verborgen, alleen weergegeven wanneer de gebruiker de cursor op een hulpmiddel plaatst en deze gedurende ongeveer een halve seconde laat staan. De knopinfo wordt weergegeven in de buurt van de cursor en verdwijnt wanneer de gebruiker op een muisknop klikt of de cursor van het hulpmiddel verplaatst.

CToolTipCtrl biedt de functionaliteit voor het beheren van de initiële tijd en duur van de knopinfo, de margebreedten rondom de knopinfotekst, de breedte van het knopinfovenster zelf en de achtergrond- en tekstkleur van de knopinfo. Eén besturingselement voor knopinfo kan informatie bieden voor meer dan één hulpprogramma.

De CToolTipCtrl klasse biedt de functionaliteit van het algemene besturingselement voor knopinfo van Windows. Dit besturingselement (en daarom de CToolTipCtrl klasse) is alleen beschikbaar voor programma's die worden uitgevoerd onder Windows 95/98 en Windows NT-versies 3.51 en hoger.

Zie Knopinfo in Windows niet afgeleid van voor meer informatie over het inschakelen van CFrameWndknopinfo.

Zie Besturingselementen en gebruiken CToolTipCtrlvoor meer informatie over het gebruikCToolTipCtrl.

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CToolTipCtrl

Requirements

Rubriek:afxcmn.h

CToolTipCtrl::Activate

Roep deze functie aan om een besturingselement voor knopinfo te activeren of deactiveren.

void Activate(BOOL bActivate);

Parameterwaarden

bActivate
Hiermee geeft u op of het besturingselement knopinfo moet worden geactiveerd of gedeactiveerd.

Opmerkingen

Als bActivate dat het is TRUE, wordt het besturingselement geactiveerd; indien FALSE, wordt het gedeactiveerd.

Wanneer een besturingselement voor knopinfo actief is, wordt de informatie over knopinfo weergegeven wanneer de cursor zich op een hulpmiddel bevindt dat is geregistreerd bij het besturingselement; als deze inactief is, worden de knopinfogegevens niet weergegeven, zelfs niet wanneer de cursor zich op een hulpmiddel bevindt.

Example

Zie het voorbeeld voor CPropertySheet::GetTabControl.

CToolTipCtrl::AddTool

Registreert een hulpprogramma met het besturingselement knopinfo.

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

Parameterwaarden

pWnd
Wijs het venster aan dat het hulpprogramma bevat.

nIDText
Id van de tekenreeksresource die de tekst voor het hulpprogramma bevat.

lpRectTool
Wijs een RECT structuur aan met coördinaten van de begrenzingsrechthoek van het hulpmiddel. De coördinaten zijn relatief ten opzichte van de linkerbovenhoek van het clientgebied van het venster dat is geïdentificeerd door pWnd.

nIDTool
Id van het hulpprogramma.

lpszText
Wijs de tekst voor het hulpmiddel aan. Als deze parameter de waarde LPSTR_TEXTCALLBACKbevat, TTN_NEEDTEXT gaan meldingsberichten naar het bovenliggende venster waarnaar pWnd wordt verwezen.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

De lpRectTool parameters nIDTool moeten beide geldig zijn, of als lpRectTool dat het is NULL, nIDTool 0 zijn.

Een besturingselement voor knopinfo kan worden gekoppeld aan meer dan één hulpprogramma. Roep deze functie aan om een hulpprogramma te registreren bij het besturingselement knopinfo, zodat de informatie die is opgeslagen in de knopinfo wordt weergegeven wanneer de cursor op het hulpmiddel staat.

Opmerking

U kunt geen knopinfo instellen op een statisch besturingselement met behulp van AddTool.

Example

Zie het voorbeeld voor CPropertySheet::GetTabControl.

CToolTipCtrl::AdjustRect

Converteert tussen de tekstweergaverechthoek van een besturingselement voor knopinfo en de bijbehorende vensterrechthoek.

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

Parameterwaarden

lprc
Wijs een RECT structuur aan die een rechthoek met knopinfovensters of een tekstweergaverechthoek bevat.

bLarger
Als TRUE, lprc wordt gebruikt om een tekstweergave rechthoek op te geven en ontvangt deze de bijbehorende vensterrechthoek. Als FALSE, lprc wordt gebruikt om een vensterrechthoek op te geven en ontvangt deze de bijbehorende rechthoek voor het weergeven van tekst.

Retourwaarde

Niet-nul als de rechthoek is aangepast; anders 0.

Opmerkingen

Deze lidfunctie berekent de tekstweergaverechthoek van een besturingselement voor knopinfo uit de vensterrechthoek of de rechthoek van het knopinfovenster die nodig is om een opgegeven rechthoek voor tekstweergave weer te geven.

Deze lidfunctie implementeert het gedrag van het Win32-bericht TTM_ADJUSTRECT, zoals beschreven in de Windows SDK.

CToolTipCtrl::Create

Hiermee maakt u een besturingselement voor knopinfo en koppelt u dit aan een CToolTipCtrl object.

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

Parameterwaarden

pParentWnd
Hiermee geeft u het bovenliggende venster van het besturingselement voor knopinfo, meestal een CDialog. Het mag niet zijn NULL.

dwStyle
Hiermee geeft u de stijl van het besturingselement voor knopinfo op. Zie de sectie Opmerkingen voor meer informatie.

Retourwaarde

Niet-nul als het CToolTipCtrl object is gemaakt; anders 0.

Opmerkingen

U maakt een CToolTipCtrl in twee stappen. Roep eerst de constructor aan om het CToolTipCtrl object samen te stellen en roep Create vervolgens aan om het besturingselement knopinfo te maken en deze aan het CToolTipCtrl object te koppelen.

De dwStyle parameter kan elke combinatie van vensterstijlen zijn. Daarnaast heeft een besturingselement voor knopinfo twee klassespecifieke stijlen: TTS_ALWAYSTIP en TTS_NOPREFIX.

Stijl	Meaning
TTS_ALWAYSTIP	Hiermee geeft u op dat de knopinfo wordt weergegeven wanneer de cursor zich op een hulpmiddel bevindt, ongeacht of het venster eigenaar van het besturingselement voor knopinfo actief of inactief is. Zonder deze stijl wordt het besturingselement knopinfo weergegeven wanneer het venster eigenaar van het hulpprogramma actief is, maar niet wanneer het inactief is.
TTS_NOPREFIX	Met deze stijl voorkomt u dat het systeem het teken ampersand (&) uit een tekenreeks verwijdert. Als een besturingselement voor knopinfo niet de TTS_NOPREFIX stijl heeft, worden ampersand tekens automatisch door het systeem verwijderd, zodat een toepassing dezelfde tekenreeks kan gebruiken als een menu-item en als tekst in een besturingselement voor knopinfo.

Een besturingselement voor knopinfo heeft de WS_POPUP stijlen en WS_EX_TOOLWINDOW vensters, ongeacht of u deze opgeeft bij het maken van het besturingselement.

Als u een besturingselement voor knopinfo met uitgebreide vensterstijlen wilt maken, roept CToolTipCtrl::CreateEx u aan in plaats van Create.

Example

Zie het voorbeeld voor CPropertySheet::GetTabControl.

CToolTipCtrl::CreateEx

Hiermee maakt u een besturingselement (een onderliggend venster) en koppelt u dit aan het CToolTipCtrl object.

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

Parameterwaarden

pParentWnd
Een aanwijzer naar het venster dat het bovenliggende besturingselement is.

dwStyle
Hiermee geeft u de stijl van het besturingselement voor knopinfo op. Zie de sectie Opmerkingen van Create voor meer informatie.

dwStyleEx
Hiermee geeft u de uitgebreide stijl van het besturingselement dat wordt gemaakt. Zie de dwExStyle parameter voor in de Windows SDK voor CreateWindowEx een lijst met uitgebreide Windows-stijlen.

Retourwaarde

Nonzero als dit anders 0 lukt.

Opmerkingen

Gebruik CreateEx in plaats van Create uitgebreide Windows-stijlen toe te passen, die zijn opgegeven door het voorwoord WS_EX_voor de uitgebreide Stijl van Windows.

CToolTipCtrl::CToolTipCtrl

Maakt een CToolTipCtrl object.

CToolTipCtrl();

Opmerkingen

U moet aanroepen Create nadat u het object hebt gemaakt.

Example

// Declare a CToolTipCtrl object.
CToolTipCtrl m_ToolTipCtrl;

CToolTipCtrl::DelTool

Hiermee verwijdert u het hulpprogramma dat is opgegeven door pWnd en nIDTool uit de verzameling hulpprogramma's die worden ondersteund door een besturingselement voor knopinfo.

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

Parameterwaarden

pWnd
Wijs het venster aan dat het hulpprogramma bevat.

nIDTool
Id van het hulpprogramma.

CToolTipCtrl::GetBubbleSize

Haalt de grootte van de knopinfo op.

CSize GetBubbleSize(LPTOOLINFO lpToolInfo) const;

Parameterwaarden

lpToolInfo
Een aanwijzer naar de structuur van TOOLINFO de knopinfo.

Retourwaarde

De grootte van de knopinfo.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TTM_GETBUBBLESIZE, zoals beschreven in de Windows SDK.

CToolTipCtrl::GetCurrentTool

Hiermee haalt u informatie op, zoals de grootte, positie en tekst, van het knopinfovenster dat wordt weergegeven door het huidige besturingselement voor knopinfo.

BOOL GetCurrentTool(LPTOOLINFO lpToolInfo) const;

Parameterwaarden

lpToolInfo
[uit] Wijs een TOOLINFO structuur aan die informatie ontvangt over het huidige knopinfovenster.

Retourwaarde

TRUE als de informatie is opgehaald; anders, FALSE.

Opmerkingen

Met deze methode wordt het TTM_GETCURRENTTOOL bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

In het volgende codevoorbeeld wordt informatie opgehaald over het huidige knopinfovenster.

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

Haalt de initiële, pop-up- en weergaveduur op die momenteel is ingesteld voor een besturingselement voor knopinfo.

int GetDelayTime(DWORD dwDuration) const;

Parameterwaarden

dwDuration
Vlag die aangeeft welke duurwaarde wordt opgehaald. Deze parameter kan een van de volgende waarden zijn:

• TTDT_AUTOPOP Haal de tijdsduur op die het venster knopinfo zichtbaar blijft als de aanwijzer stationair is binnen de begrenzingsrechthoek van een hulpmiddel.

• TTDT_INITIAL Haal de tijdsduur op waarop de aanwijzer stationair moet blijven binnen de begrenzingsrechthoek van een hulpmiddel voordat het venster knopinfo wordt weergegeven.

• TTDT_RESHOW Haal de tijdsduur op die nodig is voor volgende knopinfovensters worden weergegeven wanneer de aanwijzer van het ene hulpprogramma naar het andere wordt verplaatst.

Retourwaarde

De opgegeven vertragingstijd, in milliseconden

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TTM_GETDELAYTIME, zoals beschreven in de Windows SDK.

CToolTipCtrl::GetMargin

Haalt de boven-, linker-, onder- en rechtermarges op die zijn ingesteld voor een knopinfovenster.

void GetMargin(LPRECT lprc) const;

Parameterwaarden

lprc
Adres van een RECT structuur die de margegegevens ontvangt. De leden van de RECT structuur definiëren geen begrenzingsrechthoek. Voor dit bericht worden de structuurleden als volgt geïnterpreteerd:

Lid	Vertegenwoordiging
top	Afstand tussen bovenrand en bovenkant van knopinfotekst, in pixels.
left	Afstand tussen linkerrand en linkereinde van tiptekst, in pixels.
bottom	Afstand tussen onderrand en onder aan tiptekst, in pixels.
right	Afstand tussen rechterrand en rechtereinde van punttekst, in pixels.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TTM_GETMARGIN, zoals beschreven in de Windows SDK.

CToolTipCtrl::GetMaxTipWidth

Hiermee haalt u de maximale breedte voor een knopinfovenster op.

int GetMaxTipWidth() const;

Retourwaarde

De maximale breedte voor een knopinfovenster.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TTM_GETMAXTIPWIDTH, zoals beschreven in de Windows SDK.

CToolTipCtrl::GetText

Hiermee haalt u de tekst op die door een besturingselement voor knopinfo voor een hulpmiddel wordt onderhouden.

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

Parameterwaarden

str
Verwijzing naar een CString object dat de tekst van het hulpmiddel ontvangt.

pWnd
Wijs het venster aan dat het hulpprogramma bevat.

nIDTool
Id van het hulpprogramma.

Opmerkingen

De pWnd en nIDTool parameters identificeren het hulpprogramma. Als dat hulpprogramma eerder is geregistreerd bij het besturingselement knopinfo via een eerdere aanroep, CToolTipCtrl::AddToolwordt het object waarnaar wordt verwezen door de str parameter, toegewezen aan de tekst van het hulpprogramma.

CToolTipCtrl::GetTipBkColor

Hiermee haalt u de achtergrondkleur op in een knopinfovenster.

COLORREF GetTipBkColor() const;

Retourwaarde

Een COLORREF waarde die de achtergrondkleur vertegenwoordigt.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TTM_GETTIPBKCOLOR, zoals beschreven in de Windows SDK.

CToolTipCtrl::GetTipTextColor

Hiermee haalt u de tekstkleur op in een knopinfovenster.

COLORREF GetTipTextColor() const;

Retourwaarde

Een COLORREF waarde die de tekstkleur vertegenwoordigt.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TTM_GETTIPTEXTCOLOR, zoals beschreven in de Windows SDK.

CToolTipCtrl::GetTitle

Hiermee haalt u de titel van het huidige besturingselement voor knopinfo op.

void GetTitle(PTTGETTITLE pttgt) const;

Parameterwaarden

pttgt
[uit] Wijs een TTGETTITLE structuur aan met informatie over het besturingselement knopinfo. Wanneer deze methode wordt geretourneerd, verwijst het pszTitle lid van de TTGETTITLE structuur naar de tekst van de titel.

Opmerkingen

Met deze methode wordt het TTM_GETTITLE bericht verzonden, dat wordt beschreven in de Windows SDK.

CToolTipCtrl::GetToolCount

Hiermee haalt u het aantal hulpprogramma's op dat is geregistreerd bij het besturingselement knopinfo.

int GetToolCount() const;

Retourwaarde

Een aantal hulpprogramma's dat is geregistreerd bij het besturingselement knopinfo.

CToolTipCtrl::GetToolInfo

Haalt de informatie op die een besturingselement voor knopinfo over een hulpprogramma onderhoudt.

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

Parameterwaarden

ToolInfo
Verwijzing naar een TOOLINFO object dat de tekst van het hulpmiddel ontvangt.

pWnd
Wijs het venster aan dat het hulpprogramma bevat.

nIDTool
Id van het hulpprogramma.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

De hwnd en uId leden van de TOOLINFO structuur waarnaar wordt verwezen door CToolInfo het hulpprogramma te identificeren. Als dat hulpprogramma is geregistreerd bij het besturingselement knopinfo via een eerdere aanroep, AddToolwordt de TOOLINFO structuur gevuld met informatie over het hulpprogramma.

CToolTipCtrl::HitTest

Test een punt om te bepalen of deze zich in de begrenzingsrechthoek van het opgegeven hulpmiddel bevindt en, als dat het het bedoeling is, informatie over het hulpprogramma op te halen.

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

Parameterwaarden

pWnd
Wijs het venster aan dat het hulpprogramma bevat.

pt
Wijs een CPoint object aan met de coördinaten van het te testen punt.

lpToolInfo
Aanwijzer naar TOOLINFO structuur die informatie over het hulpprogramma bevat.

Retourwaarde

Niet-nul als het punt dat is opgegeven door de informatie over de hittest zich in de begrenzingsrechthoek van het hulpmiddel bevindt; anders 0.

Opmerkingen

Als deze functie een niet-nulwaarde retourneert, wordt de structuur waarop lpToolInfo wordt verwezen, gevuld met informatie over het hulpmiddel binnen de rechthoek van het punt.

De TTHITTESTINFO structuur wordt als volgt gedefinieerd:

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

  Hiermee geeft u de ingang van het hulpprogramma.

• pt

  Hiermee geeft u de coördinaten van een punt op als het punt zich in de begrenzingsrechthoek van het hulpmiddel bevindt.

• ti

  Informatie over het hulpprogramma. Zie voor meer informatie over de TOOLINFO structuur CToolTipCtrl::GetToolInfo.

CToolTipCtrl::Pop

Hiermee verwijdert u een weergegeven knopinfovenster uit de weergave.

void Pop();

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TTM_POP, zoals beschreven in de Windows SDK.

CToolTipCtrl::Popup

Hiermee wordt het huidige besturingselement voor knopinfo weergegeven op de coördinaten van het laatste muisbericht.

void Popup();

Opmerkingen

Met deze methode wordt het TTM_POPUP bericht verzonden, dat wordt beschreven in de Windows SDK.

Example

In het volgende codevoorbeeld wordt een venster met knopinfo weergegeven.

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

CToolTipCtrl::RelayEvent

Geeft een muisbericht door aan een besturingselement voor knopinfo voor verwerking.

void RelayEvent(LPMSG lpMsg);

Parameterwaarden

lpMsg
Wijs een MSG structuur aan die het bericht bevat dat moet worden doorgestuurd.

Opmerkingen

Een besturingselement voor knopinfo verwerkt alleen de volgende berichten, die naar het besturingselement worden verzonden:RelayEvent

WM_LBUTTONDOWN	WM_MOUSEMOVE
WM_LBUTTONUP	WM_RBUTTONDOWN
WM_MBUTTONDOWN	WM_RBUTTONUP
WM_MBUTTONUP

Example

Zie het voorbeeld voor CPropertySheet::GetTabControl.

CToolTipCtrl::SetDelayTime

Hiermee stelt u de vertragingstijd voor een besturingselement voor knopinfo in.

void SetDelayTime(UINT nDelay);

void SetDelayTime(
    DWORD dwDuration,
    int iTime);

Parameterwaarden

nDelay
Hiermee geeft u de nieuwe vertragingstijd, in milliseconden.

dwDuration
Vlag die aangeeft welke duurwaarde wordt opgehaald. Zie CToolTipCtrl::GetDelayTime voor een beschrijving van de geldige waarden.

iTime
De opgegeven vertragingstijd, in milliseconden.

Opmerkingen

De vertragingstijd is de tijdsduur die de cursor op een hulpmiddel moet blijven staan voordat het venster met knopinfo wordt weergegeven. De standaardvertragingstijd is 500 milliseconden.

CToolTipCtrl::SetMargin

Hiermee stelt u de boven-, linker-, onder- en rechtermarges in voor een knopinfovenster.

void SetMargin(LPRECT lprc);

Parameterwaarden

lprc
Adres van een RECT structuur die de margegegevens bevat die moeten worden ingesteld. De leden van de RECT structuur definiëren geen begrenzingsrechthoek. Zie CToolTipCtrl::GetMargin voor een beschrijving van de margegegevens.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TTM_SETMARGIN, zoals beschreven in de Windows SDK.

CToolTipCtrl::SetMaxTipWidth

Hiermee stelt u de maximale breedte voor een knopinfovenster in.

int SetMaxTipWidth(int iWidth);

Parameterwaarden

iWidth
De maximale breedte van knopinfovensters die u wilt instellen.

Retourwaarde

De vorige maximale puntbreedte.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TTM_SETMAXTIPWIDTH, zoals beschreven in de Windows SDK.

CToolTipCtrl::SetTipBkColor

Hiermee stelt u de achtergrondkleur in een knopinfovenster in.

void SetTipBkColor(COLORREF clr);

Parameterwaarden

clr
De nieuwe achtergrondkleur.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TTM_SETTIPBKCOLOR, zoals beschreven in de Windows SDK.

CToolTipCtrl::SetTipTextColor

Hiermee stelt u de tekstkleur in een knopinfovenster in.

void SetTipTextColor(COLORREF clr);

Parameterwaarden

clr
De nieuwe tekstkleur.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TTM_SETTIPTEXTCOLOR, zoals beschreven in de Windows SDK.

CToolTipCtrl::SetTitle

Hiermee voegt u een standaardpictogram en een titeltekenreeks toe aan knopinfo.

BOOL SetTitle(
    UINT uIcon,
    LPCTSTR lpstrTitle);

Parameterwaarden

uIcon
Zie icon in TTM_SETTITLE de Windows SDK.

lpstrTitle
Aanwijzer naar de titeltekenreeks.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht TTM_SETTITLE, zoals beschreven in de Windows SDK.

CToolTipCtrl::SetToolInfo

Hiermee stelt u de informatie in die een knopinfo voor een hulpprogramma onderhoudt.

void SetToolInfo(LPTOOLINFO lpToolInfo);

Parameterwaarden

lpToolInfo
Een aanwijzer naar een TOOLINFO structuur die de informatie aangeeft die moet worden ingesteld.

CToolTipCtrl::SetToolRect

Hiermee stelt u een nieuwe begrenzingsrechthoek in voor een hulpmiddel.

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

Parameterwaarden

pWnd
Wijs het venster aan dat het hulpprogramma bevat.

nIDTool
Id van het hulpprogramma.

lpRect
Aanwijzer naar een RECT structuur die de nieuwe begrenzingsrechthoek aangeeft.

CToolTipCtrl::SetWindowTheme

Hiermee stelt u de visuele stijl van het knopinfovenster in.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parameterwaarden

pszSubAppName
Een aanwijzer naar een Unicode-tekenreeks die de visuele stijl bevat die u wilt instellen.

Retourwaarde

De retourwaarde wordt niet gebruikt.

Opmerkingen

Met deze lidfunctie wordt de functionaliteit van het TTM_SETWINDOWTHEME bericht geëmuleren, zoals beschreven in de Windows SDK.

CToolTipCtrl::Update

Hiermee dwingt u af dat het huidige hulpprogramma opnieuw wordt getekend.

void Update();

CToolTipCtrl::UpdateTipText

Hiermee werkt u de knopinfotekst voor de hulpprogramma's van dit besturingselement bij.

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

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

Parameterwaarden

lpszText
Wijs de tekst voor het hulpmiddel aan.

pWnd
Wijs het venster aan dat het hulpprogramma bevat.

nIDTool
Id van het hulpprogramma.

nIDText
Id van de tekenreeksresource die de tekst voor het hulpprogramma bevat.

Zie ook

CWnd klasse
Hiërarchiegrafiek
CToolBar klasse