Questa documentazione è stata archiviata e non viene gestita.

Classe ToolStripLabel

Aggiornamento: novembre 2007

Rappresenta un oggetto ToolStripItem non selezionabile che esegue il rendering di testo e immagini ed è in grado di visualizzare collegamenti ipertestuali.

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

[ToolStripItemDesignerAvailabilityAttribute(ToolStripItemDesignerAvailability.ToolStrip)]
public class ToolStripLabel : ToolStripItem
/** @attribute ToolStripItemDesignerAvailabilityAttribute(ToolStripItemDesignerAvailability.ToolStrip) */
public class ToolStripLabel extends ToolStripItem
public class ToolStripLabel extends ToolStripItem

Utilizzare la classe ToolStripLabel per creare un'etichetta che esegue il rendering di testo e immagini in grado di implementare le proprietà ToolStripItem.TextAlign e ToolStripItem.ImageAlign. Anche in ToolStripLabel sono disponibili molte proprietà che consentono di visualizzare uno o più collegamenti ipertestuali e altre proprietà che modificano l'aspetto e il comportamento di tali collegamenti.

La classe ToolStripLabel è simile a una classe ToolStripButton che non ottiene lo stato attivo per impostazione predefinita e di cui non viene eseguito il rendering quando inserita o evidenziata.

La classe ToolStripLabel come elemento contenuto supporta i tasti di scelta.

Utilizzare le proprietà LinkColor, LinkVisited e LinkBehavior in una classe ToolStripLabel per supportare il controllo dei collegamenti in una classe ToolStrip.

Nell'esempio di codice riportato di seguito viene illustrato come inizializzare un oggetto ToolStripLabel che deve contenere un collegamento impostando le proprietà IsLink, LinkColor, ActiveLinkColor, VisitedLinkColor, LinkVisited e LinkBehavior.

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;


public class Form1 : Form
{
    private ToolStripLabel toolStripLabel1;
    private ToolStrip toolStrip1;

    public Form1()
    {
        InitializeComponent();
    }
    [STAThread]
    static void Main()
    {
        Application.EnableVisualStyles();
        Application.SetCompatibleTextRenderingDefault(false);
        Application.Run(new Form1());
    }

    private void InitializeComponent()
    {
        this.toolStrip1 = new System.Windows.Forms.ToolStrip();
        this.toolStripLabel1 = new System.Windows.Forms.ToolStripLabel();
        this.toolStrip1.SuspendLayout();
        this.SuspendLayout();
        // 
        // toolStrip1
        // 
        this.toolStrip1.Items.AddRange(new System.Windows.Forms.ToolStripItem[] {
            this.toolStripLabel1});
        this.toolStrip1.Location = new System.Drawing.Point(0, 0);
        this.toolStrip1.Name = "toolStrip1";
        this.toolStrip1.Size = new System.Drawing.Size(292, 25);
        this.toolStrip1.TabIndex = 0;
        this.toolStrip1.Text = "toolStrip1";
        // 
        // toolStripLabel1
        // 
        this.toolStripLabel1.IsLink = true;
        this.toolStripLabel1.LinkBehavior = System.Windows.Forms.LinkBehavior.AlwaysUnderline;
        this.toolStripLabel1.Name = "toolStripLabel1";
        this.toolStripLabel1.Size = new System.Drawing.Size(71, 22);
        this.toolStripLabel1.Tag = "http://search.microsoft.com/search/search.aspx?";
        this.toolStripLabel1.Text = "Search MSDN";
        this.toolStripLabel1.Click += new System.EventHandler(this.toolStripLabel1_Click);
        // 
        // Form1
        // 
        this.ClientSize = new System.Drawing.Size(292, 273);
        this.Controls.Add(this.toolStrip1);
        this.Name = "Form1";
        this.toolStrip1.ResumeLayout(false);
        this.toolStrip1.PerformLayout();
        this.ResumeLayout(false);
        this.PerformLayout();

    }

    private void toolStripLabel1_Click(object sender, EventArgs e)
    {
        ToolStripLabel toolStripLabel1 = (ToolStripLabel)sender;

        // Start Internet Explorer and navigate to the URL in the
        // tag property.
        System.Diagnostics.Process.Start("IEXPLORE.EXE", toolStripLabel1.Tag.ToString());

        // Set the LinkVisited property to true to change the color.
        toolStripLabel1.LinkVisited = true;
    }
}


Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0, 2.0
Mostra: