ListBox.MultiColumn Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se o ListBox dá suporte a várias colunas.
public:
property bool MultiColumn { bool get(); void set(bool value); };
public bool MultiColumn { get; set; }
member this.MultiColumn : bool with get, set
Public Property MultiColumn As Boolean
Valor da propriedade
true
se o ListBox der suporte a várias colunas; caso contrário, false
. O padrão é false
.
Exceções
Um ListBox de várias colunas não pode ter uma altura de tamanho variável.
Exemplos
O exemplo de código a seguir demonstra uma coluna simples de duas colunas ListBox.
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 ListBox listBox1;
public Form1()
{
InitializeComponent();
}
[STAThread]
static void Main()
{
Application.EnableVisualStyles();
Application.SetCompatibleTextRenderingDefault(false);
Application.Run(new Form1());
}
private void InitializeComponent()
{
this.listBox1 = new System.Windows.Forms.ListBox();
this.SuspendLayout();
//
// listBox1
//
this.listBox1.FormattingEnabled = true;
this.listBox1.HorizontalScrollbar = true;
this.listBox1.Items.AddRange(new object[] {
"Item 1, column 1",
"Item 2, column 1",
"Item 3, column 1",
"Item 4, column 1",
"Item 5, column 1",
"Item 1, column 2",
"Item 2, column 2",
"Item 3, column 2"});
this.listBox1.Location = new System.Drawing.Point(0, 0);
this.listBox1.MultiColumn = true;
this.listBox1.Name = "listBox1";
this.listBox1.ScrollAlwaysVisible = true;
this.listBox1.Size = new System.Drawing.Size(120, 95);
this.listBox1.TabIndex = 0;
this.listBox1.ColumnWidth = 85;
//
// Form1
//
this.ClientSize = new System.Drawing.Size(292, 273);
this.Controls.Add(this.listBox1);
this.Name = "Form1";
this.ResumeLayout(false);
}
}
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Data
Imports System.Drawing
Imports System.Text
Imports System.Windows.Forms
Public Class Form1
Inherits Form
Private listBox1 As ListBox
Public Sub New()
InitializeComponent()
End Sub
<STAThread()> _
Shared Sub Main()
Application.EnableVisualStyles()
Application.SetCompatibleTextRenderingDefault(False)
Application.Run(New Form1())
End Sub
Private Sub InitializeComponent()
Me.listBox1 = New System.Windows.Forms.ListBox()
Me.SuspendLayout()
'
' listBox1
'
Me.listBox1.FormattingEnabled = True
Me.listBox1.HorizontalScrollbar = True
Me.listBox1.Items.AddRange(New Object() {"Item 1, column 1", "Item 2, column 1", "Item 3, column 1", "Item 4, column 1", "Item 5, column 1", "Item 1, column 2", "Item 2, column 2", "Item 3, column 2"})
Me.listBox1.Location = New System.Drawing.Point(0, 0)
Me.listBox1.MultiColumn = True
Me.listBox1.Name = "listBox1"
Me.listBox1.ScrollAlwaysVisible = True
Me.listBox1.Size = New System.Drawing.Size(120, 95)
Me.listBox1.TabIndex = 0
Me.listBox1.ColumnWidth = 85
'
' Form1
'
Me.ClientSize = New System.Drawing.Size(292, 273)
Me.Controls.Add(listBox1)
Me.Name = "Form1"
Me.ResumeLayout(False)
End Sub
End Class
Comentários
Um multicolumn ListBox coloca itens em quantas colunas forem necessárias para tornar a rolagem vertical desnecessária. O usuário pode usar o teclado para navegar até colunas que não estão visíveis no momento. Defina a HorizontalScrollbar propriedade para true
exibir uma barra de rolagem horizontal que permite que o usuário role para colunas que não são mostradas atualmente na região visível do ListBox. O valor da ColumnWidth propriedade determina a largura de cada coluna.