LinkBehavior, énumération
Mise à jour : novembre 2007
Spécifie les comportements d'un lien dans un LinkLabel.
Assembly : System.Windows.Forms (dans System.Windows.Forms.dll)
| Nom de membre | Description | |
|---|---|---|
| SystemDefault | Le comportement de ce paramètre dépend des options définies dans la boîte de dialogue Options Internet du Panneau de configuration ou d'Internet Explorer. | |
| AlwaysUnderline | Le lien s'affiche toujours avec le texte souligné. | |
| HoverUnderline | Le lien affiche un texte souligné uniquement lorsque la souris pointe sur le texte du lien. | |
| NeverUnderline | Le texte du lien n'est jamais souligné. Toutefois, il est toujours possible de le distinguer du reste du texte en utilisant la propriété LinkColor du contrôle LinkLabel. |
Utilisez les membres de cette énumération pour définir la valeur de la propriété LinkBehavior de LinkLabel.
L'exemple de code suivant illustre la définition de la propriété LinkLabel.LinkBehavior à l'aide de l'énumération LinkBehavior. Il illustre aussi la définition des propriétés LinkLabel.LinkColor, Text et LinkVisited. Pour exécuter cet exemple, placez le code dans un formulaire vierge et appelez la méthode InitializeLinkLabel dans le constructeur du formulaire ou la méthode Load.
// Declare the LinkLabel object. internal System.Windows.Forms.LinkLabel LinkLabel1; // Declare keywords array to identify links string[] keywords; private void InitializeLinkLabel() { this.LinkLabel1 = new System.Windows.Forms.LinkLabel(); this.LinkLabel1.Links.Clear(); // Set the location, name and size. this.LinkLabel1.Location = new System.Drawing.Point(10, 20); this.LinkLabel1.Name = "CompanyLinks"; this.LinkLabel1.Size = new System.Drawing.Size(104, 150); // Set the LinkBehavior property to show underline when mouse // hovers over the links. this.LinkLabel1.LinkBehavior = System.Windows.Forms.LinkBehavior.HoverUnderline; string textString = "For more information see our" + " company website or the research page at Contoso Ltd. "; // Set the text property. this.LinkLabel1.Text = textString; // Set the color of the links to black, unless the mouse // is hovering over a link. this.LinkLabel1.LinkColor = System.Drawing.Color.Black; this.LinkLabel1.ActiveLinkColor = System.Drawing.Color.Blue; // Associate the event-handling method with the LinkClicked // event. this.LinkLabel1.LinkClicked += new LinkLabelLinkClickedEventHandler(LinkLabel1_LinkClicked); // Add links to the LinkCollection using starting index and // length of keywords. keywords = new string[]{"company", "research"}; foreach ( string keyword in keywords ) { this.LinkLabel1.Links.Add(textString.IndexOf(keyword), keyword.Length); } // Add the label to the form. this.Controls.Add(this.LinkLabel1); } private void LinkLabel1_LinkClicked(object sender, LinkLabelLinkClickedEventArgs e) { string url = ""; // Determine which link was clicked and set the appropriate url. switch(LinkLabel1.Links.IndexOf(e.Link)) { case 0: url = "www.microsoft.com"; break; case 1: url = "www.contoso.com/research"; break; } // Set the visited property to True. This will change // the color of the link. e.Link.Visited = true; // Open Internet Explorer to the correct url. System.Diagnostics.Process.Start("IExplore.exe", url); }
// Declare the LinkLabel object.
private System.Windows.Forms.LinkLabel linkLabel1;
// Declare keywords array to identify links
private String keywords[];
private void InitializeLinkLabel()
{
this.linkLabel1 = new System.Windows.Forms.LinkLabel();
// Set the location, name and size.
this.linkLabel1.set_Location(new System.Drawing.Point(10, 20));
this.linkLabel1.set_Name("CompanyLinks");
this.linkLabel1.set_Size(new System.Drawing.Size(104, 150));
// Set the LinkBehavior property to show underline when mouse
// hovers over the links.
this.linkLabel1.set_LinkBehavior(
System.Windows.Forms.LinkBehavior.HoverUnderline);
String textString = "For more information see our"
+ " company website or the research page at Contoso Ltd. ";
// Set the text property.
this.linkLabel1.set_Text(textString);
// Set the color of the links to black, unless the mouse
// is hovering over a link.
this.linkLabel1.set_LinkColor(System.Drawing.Color.get_Black());
this.linkLabel1.set_ActiveLinkColor(System.Drawing.Color.get_Blue());
// Associate the event-handling method with the LinkClicked
// event.
this.linkLabel1.add_LinkClicked(new LinkLabelLinkClickedEventHandler(
linkLabel1_LinkClicked));
// Add links to the LinkCollection using starting index and
// length of keywords.
keywords = new String[] { "company", "research" };
for (int iCtr = 0; iCtr < keywords.length; iCtr++) {
String keyword = keywords[iCtr];
this.linkLabel1.get_Links().Add(textString.IndexOf(keyword),
keyword.get_Length());
}
// Add the label to the form.
this.get_Controls().Add(this.linkLabel1);
} //InitializeLinkLabel
private void linkLabel1_LinkClicked(Object sender,
LinkLabelLinkClickedEventArgs e)
{
String url = "";
// Determine which link was clicked and set the appropriate url.
switch (linkLabel1.get_Links().IndexOf(e.get_Link())) {
case 0:
url = "www.microsoft.com";
break;
case 1:
url = "www.contoso.com/research";
break;
}
// Set the visited property to True. This will change
// the color of the link.
e.get_Link().set_Visited(true);
// Open Internet Explorer to the correct url.
System.Diagnostics.Process.Start("IExplore.exe", url);
} //linkLabel1_LinkClicked
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.