Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
Opmerking
De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.
Biedt de functionaliteit van het algemene SysLink-besturingselement van Windows.
Syntaxis
class CLinkCtrl : public CWnd
Leden
Openbare constructors
| Naam | Description |
|---|---|
| CLinkCtrl::CLinkCtrl | Maakt een CLinkCtrl object. |
Openbare methoden
| Naam | Description |
|---|---|
| CLinkCtrl::Maken | Hiermee maakt u een koppelingsbeheer en koppelt u dit aan een CLinkCtrl object. |
| CLinkCtrl::CreateEx | Hiermee maakt u een koppelingsbeheer met uitgebreide stijlen en koppelt u dit aan een CLinkCtrl object. |
| CLinkCtrl::GetIdealHeight | Haalt de ideale hoogte van het koppelingsbeheer op. |
| CLinkCtrl::GetIdealSize | Berekent de voorkeurshoogte van de koppelingstekst voor het huidige koppelingsbeheer, afhankelijk van de opgegeven breedte van de koppeling. |
| CLinkCtrl::GetItem | Haalt de statussen en kenmerken van een koppelingsbeheeritem op. |
| CLinkCtrl::GetItemID | Haalt de id van een koppelingsbeheeritem op. |
| CLinkCtrl::GetItemState | Haalt de status van het koppelingsbeheeritem op. |
| CLinkCtrl::GetItemUrl | Haalt de URL op die wordt vertegenwoordigd door het koppelingsbeheeritem. |
| CLinkCtrl::HitTest | Bepaalt of de gebruiker op de opgegeven koppeling heeft geklikt. |
| CLinkCtrl::SetItem | Hiermee stelt u de statussen en kenmerken van een koppelingsbeheeritem in. |
| CLinkCtrl::SetItemID | Hiermee stelt u de id van een koppelingsbeheeritem in. |
| CLinkCtrl::SetItemState | Hiermee stelt u de status van het koppelingsbeheeritem in. |
| CLinkCtrl::SetItemUrl | Hiermee stelt u de URL in die wordt vertegenwoordigd door het koppelingsbeheeritem. |
Opmerkingen
Een koppelingsbesturingselement biedt een handige manier om hypertekstkoppelingen in een venster in te sluiten. Het werkelijke besturingselement is een venster dat gemarkeerde tekst weergeeft en de juiste toepassingen start wanneer de gebruiker op een ingesloten koppeling klikt. Meerdere koppelingen worden ondersteund binnen één besturingselement en kunnen worden geopend door een index op basis van nul.
Dit besturingselement (en daarom de CLinkCtrl klasse) is alleen beschikbaar voor programma's die worden uitgevoerd onder Windows XP en hoger.
Zie SysLink-besturingselement in de Windows SDK voor meer informatie.
Overnamehiërarchie
CLinkCtrl
Requirements
Koptekst: afxcmn.h
CLinkCtrl::CLinkCtrl
Maakt een CLinkCtrl object.
CLinkCtrl();
CLinkCtrl::Maken
Hiermee maakt u een koppelingsbeheer en koppelt u dit aan een CLinkCtrl object.
virtual BOOL Create(
LPCTSTR lpszLinkMarkup,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
virtual BOOL Create(DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parameterwaarden
lpszLinkMarkup
Aanwijzer naar een tekenreeks met nulbeëindigd tekenreeks die de gemarkeerde tekst bevat die moet worden weergegeven. Zie de sectie 'Markeringen en koppelingstoegang' in het onderwerp Overzicht van SysLink-besturingselementen voor meer informatie.
dwStyle
Hiermee geeft u de stijl van het koppelings besturingselement op. Pas een combinatie van besturingsstijlen toe. Zie Algemene besturingsstijlen in de Windows SDK voor meer informatie.
Rect
Hiermee geeft u de grootte en positie van het koppelingsbeheer op. Het kan een CRect-object of een RECT-structuur zijn.
pParentWnd
Hiermee geeft u het bovenliggende venster van het koppelingsbeheer. Deze mag niet NULL zijn.
nID
Hiermee geeft u de id van het koppelingsbeheer.
Retourwaarde
WAAR als initialisatie is geslaagd; anders ONWAAR.
Opmerkingen
U maakt een CLinkCtrl object in twee stappen. Roep eerst de constructor aan en roep Createhet vervolgens aan, waarmee het koppelingsbeheer wordt gemaakt en aan het CLinkCtrl object wordt gekoppeld. Als u uitgebreide vensterstijlen wilt gebruiken met uw besturingselement, roept u CLinkCtrl::CreateEx aan in plaats van Create.
De tweede vorm van de Create methode is afgeschaft. Gebruik het eerste formulier waarmee de parameter lpszLinkMarkup wordt opgegeven.
Example
Het eerste codevoorbeeld definieert twee variabelen, benoemd m_Link1 en m_Link2, die worden gebruikt voor toegang tot twee koppelingsbesturingselementen.
afx_msg void OnNMClickSyslink1(NMHDR *pNMHDR, LRESULT *pResult);
afx_msg void OnNMClickSyslink2(NMHDR *pNMHDR, LRESULT *pResult);
// Link variable associated with resource editor CLinkCtrl control.
CLinkCtrl m_Link1;
// Link variable associated with programmatic CLinkCtrl control.
CLinkCtrl m_Link2;
In het volgende codevoorbeeld wordt één koppelingsbeheer gemaakt op basis van de locatie van een ander koppelingsbeheer. Het resourcelaadprogramma maakt het eerste koppelingsbeheer wanneer uw toepassing wordt gestart. Wanneer uw toepassing de methode OnInitDialog invoert, maakt u het tweede koppelingsbeheer ten opzichte van de positie van het eerste koppelingsbeheer. Vervolgens wijzigt u het formaat van het tweede koppelings besturingselement zodat deze past bij de tekst die wordt weergegeven.
CRect rect1, rect2;
int height = 0;
SIZE sz = {0};
PTCHAR url =
_T("Link 2) ")
_T("<A HREF=\"https://visualstudio.microsoft.com\">")
_T("Microsoft VC++ Home")
_T("</A>");
m_Link1.GetWindowRect(&rect1);
m_Link2.Create(url,
(WS_VISIBLE | WS_TABSTOP | WS_CHILD | WS_BORDER),
CRect(
rect1.left, rect1.bottom + rect1.Height(),
rect1.right, rect1.bottom + (2 * rect1.Height())),
this,
IDC_SYSLINK2);
m_Link2.GetClientRect(&rect2);
// The return value of GetIdealSize() is the same as sz.cy
height = m_Link2.GetIdealSize(
rect2.Width(), &sz);
if ((sz.cx != 0) && (sz.cy != 0))
{
int rc = m_Link2.SetWindowPos(
this,
0, 0, sz.cx, sz.cy,
(SWP_NOMOVE | SWP_NOZORDER | SWP_NOREPOSITION | SWP_NOACTIVATE));
}
CLinkCtrl::CreateEx
Hiermee maakt u een koppelingsbeheer met uitgebreide stijlen en koppelt u dit aan een CLinkCtrl object.
virtual BOOL CreateEx(
LPCTSTR lpszLinkMarkup,
DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
virtual BOOL CreateEx(DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parameterwaarden
lpszLinkMarkup
Aanwijzer naar een tekenreeks met nulbeëindigd tekenreeks die de gemarkeerde tekst bevat die moet worden weergegeven. Zie de sectie 'Markeringen en koppelingstoegang' in het onderwerp Overzicht van SysLink-besturingselementen voor meer informatie.
dwExStyle
Hiermee geeft u de uitgebreide stijl van het koppelings besturingselement. Zie de dwExStyle-parameter voor CreateWindowEx in de Windows SDK voor een lijst met uitgebreide Windows-stijlen.
dwStyle
Hiermee geeft u de stijl van het koppelings besturingselement op. Pas een combinatie van besturingsstijlen toe. Zie Algemene besturingsstijlen in de Windows SDK voor meer informatie.
Rect
Hiermee geeft u de grootte en positie van het koppelingsbeheer op. Het kan een CRect-object of een RECT-structuur zijn.
pParentWnd
Hiermee geeft u het bovenliggende venster van het koppelingsbeheer. Deze mag niet NULL zijn.
nID
Hiermee geeft u de id van het koppelingsbeheer.
Retourwaarde
WAAR als initialisatie is geslaagd; anders ONWAAR.
Opmerkingen
Gebruik CreateEx in plaats van Maken om uitgebreide Windows-stijlconstanten toe te passen.
De tweede vorm van de CreateEx methode is afgeschaft. Gebruik het eerste formulier waarmee de parameter lpszLinkMarkup wordt opgegeven.
CLinkCtrl::GetIdealHeight
Haalt de ideale hoogte van het koppelingsbeheer op.
int GetIdealHeight() const;
Retourwaarde
De ideale hoogte van het besturingselement, in pixels.
Opmerkingen
Deze lidfunctie implementeert het gedrag van het Win32-bericht LM_GETIDEALHEIGHT, zoals beschreven in de Windows SDK.
CLinkCtrl::GetIdealSize
Berekent de voorkeurshoogte van de koppelingstekst voor het huidige koppelingsbeheer, afhankelijk van de opgegeven breedte van de koppeling.
int GetIdealSize(
int cxMaxWidth,
SIZE* pSize) const;
Parameterwaarden
cxMaxWidth
[in] De maximale breedte van de koppeling, in pixels.
pSize
[uit] Een aanwijzer naar een Windows SIZE-structuur . Wanneer deze methode wordt geretourneerd, bevat het cy-lid van de SIZE structuur de ideale hoogte van de koppelingstekst voor de breedte van de koppelingstekst die is opgegeven door cxMaxWidth. Het cx-lid van de structuur bevat de breedte van de koppelingstekst die daadwerkelijk nodig is.
Retourwaarde
De voorkeurshoogte van de koppelingstekst, in pixels. De retourwaarde is hetzelfde als de waarde van het cy-lid van de SIZE structuur.
Opmerkingen
Zie het voorbeeld in CLinkCtrl::Create voor een voorbeeld van de GetIdealSize methode.
Met deze methode wordt het LM_GETIDEALSIZE bericht verzonden, dat wordt beschreven in de Windows SDK.
CLinkCtrl::GetItem
Haalt de statussen en kenmerken van een koppelingsbeheeritem op.
BOOL GetItem(PLITEM pItem) const;
Parameterwaarden
pItem
Een aanwijzer naar een LITEM-structuur om informatie over items te ontvangen.
Retourwaarde
Retourneert TRUE bij succes, ONWAAR bij mislukt.
Opmerkingen
Deze lidfunctie implementeert het gedrag van het Win32-bericht LM_GETITEM, zoals beschreven in de Windows SDK.
CLinkCtrl::GetItemID
Haalt de id van een koppelingsbeheeritem op.
BOOL GetItemID(
int iLink,
CString& strID) const;
BOOL GetItemID(
int iLink,
LPWSTR szID,
UINT cchID) const;
Parameterwaarden
Ilink
De index van een koppelingsbeheeritem.
strID
Een CStringT-object met de id van het opgegeven item.
szID
Een tekenreeks met null-beëindiging die de id van het opgegeven item bevat.
cchID
De grootte in tekens van de szID-buffer .
Retourwaarde
Retourneert TRUE bij succes, ONWAAR bij mislukt.
Opmerking
Deze functie retourneert ook FALSE als de buffer van szID of strID kleiner is dan MAX_LINKID_TEXT.
Opmerkingen
Hiermee haalt u de id van een specifiek item voor koppelingsbeheer op. Zie het Win32-bericht LM_GETITEM in de Windows SDK voor meer informatie.
CLinkCtrl::GetItemState
Haalt de status van het koppelingsbeheeritem op.
BOOL GetItemState(
int iLink,
UINT* pnState,
UINT stateMask = LIS_FOCUSED | LIS_ENABLED | LIS_VISITED) const;
Parameterwaarden
Ilink
De index van een koppelingsbeheeritem.
pnState
De waarde van het opgegeven statusitem.
stateMask
Combinatie van vlaggen die beschrijven welk statusitem moet worden getyp. Zie de beschrijving van het state lid in de LITEM-structuur voor een lijst met waarden. Toegestane items zijn identiek aan de items die zijn toegestaan in state.
Retourwaarde
Retourneert TRUE bij succes, ONWAAR bij mislukt.
Opmerkingen
Haalt de waarde op van het opgegeven statusitem van een specifiek item voor koppelingsbeheer. Zie het Win32-bericht LM_GETITEM in de Windows SDK voor meer informatie.
CLinkCtrl::GetItemUrl
Haalt de URL op die wordt vertegenwoordigd door het koppelingsbeheeritem.
BOOL GetItemUrl(
int iLink,
CString& strUrl) const;
BOOL GetItemUrl(
int iLink,
LPWSTR szUrl,
UINT cchUrl) const;
Parameterwaarden
Ilink
De index van een koppelingsbeheeritem.
strUrl
Een CStringT-object met de URL die wordt vertegenwoordigd door het opgegeven item
szUrl
Een door null beëindigde tekenreeks die de URL bevat die wordt vertegenwoordigd door het opgegeven item
cchUrl
De grootte in tekens van de szURL-buffer .
Retourwaarde
Retourneert TRUE bij succes, ONWAAR bij mislukt.
Opmerking
Deze functie retourneert ook FALSE als de buffer van szUrl of strUrl kleiner is dan MAX_LINKID_TEXT.
Opmerkingen
Haalt de URL op die wordt vertegenwoordigd door het opgegeven koppelingsbeheeritem. Zie het Win32-bericht LM_GETITEM in de Windows SDK voor meer informatie.
CLinkCtrl::HitTest
Bepaalt of de gebruiker op de opgegeven koppeling heeft geklikt.
BOOL HitTest(PLHITTESTINFO phti) const;
Parameterwaarden
phti
Wijs een LHITTESTINFO structuur aan met informatie over de koppeling die de gebruiker heeft geklikt.
Retourwaarde
Retourneert TRUE bij succes, ONWAAR bij mislukt.
Opmerkingen
Deze lidfunctie implementeert het gedrag van het Win32-bericht LM_HITTEST, zoals beschreven in de Windows SDK.
CLinkCtrl::SetItem
Hiermee stelt u de statussen en kenmerken van een koppelingsbeheeritem in.
BOOL SetItem(PLITEM pItem);
Parameterwaarden
pItem
Een aanwijzer naar een LITEM-structuur die de informatie bevat die moet worden ingesteld.
Retourwaarde
Retourneert TRUE bij succes, ONWAAR bij mislukt.
Opmerkingen
Deze lidfunctie implementeert het gedrag van het Win32-bericht LM_SETITEM, zoals beschreven in de Windows SDK.
CLinkCtrl::SetItemID
Haalt de id van een koppelingsbeheeritem op.
BOOL SetItemID(
int iLink,
LPCWSTR szID);
Parameterwaarden
Ilink
De index van een koppelingsbeheeritem.
szID
Een tekenreeks met null-beëindiging die de id van het opgegeven item bevat.
Retourwaarde
Retourneert TRUE bij succes, ONWAAR bij mislukt.
Opmerkingen
Hiermee stelt u de id van een specifiek item voor koppelingsbeheer in. Zie het Win32-bericht LM_SETITEM in de Windows SDK voor meer informatie.
CLinkCtrl::SetItemState
Haalt de status van het koppelingsbeheeritem op.
BOOL SetItemState(
int iLink,
UINT state,
UINT stateMask = LIS_FOCUSED | LIS_ENABLED | LIS_VISITED);
Parameterwaarden
Ilink
De index van een koppelingsbeheeritem.
pnState
De waarde van het opgegeven statusitem dat wordt ingesteld.
stateMask
Combinatie van vlaggen die het statusitem beschrijven dat wordt ingesteld. Zie de beschrijving van het state lid in de LITEM-structuur voor een lijst met waarden. Toegestane items zijn identiek aan de items die zijn toegestaan in state.
Retourwaarde
Retourneert TRUE bij succes, ONWAAR bij mislukt.
Opmerkingen
Hiermee stelt u de waarde van het opgegeven statusitem van een specifiek item voor koppelingsbeheer in. Zie het Win32-bericht LM_SETITEM in de Windows SDK voor meer informatie.
CLinkCtrl::SetItemUrl
Hiermee stelt u de URL in die wordt vertegenwoordigd door het koppelingsbeheeritem.
BOOL SetItemUrl(
int iLink,
LPCWSTR szUrl);
Parameterwaarden
Ilink
De index van een koppelingsbeheeritem.
szUrl
Een door null beëindigde tekenreeks die de URL bevat die wordt vertegenwoordigd door het opgegeven item
Retourwaarde
Retourneert TRUE bij succes, ONWAAR bij mislukt.
Opmerkingen
Hiermee stelt u de URL in die wordt vertegenwoordigd door het opgegeven item voor koppelingsbeheer. Zie het Win32-bericht LM_SETITEM in de Windows SDK voor meer informatie.