LinkBehavior Enumeration
Specifies the behaviors of a link in a LinkLabel.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
| Member name | Description | |
|---|---|---|
| AlwaysUnderline | The link always displays with underlined text. | |
| HoverUnderline | The link displays underlined text only when the mouse is hovered over the link text. | |
| NeverUnderline | ||
| SystemDefault | The behavior of this setting depends on the options set using the Internet Options dialog box in Control Panel or Internet Explorer. |
Use the members of this enumeration to set the value of the LinkBehavior property of the LinkLabel.
The following example demonstrates setting the LinkLabel::LinkBehavior property using the LinkBehavior enumeration. It alsodemonstrates setting the LinkLabel::LinkColor, Text and LinkVisited properties. To run this sample place it in a blank form and call the InitializeLinkLabel method from the form's constructor or Load method.
// Declare the LinkLabel object. internal: System::Windows::Forms::LinkLabel^ LinkLabel1; // Declare keywords array to identify links array<String^>^keywords; private: void InitializeLinkLabel() { this->LinkLabel1 = gcnew System::Windows::Forms::LinkLabel; this->LinkLabel1->Links->Clear(); // Set the location, name and size. this->LinkLabel1->Location = System::Drawing::Point( 10, 20 ); this->LinkLabel1->Name = "CompanyLinks"; this->LinkLabel1->Size = 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 += gcnew LinkLabelLinkClickedEventHandler( this, &Form1::LinkLabel1_LinkClicked ); // Add links to the LinkCollection using starting index and // length of keywords. array<String^>^temp0 = {"company","research"}; keywords = temp0; System::Collections::IEnumerator^ myEnum = keywords->GetEnumerator(); while ( myEnum->MoveNext() ) { String^ keyword = safe_cast<String^>(myEnum->Current); this->LinkLabel1->Links->Add( textString->IndexOf( keyword ), keyword->Length ); } // Add the label to the form. this->Controls->Add( this->LinkLabel1 ); } 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 ); }
Available since 1.1