ActiveLinkColor
Osztály: System.Windows.Forms.LinkLabel
Public Property ActiveLinkColor As Color
Az ActiveLinkColor property-ben beállíthatjuk, hogy milyen színű legyen a link, amikor azt a felhasználó aktiválja (rákattint egérrel és amíg nyomva tartja az egér gombját).
DisabledLinkColor
Osztály: System.Windows.Forms.LinkLabel
Public Property DisabledLinkColor As Color
Ha az Enabled property-n keresztül letiltjuk a kontrol működését, akkor kerül felhasználásra DisabledLinkColor property-ben megadott szín.
LinkArea
Osztály: System.Windows.Forms.LinkLabel
Public Property LinkArea As LinkArea
Meghatározhatjuk, hogy a Text property-ben megadott szövegnek mely területe viselkedjék linkként. Az ezen kívüli terület normális szöveggént jelenik meg.
LinkBehavior
Osztály: System.Windows.Forms.LinkLabel
Public Property LinkBehavior As LinkBehavior
A link működési tulajdonságát állíthatjuk be a LinkBehavior property-ben. Ennek lehetséges értékeit az alábbi táblázat foglalja össze:
| Érték |
Leírás |
| SystemDefault |
a rendszerben alapértelmezett érték |
| AlwaysUnderline |
minden esetben aláhúzott a link |
| HoverUnderline |
csak akkor aláhúzott, ha az egérrel épp a link felett tartózkodik a felhasználó |
| NeverUnderline |
soha nem lesz aláhúzott a link |
LinkColor
Osztály: System.Windows.Forms.LinkLabel
Public Property LinkColor As Color
A link alapértelmezett színét a LinkColor property határozza meg.
Links
Osztály: System.Windows.Forms.LinkLabel
Public ReadOnly Property Links As LinkLabel.LinkCollection
A Links property felhasználásával arra is lehetőségünk nyílik, hogy egy LinkLabel kontrol szövegén belül több, tetszőleges számú linket elhelyezzünk. Ehhez a Text property-be egy tetszőleges szöveg megadható és ehhez a Links property-n keresztül tetszőleges számú link rendelhető. A linkek hozzárendelése a Links property Add függvényével történhet, ahol az első paraméter a Text-ben megadott szöveg azon területének kezdő karakterét adja, ahonnan az adott linket kezdeni szeretnénk. A második paraméter e link hosszát adja. A harmadik paraméter az adott linkhez rendelt objektumot határozza meg, amely object típus révén nem csak egy szöveg lehet.
LinkLabel3.Links.Add(2, 1, "www.animare.hu")
Ezt az objektumot majd a LinkClicked eseménynél kapjuk vissza.
LinkVisited
Osztály: System.Windows.Forms.LinkLabel
Public Property LinkVisited As Boolean
A LinkVisited property-n keresztül jelölhetjük meg, hogy a LinkLabel kontrol szövegének megjelenítésekor a LinkColor, vagy a VisitedLinkColor property-ben megadott színt használja. Ha a LinkVisited property igaz értéket kap, akkor a VisitedLinkColor-ben megadott szín lesz használva, különben a LinkColor színe.
Megjegyzés
Alapértelmezett értéke a LinkVisited property-nek hamis, így a LinkColor-ban megadott szín lesz felhasználva.
Text
Osztály: System.Windows.Forms.LinkLabel
Public Property Text As String
Itt adhatjuk meg, hogy a kontrol felirata mi legyen.
VisitedLinkColor
Osztály: System.Windows.Forms.LinkLabel
Public Property VisitedLinkColor As Color
Itt határozhatjuk meg azt a színt, mellyel a Text-ben megadott szöveg jelenik meg akkor, ha a LinkVisited property értéke igaz.
PointInLink
Osztály: System.Windows.Forms.LinkLabel
Protected Function PointInLink (
ByVal x As Integer,
ByVal y As Integer
);
A PointInLink függvény felhasználásával egy x, y kliens koordináta alapján lekérdezhetjük, hogy a kontrol területén abban a pozícióban melyik link található.
Paraméterek
ByVal x As Integer
A kontrol területén belüli X koordináta.
ByVal y As Integer
A kontrol területén belüli Y koordináta.
Visszatérési érték
A függvény egy Link osztályt szolgáltat, ha a megadott koordinátán van link, ellenkező esetben Nothing értéket kapunk. A visszaadott Link osztály leírja a talált link minden szükséges jellemzőjét (Enabled, Length, LinkData, Start, Visited).
LinkClicked
Osztály: System.Windows.Forms.LinkLabel
Public Event LinkClicked As LinkLabelLinkClickedEventHandler
A LinkClicked esemény akkor jön létre, ha a felhasználó a kontrol területén belül található linkre kattint.
Megjegyzés
Az esemény paramétereként kapunk egy LinkLabelLinkClickedEventArgs osztályt. Ebben egy Link property-t találunk, melyen keresztül elérhetők annak a linknek a tulajdonságai, melyen a kattintás történt.
Link osztály
A PointInLink nevű függvénynél illetve a LinkClicked eseménynél is előkerül egy Link nevű osztály, mely az adott linkkel kapcsolatos információkat tárolja. Nézzük most meg részletesen ennek tulajdonságait.
Enabled
Osztály: System.Windows.Forms.LinkLabel.Link
Public Property Enabled As Boolean
Igaz, ha az adott link engedélyezett.
Length
Osztály: System.Windows.Forms.LinkLabel.Link
Public Property Length As Integer
A LinkLabel kontrol Text property-jéből kijelölt link hossza.
LinkData
Osztály: System.Windows.Forms.LinkLabel.Link
Public Property LinkData As Object
A megadott link objektum.
Start
Osztály: System.Windows.Forms.LinkLabel.Link
Public Property Start As Integer
A LinkLabel kontrol Text property-jéből kijelölt link kezdete.
Visited
Osztály: System.Windows.Forms.LinkLabel.Link
Public Property Visited As Boolean
Igaz, ha az adott link már meg lett jelölve a LinkLabel LinkVisited property-n keresztül.
A példaprogram
Amikor a felhasználó a linkre kattint, akkor jön létre a LinkClick esemény. Ezt felhasználva tetszőleges funkciót megvalósíthat programunk: például célszerű itt olvasottként megjelölni az adott linket.
Private Sub LinkLabel1_LinkClicked(ByVal sender As Object, ByVal e As System.Windows.Forms.LinkLabelLinkClickedEventArgs) Handles LinkLabel1.LinkClicked
Label1.Text = "Link Click"
LinkLabel1.LinkVisited = True
End Sub
Egy LinkLabel kontrol szövegén belül több, egymás utáni linkként működő részt is kijelölhetünk a Text property szövegén belül. Ekkor minden linkhez külön objektumot, szöveget rendelhetünk.
LinkLabel3.Links.Add(2, 1, "www.animare.hu")
LinkLabel3.Links.Add(6, 1, "www.SoftwareOnline.hu")
Amikor valamely linken kattintás történik, akkor az esemény paraméteréből megtudhatjuk, hogy melyik linkről van szó.
Private Sub LinkLabel3_LinkClicked(ByVal sender As Object, ByVal e As System.Windows.Forms.LinkLabelLinkClickedEventArgs) Handles LinkLabel3.LinkClicked
Label1.Text = e.Link.LinkData.ToString()
End Sub