CLinkCtrl 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.

A Windows általános SysLink-vezérlő funkcióit biztosítja.

Szemantika

class CLinkCtrl : public CWnd

Tagok

Nyilvános konstruktorok

Név	Description
CLinkCtrl::CLinkCtrl	Egy `CLinkCtrl` objektumot hoz létre.

Nyilvános metódusok

Név	Description
CLinkCtrl::Létrehozás	Létrehoz egy hivatkozásvezérlőt, és csatolja egy `CLinkCtrl` objektumhoz.
CLinkCtrl::CreateEx	Kiterjesztett stílusokkal rendelkező hivatkozásvezérlőt hoz létre, és egy `CLinkCtrl` objektumhoz csatolja.
CLinkCtrl::GetIdealHeight	Lekéri a kapcsolatvezérlő ideális magasságát.
CLinkCtrl::GetIdealSize	Kiszámítja a hivatkozás szövegének előnyben részesített magasságát az aktuális hivatkozásvezérlőhöz a hivatkozás megadott szélességétől függően.
CLinkCtrl::GetItem	Lekéri egy hivatkozásvezérlő elem állapotát és attribútumait.
CLinkCtrl::GetItemID	Lekéri egy hivatkozásvezérlő elem azonosítóját.
CLinkCtrl::GetItemState	Lekéri a hivatkozásvezérlő elem állapotát.
CLinkCtrl::GetItemUrl	Lekéri a hivatkozásvezérlő elem által képviselt URL-címet.
CLinkCtrl::HitTest	Meghatározza, hogy a felhasználó a megadott hivatkozásra kattintott-e.
CLinkCtrl::SetItem	Beállítja egy hivatkozásvezérlő elem állapotát és attribútumait.
CLinkCtrl::SetItemID	Beállítja egy hivatkozásvezérlő elem azonosítóját.
CLinkCtrl::SetItemState	Beállítja a hivatkozásvezérlő elem állapotát.
CLinkCtrl::SetItemUrl	Beállítja a hivatkozásvezérlő elem által képviselt URL-címet.

Megjegyzések

A "hivatkozásvezérlő" segítségével kényelmesen ágyazhat be hipertext-hivatkozásokat egy ablakba. A tényleges vezérlő egy ablak, amely megjeleníti a megjelölt szöveget, és elindítja a megfelelő alkalmazásokat, amikor a felhasználó egy beágyazott hivatkozásra kattint. Egy vezérlőelemen belül több hivatkozás is támogatott, és egy nulla alapú index is elérhető.

Ez a vezérlő (és ezért az CLinkCtrl osztály) csak a Windows XP és újabb rendszereken futó programok számára érhető el.

További információ: SysLink Control a Windows SDK-ban.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CLinkCtrl

Requirements

Fejléc: afxcmn.h

CLinkCtrl::CLinkCtrl

Egy CLinkCtrl objektumot hoz létre.

CLinkCtrl();

CLinkCtrl::Létrehozás

Létrehoz egy hivatkozásvezérlőt, és csatolja egy CLinkCtrl objektumhoz.

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

Paraméterek

lpszLinkMarkup
Mutasson egy nulla végződésű sztringre, amely a megjelenítendő megjelölt szöveget tartalmazza. További információkért tekintse meg a SysLink-vezérlők áttekintése című témakör "Korrektúra és hivatkozási hozzáférés" című szakaszát.

dwStyle
Megadja a hivatkozásvezérlő stílusát. A vezérlőstílusok bármilyen kombinációját alkalmazhatja. További információt a Windows SDKGyakori vezérlőstílusok című témakörben talál.

téglalap
Megadja a hivatkozásvezérlő méretét és pozícióját. Lehet CRect objektum vagy RECT-struktúra .

pParentWnd
A hivatkozásvezérlő szülőablakát adja meg. Nem lehet NULL.

nID
Megadja a hivatkozásvezérlő azonosítóját.

Visszaadott érték

IGAZ, ha az inicializálás sikeres volt; egyéb esetben HAMIS.

Megjegyzések

Egy objektumot CLinkCtrl két lépésben hozhat létre. Először hívja meg a konstruktort, majd hívja meg Create, amely létrehozza a hivatkozásvezérlőt, és csatolja az CLinkCtrl objektumhoz. Ha a vezérlővel bővített ablakstílusokat szeretne használni, hívja meg a CLinkCtrl::CreateEx parancsot ahelyett Create, hogy .

A metódus második formája Create elavult. Használja az lpszLinkMarkup paramétert meghatározó első űrlapot.

Example

Az első példakód két olyan változót határoz meg, amelyek neve m_Link1 és m_Link2neve két hivatkozásvezérlő elérésére szolgál.

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;

A következő példakód egy hivatkozásvezérlőt hoz létre egy másik hivatkozásvezérlő helye alapján. Az erőforrás-betöltő létrehozza az első hivatkozásvezérlőt az alkalmazás indításakor. Amikor az alkalmazás belép az OnInitDialog metódusba, a második hivatkozásvezérlőt az első hivatkozásvezérlő pozíciójához viszonyítva hozza létre. Ezután átméretezi a második hivatkozásvezérlőt, hogy elférjen a megjelenő szöveg.

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

Kiterjesztett stílusokkal rendelkező hivatkozásvezérlőt hoz létre, és egy CLinkCtrl objektumhoz csatolja.

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

Paraméterek

dwExStyle
A hivatkozásvezérlő kiterjesztett stílusát adja meg. A bővített Windows-stílusok listáját a CreateWindowExdwExStyle paraméterében találja a Windows SDK-ban.

dwStyle
Megadja a hivatkozásvezérlő stílusát. A vezérlőstílusok bármilyen kombinációját alkalmazhatja. További információ: Gyakori vezérlőstílusok a Windows SDK-ban.

téglalap
Megadja a hivatkozásvezérlő méretét és pozícióját. Lehet CRect objektum vagy RECT-struktúra .

pParentWnd
A hivatkozásvezérlő szülőablakát adja meg. Nem lehet NULL.

nID
Megadja a hivatkozásvezérlő azonosítóját.

Visszaadott érték

IGAZ, ha az inicializálás sikeres volt; egyéb esetben HAMIS.

Megjegyzések

A CreateExLétrehozás helyett kiterjesztett Windows-stílusállandókat alkalmazhat.

A metódus második formája CreateEx elavult. Használja az lpszLinkMarkup paramétert meghatározó első űrlapot.

CLinkCtrl::GetIdealHeight

Lekéri a kapcsolatvezérlő ideális magasságát.

int GetIdealHeight() const;

Visszaadott érték

A vezérlő ideális magassága képpontban.

Megjegyzések

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

CLinkCtrl::GetIdealSize

Kiszámítja a hivatkozás szövegének előnyben részesített magasságát az aktuális hivatkozásvezérlőhöz a hivatkozás megadott szélességétől függően.

int GetIdealSize(
    int cxMaxWidth,
    SIZE* pSize) const;

Paraméterek

cxMaxWidth
[in] A hivatkozás maximális szélessége képpontban.

Psize
[kifelé] Mutató egy Windows SIZE-struktúrára . Ha ez a módszer visszatér, a struktúra cy tagja tartalmazza a SIZEcxMaxWidth által megadott hivatkozásszöveg szélességének ideális hivatkozásszöveg-magasságát. A struktúra cx tagja tartalmazza a hivatkozás szövegének a ténylegesen szükséges szélességét.

Visszaadott érték

A hivatkozás szövegének előnyben részesített magassága képpontban. A visszatérési érték megegyezik a struktúra cy tagjának értékével SIZE .

Megjegyzések

A metódusra vonatkozó példa GetIdealSize a CLinkCtrl::Create című témakörben található.

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

CLinkCtrl::GetItem

Lekéri egy hivatkozásvezérlő elem állapotát és attribútumait.

BOOL GetItem(PLITEM pItem) const;

Paraméterek

pItem
Eleminformációk fogadásához mutató mutató egy LITEM-struktúrára .

Visszaadott érték

True (IGAZ) értéket ad vissza a sikerhez, hamis a sikertelenséghez.

Megjegyzések

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

CLinkCtrl::GetItemID

Lekéri egy hivatkozásvezérlő elem azonosítóját.

BOOL GetItemID(
    int iLink,
    CString& strID) const;

BOOL GetItemID(
    int iLink,
    LPWSTR szID,
    UINT cchID) const;

Paraméterek

iLink
Egy hivatkozásvezérlő elem indexe.

strID
A megadott elem azonosítóját tartalmazó CStringT-objektum .

szID
A megadott elem azonosítóját tartalmazó null értékű sztring.

cchID
Az szID-puffer karaktereinek mérete.

Visszaadott érték

True (IGAZ) értéket ad vissza a sikerhez, hamis a sikertelenséghez.

Megjegyzés:

Ez a függvény hamis értéket is ad vissza, ha az szID vagy strID puffere kisebb, mint MAX_LINKID_TEXT.

Megjegyzések

Lekéri egy adott hivatkozásvezérlő elem azonosítóját. További információt a Windows SDK-ban LM_GETITEM Win32-üzenetben talál.

CLinkCtrl::GetItemState

Lekéri a hivatkozásvezérlő elem állapotát.

BOOL GetItemState(
    int iLink,
    UINT* pnState,
    UINT stateMask = LIS_FOCUSED | LIS_ENABLED | LIS_VISITED) const;

Paraméterek

iLink
Egy hivatkozásvezérlő elem indexe.

pnState
A megadott állapotelem értéke.

stateMask
A lekérendő állapotelemet leíró jelzők kombinációja. Az értékek listáját a LITEM-struktúra tagleírásában state találja. Az engedélyezett elemek megegyeznek a megengedett stateelemekkel.

Visszaadott érték

True (IGAZ) értéket ad vissza a sikerhez, hamis a sikertelenséghez.

Megjegyzések

Lekéri egy adott hivatkozásvezérlő elem megadott állapotelemének értékét. További információt a Windows SDK-ban LM_GETITEM Win32-üzenetben talál.

CLinkCtrl::GetItemUrl

Lekéri a hivatkozásvezérlő elem által képviselt URL-címet.

BOOL GetItemUrl(
    int iLink,
    CString& strUrl) const;

BOOL GetItemUrl(
    int iLink,
    LPWSTR szUrl,
    UINT cchUrl) const;

Paraméterek

iLink
Egy hivatkozásvezérlő elem indexe.

strUrl
A megadott elem által képviselt URL-címet tartalmazó CStringT-objektum

szUrl
A megadott elem által képviselt URL-címet tartalmazó null értékű sztring

cchUrl
A szURL-puffer karaktereinek mérete.

Visszaadott érték

True (IGAZ) értéket ad vissza a sikerhez, hamis a sikertelenséghez.

Megjegyzés:

Ez a függvény hamis értéket is ad vissza, ha az szUrl vagy strUrl puffere kisebb, mint MAX_LINKID_TEXT.

Megjegyzések

Lekéri a megadott hivatkozásvezérlő elem által képviselt URL-címet. További információt a Windows SDK-ban LM_GETITEM Win32-üzenetben talál.

CLinkCtrl::HitTest

Meghatározza, hogy a felhasználó a megadott hivatkozásra kattintott-e.

BOOL HitTest(PLHITTESTINFO phti) const;

Paraméterek

fti
Mutasson egy LHITTESTINFO struktúrára, amely tartalmazza a felhasználó által rákattintott hivatkozással kapcsolatos információkat.

Visszaadott érték

True (IGAZ) értéket ad vissza a sikerhez, hamis a sikertelenséghez.

Megjegyzések

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

CLinkCtrl::SetItem

Beállítja egy hivatkozásvezérlő elem állapotát és attribútumait.

BOOL SetItem(PLITEM pItem);

Paraméterek

pItem
A beállítandó információkat tartalmazó LITEM-struktúra mutatója.

Visszaadott érték

True (IGAZ) értéket ad vissza a sikerhez, hamis a sikertelenséghez.

Megjegyzések

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

CLinkCtrl::SetItemID

Lekéri egy hivatkozásvezérlő elem azonosítóját.

BOOL SetItemID(
    int iLink,
    LPCWSTR szID);

Paraméterek

iLink
Egy hivatkozásvezérlő elem indexe.

szID
A megadott elem azonosítóját tartalmazó null értékű sztring.

Visszaadott érték

True (IGAZ) értéket ad vissza a sikerhez, hamis a sikertelenséghez.

Megjegyzések

Beállítja egy adott hivatkozásvezérlő elem azonosítóját. További információt a Windows SDK-ban LM_SETITEM Win32-üzenetben talál.

CLinkCtrl::SetItemState

Lekéri a hivatkozásvezérlő elem állapotát.

BOOL SetItemState(
    int iLink,
    UINT state,
    UINT stateMask = LIS_FOCUSED | LIS_ENABLED | LIS_VISITED);

Paraméterek

iLink
Egy hivatkozásvezérlő elem indexe.

pnState
A beállított állapotelem értéke.

stateMask
A beállított állapotelemet leíró jelzők kombinációja. Az értékek listáját a LITEM-struktúra tagleírásában state találja. Az engedélyezett elemek megegyeznek a megengedett stateelemekkel.

Visszaadott érték

True (IGAZ) értéket ad vissza a sikerhez, hamis a sikertelenséghez.

Megjegyzések

Egy adott hivatkozásvezérlő elem megadott állapotelemének értékét állítja be. További információt a Windows SDK-ban LM_SETITEM Win32-üzenetben talál.

CLinkCtrl::SetItemUrl

Beállítja a hivatkozásvezérlő elem által képviselt URL-címet.

BOOL SetItemUrl(
    int iLink,
    LPCWSTR szUrl);

Paraméterek

iLink
Egy hivatkozásvezérlő elem indexe.

szUrl
A megadott elem által képviselt URL-címet tartalmazó null értékű sztring

Visszaadott érték

True (IGAZ) értéket ad vissza a sikerhez, hamis a sikertelenséghez.

Megjegyzések

Beállítja a megadott hivatkozásvezérlő elem által képviselt URL-címet. További információt a Windows SDK-ban LM_SETITEM Win32-üzenetben talál.

Lásd még

hierarchiadiagram
CWnd osztály

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2026-02-23

Megosztás a következőn keresztül:

CLinkCtrl osztály

Szemantika

Tagok

Nyilvános konstruktorok

Nyilvános metódusok

Megjegyzések

Öröklési hierarchia

Requirements

CLinkCtrl::CLinkCtrl

CLinkCtrl::Létrehozás

Paraméterek

Visszaadott érték

Megjegyzések

Example

CLinkCtrl::CreateEx

Paraméterek

Visszaadott érték

Megjegyzések

CLinkCtrl::GetIdealHeight

Visszaadott érték

Megjegyzések

CLinkCtrl::GetIdealSize

Paraméterek

Visszaadott érték

Megjegyzések

CLinkCtrl::GetItem

Paraméterek

Visszaadott érték

Megjegyzések

CLinkCtrl::GetItemID

Paraméterek

Visszaadott érték

Megjegyzések

CLinkCtrl::GetItemState

Paraméterek

Visszaadott érték

Megjegyzések

CLinkCtrl::GetItemUrl

Paraméterek

Visszaadott érték

Megjegyzések

CLinkCtrl::HitTest

Paraméterek

Visszaadott érték

Megjegyzések

CLinkCtrl::SetItem

Paraméterek

Visszaadott érték

Megjegyzések

CLinkCtrl::SetItemID

Paraméterek

Visszaadott érték

Megjegyzések

CLinkCtrl::SetItemState

Paraméterek

Visszaadott érték

Megjegyzések

CLinkCtrl::SetItemUrl

Paraméterek

Visszaadott érték

Megjegyzések

Lásd még

Visszajelzés

További források