Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo LinkLabel.LinkCollection.Add (Int32, Int32, Object)

 

Data di pubblicazione: ottobre 2016

Aggiunge un collegamento alla raccolta con le informazioni da associare al collegamento.

Spazio dei nomi:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public LinkLabel.Link Add(
	int start,
	int length,
	object linkData
)

Parametri

start
Type: System.Int32

Il carattere iniziale all'interno del testo dell'etichetta in cui viene creato il collegamento.

length
Type: System.Int32

Il numero di caratteri dopo il carattere iniziale da includere nel testo del collegamento.

linkData
Type: System.Object

Oggetto contenente le informazioni da associare al collegamento.

Valore restituito

Type: System.Windows.Forms.LinkLabel.Link

Oggetto LinkLabel.Link che rappresenta il collegamento che è stato creato e aggiunto alla raccolta.

Oggetto LinkLabel controllo può visualizzare più collegamenti all'interno del testo del controllo. Il Add metodo consente di convertire il testo all'interno di LinkLabel controllo a un collegamento che può essere selezionato dall'utente per eseguire attività simili a un Button controllo. Questo metodo aggiunge il collegamento che viene creato per il LinkLabel.LinkCollection per il LinkLabel. Ad esempio, se si desidera impostare la parola "Cantami" nel testo dell'etichetta, "Cantami o Diva", si chiama questo metodo con il start impostata sul valore del parametro quattro (4) e length parametro cinque (5). La parola "veloce" passa quindi a un collegamento e il collegamento viene aggiunto alla raccolta. Questa versione del metodo Add consente di fornire informazioni aggiuntive che possono essere associate con il collegamento tramite il linkData parametro. Ad esempio, è possibile passare un String per il linkData parametro che contiene un URL da visualizzare quando si fa clic sul collegamento. È quindi possibile utilizzare queste informazioni nel gestore per il LinkClicked evento il LinkLabel controllo per visualizzare l'URL in Microsoft Internet Explorer.

System_CAPS_noteNota

Due collegamenti non possono condividere lo stesso testo. Se si crea un collegamento che utilizza il testo che è già utilizzato da un altro collegamento, viene generata un'eccezione.

L'esempio di codice seguente crea un LinkLabel controllo che visualizza un collegamento e il sito Web nel browser predefinito quando si fa clic sul collegamento definito nel testo del controllo. L'esempio definisce un metodo che inizializza il LinkLabel controllo nonché un metodo che gestirà il LinkClicked eventi del controllo. Il gestore dell'evento del LinkClicked evento utilizza il LinkData proprietà la LinkLabel.Link classe per determinare l'URL da visualizzare nel browser predefinito. Nell'esempio si presuppone che si trova all'interno di un Form (classe).

    // Create a new LinkLabel control.
private LinkLabel linkLabel1 = new LinkLabel();

public void InitializeMyLinkLabel()
{

	// Set the control to autosize based on the text content.
	linkLabel1.AutoSize = true;
	// Position and size the control on the form.
	linkLabel1.Location = new System.Drawing.Point(8,16);
	linkLabel1.Size = new System.Drawing.Size(135,13);
	// Set the text to display in the label.
	linkLabel1.Text = "Click here to get more info.";

	// Create a new link using the Add method of the LinkCollection class.
	linkLabel1.Links.Add(6,4,"www.microsoft.com");

	// Create an event handler for the LinkClicked event.
	linkLabel1.LinkClicked += new System.Windows.Forms.LinkLabelLinkClickedEventHandler(this.linkLabel1_LinkClicked);

	// Add the control to the form.
	this.Controls.Add(linkLabel1);
}

private void linkLabel1_LinkClicked(object sender, System.Windows.Forms.LinkLabelLinkClickedEventArgs e)
{
	// Determine which link was clicked within the LinkLabel.
	linkLabel1.Links[linkLabel1.Links.IndexOf(e.Link)].Visited = true;
	// Display the appropriate link based on the value of the LinkData property of the Link object.
	System.Diagnostics.Process.Start(e.Link.LinkData.ToString());
}

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: