ListView.HideSelection Proprietà

Definizione

Ottiene o imposta un valore che indica se l'elemento selezionato nel controllo rimane evidenziato quando il controllo perde lo stato attivo.

public bool HideSelection { get; set; }

Valore della proprietà

true se l'elemento selezionato non appare evidenziato quando il controllo perde lo stato attivo; false, se l'elemento selezionato rimane evidenziato quando il controllo perde lo stato attivo.

Nella tabella seguente viene illustrato il valore predefinito di questa proprietà per versioni diverse di .NET.

Versione di .NET Valore predefinito
.NET Core 3.0 e versioni successivefalse
NET Framework 4.8 false, a meno che non sia stato scelto di escludere nuove funzionalità di accessibilità
.NET Framework 1.0 - 4.7true

Esempio

Nell'esempio di codice seguente viene illustrato un oggetto ListView che consente l'selezione di più elementi. L'esempio illustra l'impostazione delle HideSelection proprietà e HeaderStyle . Illustra anche le ColumnHeader.Textproprietà , ColumnHeader.TextAligne ColumnHeader.Width . Per eseguire questo esempio, incollare il codice seguente in un modulo contenente un ListView oggetto denominato e un TextBox oggetto denominato TextBox1ListView1 . Chiamare il InitializeListView metodo dal costruttore o Load dal gestore eventi del modulo.

  // This method adds two columns to the ListView, setting the Text 
  // and TextAlign, and Width properties of each ColumnHeader.  The 
  // HeaderStyle property is set to NonClickable since the ColumnClick 
  // event is not handled.  Finally the method adds ListViewItems and 
  // SubItems to each column.
  private void InitializeListView()
  {
      this.ListView1 = new System.Windows.Forms.ListView();
      this.ListView1.BackColor = System.Drawing.SystemColors.Control;
      this.ListView1.Dock = System.Windows.Forms.DockStyle.Top;
      this.ListView1.Location = new System.Drawing.Point(0, 0);
      this.ListView1.Name = "ListView1";
      this.ListView1.Size = new System.Drawing.Size(292, 130);
      this.ListView1.TabIndex = 0;
      this.ListView1.View = System.Windows.Forms.View.Details;
      this.ListView1.MultiSelect = true;
      this.ListView1.HideSelection = false;
      this.ListView1.HeaderStyle = ColumnHeaderStyle.Nonclickable;
      
      ColumnHeader columnHeader1 = new ColumnHeader();
      columnHeader1.Text = "Breakfast Item";
      columnHeader1.TextAlign = HorizontalAlignment.Left;
      columnHeader1.Width = 146;

      ColumnHeader columnHeader2 = new ColumnHeader();
      columnHeader2.Text = "Price Each";
      columnHeader2.TextAlign = HorizontalAlignment.Center;
      columnHeader2.Width = 142;

      this.ListView1.Columns.Add(columnHeader1);
      this.ListView1.Columns.Add(columnHeader2);

      string[] foodList = new string[]{"Juice", "Coffee", 
          "Cereal & Milk", "Fruit Plate", "Toast & Jelly", 
          "Bagel & Cream Cheese"};
      string[] foodPrice = new string[]{"1.09", "1.09", "2.19", 
          "2.49", "1.49", "1.49"};
      
      for(int count=0; count < foodList.Length; count++)
      {
          ListViewItem listItem = new ListViewItem(foodList[count]);
          listItem.SubItems.Add(foodPrice[count]);
          ListView1.Items.Add(listItem);
      }
      this.Controls.Add(ListView1);
  }

Commenti

Quando questa proprietà è impostata su false, gli elementi selezionati nel ListView controllo rimangono evidenziati in un colore diverso rispetto al colore di selezione corrente specificato dal sistema operativo quando il ListView controllo perde lo stato attivo. È possibile usare questa proprietà per mantenere gli elementi selezionati dall'utente quando l'utente fa clic su un controllo diverso nel modulo o passa a una finestra diversa.

Nota

Se si è interessati all'accessibilità delle applicazioni, è consigliabile impostare la HideSelection proprietà su false.

Si applica a

Prodotto Versioni
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9