ActiveLinkColor
Osztály: System.Windows.Forms.LinkLabel
public Color ActiveLinkColor {get; set;}
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 Color DisabledLinkColor {get; set;}
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 LinkArea LinkArea {get; set;}
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 LinkBehavior LinkBehavior {get; set;}
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 Color LinkColor {get; set;}
A link alapértelmezett színét a LinkColor property határozza meg.
Links
Osztály: System.Windows.Forms.LinkLabel
public LinkLabel.LinkCollection Links {get;}
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 bool LinkVisited {get; set;}
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 override string Text {get; set;}
Itt adhatjuk meg, hogy a kontrol felirata mi legyen.
VisitedLinkColor
Osztály: System.Windows.Forms.LinkLabel
public Color VisitedLinkColor {get; set;}
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 Link PointInLink(
int x,
int y
);
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
int x
A kontrol területén belüli X koordináta.
int y
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 null é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 LinkLabelLinkClickedEventHandler LinkClicked;
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 bool Enabled {get; set;}
Igaz, ha az adott link engedélyezett.
Length
Osztály: System.Windows.Forms.LinkLabel.Link
public int Length {get; set;}
A LinkLabel kontrol Text property-jéből kijelölt link hossza.
LinkData
Osztály: System.Windows.Forms.LinkLabel.Link
public object LinkData {get; set;}
A megadott link objektum.
Start
Osztály: System.Windows.Forms.LinkLabel.Link
public int Start {get; set;}
A LinkLabel kontrol Text property-jéből kijelölt link kezdete.
Visited
Osztály: System.Windows.Forms.LinkLabel.Link
public bool Visited {get; set;}
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 void linkLabel1_LinkClicked(object sender, System.Windows.Forms.LinkLabelLinkClickedEventArgs e)
{
label1.Text = "Link Click";
linkLabel1.LinkVisited = true;
}
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 is van szó.
private void linkLabel3_LinkClicked(object sender, System.Windows.Forms.LinkLabelLinkClickedEventArgs e)
{
label1.Text = e.Link.LinkData.ToString();
}