Controle ListBox para Usuários do Visual Basic 6.0

Artigo
08/25/2010

The ListBox controle no Visual Basic 6.0 é substituído por tanto o ListBox controle ou o CheckedListBox controlar no Visual Basic 2008. Os nomes de algumas propriedades, métodos, eventos e constantes são diferentes e em alguns casos há diferenças de característica.

Diferenças Conceituais

ListBox Marcados

No Visual Basic 6.0, a Style propriedade de um ListBox controle determina se uma caixa de seleção é exibida ao lado de cada item de texto. Vários itens no ListBox podem ser selecionados ao marcar a caixa de seleção ao lado deles mesmo se a MultiSelect propriedade é conjunto para False. Não é possível determinar o estado selecionado de um item programaticamente; se você necessitar dessa funcionalidade, você tem que usar um ListView controle em vez disso.

In Visual Basic 2008, o novo CheckedListBox controle exibe caixas de seleção próxima a cada item; você não pode exibir caixas de seleção na ListBox controle. The CheckedListBox controle permite que você programaticamente determine o estado selecionado de cada item em um CheckedListBox.CheckedItemCollection coleção.

Propriedade Columns

No Visual Basic 6.0, a Columns propriedade aceitava um inteiro especificando o número de colunas para exibir.

In Visual Basic 2008, o MultiColumn propriedade tem um valor booliano e o ColumnWidth propriedade tem um inteiro especificando a largura em pixels. Se a largura do ListBox controle é alterado em time de execução, talvez também seja necessário conjunto o ColumnWidth propriedade para cada coluna.

Evento ItemCheck

No Visual Basic 6.0 ListBox controle, quando o ItemCheck evento foi gerado, o estado de seleção já era alterado.

In the Visual Basic 2008 CheckedListBox control, when the ItemCheck event is raised the check state has not yet changed.Você pode obter o valor pendente do ItemCheckEventArgs argumento passado ao evento.

Alterações de Código para o Controle ListBox

Os exemplos a seguir ilustram diferenças na codificação técnicas entre o Visual Basic 6.0 e Visual Basic 2008.

Alterações no Código para Adição e Remoção de Itens em um Controle ListBox

O código a seguir demonstra como adicionar e remover ListBox itens.

' Visual Basic 6.0
' Add an item at the end of the list.
List1.AddItem "Tokyo"
' Insert an item at the top of the list.
List1.AddItem "Copenhagen", 0
' Remove the first item.
List1.RemoveItem 0

'Visual Basic
' Add an item at the end of the list.
ListBox1.Items.Add("Tokyo")
' Insert an item at the top of the list.
ListBox1.Items.Insert(0, "Copenhagen")
' Remove the first item.
ListBox1.Items.RemoveAt(0)

Alterações no Código para Acessar Itens Específicos em um Controle ListBox

O código a seguir demonstra como retornar o valor de um ListBox item.

' Visual Basic 6.0
Private Function GetItemText(i As Integer) As String
   ' Return the text of the item using the index:
   GetItemText = ListBox1.List(i)
End Function

' Visual Basic
Private Function GetItemText(ByVal i As Integer) As String
   ' Return the text of the item using the index:
   GetItemText = CStr(ListBox1.Items(i))
End Function

Alterações no Código para Determinar Itens Selecionados em um Controle CheckedListBox

O código a seguir demonstra como determinar o estado selecionado de itens em um CheckedListBox controle.

' Visual Basic 6.0
' The Visual Basic 6.0 ListBox control didn't support this scenario,
' a ListView control had to be used instead.
Dim s As String
Dim i As Integer
' Loop through all items
For i = 1 To ListView1.ListItems.Count
   ' If an item is checked, add it to the string
   If ListView1.ListItems(i).Checked = True Then
      s = s & "Checked Item" & CStr(i) & " = " & _
ListView1.ListItems(i) & vbCrLf
   End If
Next
' Determine if any items are checked.
If s <> "" Then
    MsgBox s
End If

' Visual Basic
' Determine if there are any items checked.
If CheckedListBox1.CheckedItems.Count <> 0 Then
  ' If so, loop through all checked items and print results.
  Dim x As Integer
  Dim s As String = ""
  For x = 0 To CheckedListBox1.CheckedItems.Count - 1
      s = s & "Checked Item " & CStr(x + 1) & " = " & _
      CStr(CheckedListBox1.CheckedItems(x)) & ControlChars.CrLf
  Next x
  MessageBox.Show(s)
End If

Propriedade, Método, e Evento Equivalentes no Controle ListBox

As tabelas a seguir listam propriedades, métodos e eventos, juntamente com seus do Visual Basic 6.0Visual Basic 2008 equivalentes. Essas propriedades, métodos e eventos que têm o mesmo nome e comportamento não são listadas.Onde aplicável, constantes são recuadas abaixo a propriedade ou método.All Visual Basic 2008 enumerações mapeiam para o System.Windows.Forms namespace, salvo indicação em contrário.

Esta tabela fornece links para tópicos explicando diferenças de comportamento.Onde não há nenhum equivalente direto no Visual Basic 2008, são fornecidos links para tópicos que apresentam alternativas.

Propriedades

Visual Basic 6,0	Visual Basic 2008 Equivalente a
Appearance	Nova implementação.Para obter mais informações, consulte Propriedades Appearance e BorderStyle para usuários do Visual Basic 6.0.
BackColor	BackColor Observação: As cores são tratadas de maneira diferente em Visual Basic 2008.Para obter mais informações, consulte Comportamento da Cor para Usuários do Visual Basic 6.0.
Columns	MultiColumn e ColumnWidth
Container	Parent
DataChanged DataField DataFormat DataMember DataSource	Nova implementação.Para obter mais informações, consulte Acesso de dados para usuários do Visual Basic 6.0.
DragIcon DragMode	Nova implementação.Para obter mais informações, consulte Arrastar e soltar para usuários do Visual Basic 6.0.
FontFont FontBold FontItalic FontName FontSize FontStrikethrough FontUnderline	Font Observação: Fontes são tratadas de forma diferente no Visual Basic 2008.Para obter mais informações, consulte Objeto Font para usuários do Visual Basic 6.0.
ForeColor	ForeColor Observação: As cores são tratadas de maneira diferente em Visual Basic 2008.Para obter mais informações, consulte Comportamento da Cor para Usuários do Visual Basic 6.0.
Height	Height, Size Observação: Coordenadas são tratados de maneira diferente em Visual Basic 2008.Para obter mais informações, consulte Sistema de Coordenadas para usuários do Visual Basic 6.0.
HelpContextID	Nova implementação.Para obter mais informações, consulte Suporte de Ajuda para Usuários do Visual Basic 6.0.
HWnd	Handle
Index	Nova implementação.Para obter mais informações, consulte Controle de matrizes para usuários do Visual Basic 6.0.
IntegralHeight	IntegralHeight
ItemData	Nova implementação.Para obter mais informações, consulte Propriedade ItemData não pode ser atualizada.
Left	Left Observação: Coordenadas são tratados de maneira diferente em Visual Basic 2008.Para obter mais informações, consulte Sistema de Coordenadas para usuários do Visual Basic 6.0.
List	Items
ListCount	Count (List.Count)
ListIndex	SelectedIndex
MouseIcon	Nova implementação.Para obter mais informações, consulte Não é possível definir um MousePointer personalizado.
MousePointer	Cursor Para obter uma lista de constantes, consulte MousePointer para usuários do Visual Basic 6.0.
MultiSelect	SelectionMode
NewIndex	Nova implementação.Para obter mais informações, consulte Propriedade NewIndex não pode ser atualizada.
OLEDragMode OLEDropMode	Nova implementação.Para obter mais informações, consulte Arrastar e soltar para usuários do Visual Basic 6.0.
Parent	Método FindForm
SelCount	Count (SelectedItem.Count)
Selected	GetSelected, SetSelected (ListBox controle) GetItemChecked, SetItemChecked (CheckedListBox controle)
Style	Nova implementação de propriedade.0 – Padrão mapeia o CheckedListBox controle, 1 Caixa de seleção mapeia o CheckedListBox controle.
ToolTipText	ToolTip componente Para obter mais informações, consulte Suporte dica de ferramenta para usuários do Visual Basic 6.0.
Top	Top Observação: Coordenadas são tratados de maneira diferente em Visual Basic 2008.Para obter mais informações, consulte Sistema de Coordenadas para usuários do Visual Basic 6.0.
WhatsThisHelpID	Nova implementação.Para obter mais informações, consulte Suporte de Ajuda para Usuários do Visual Basic 6.0.
Width	Width, Size Observação: Coordenadas são tratados de maneira diferente em Visual Basic 2008.Para obter mais informações, consulte Sistema de Coordenadas para usuários do Visual Basic 6.0.

Métodos

Nome	Visual Basic 2008 Equivalente a
AddItem	Add AddRange Insert
Clear	Clear
Drag	Nova implementação.Para obter mais informações, consulte Arrastar e soltar para usuários do Visual Basic 6.0.
Move	SetBounds Observação: Coordenadas são tratados de maneira diferente em Visual Basic 2008.Para obter mais informações, consulte Sistema de Coordenadas para usuários do Visual Basic 6.0.
OLEDrag	Nova implementação.Para obter mais informações, consulte Arrastar e soltar para usuários do Visual Basic 6.0.
RemoveItem	Remove
SetFocus	Focus
ShowWhatsThis	Nova implementação.Para obter mais informações, consulte Suporte de Ajuda para Usuários do Visual Basic 6.0.
ZOrder	BringToFront ou SendToBack método

Eventos

Visual Basic 6,0	Visual Basic 2008 Equivalente a
DblClick	DoubleClick
DragDrop DragOver	Nova implementação.Para obter mais informações, consulte Arrastar e soltar para usuários do Visual Basic 6.0.
GotFocus	Enter
ItemCheck	ItemCheck (CheckedListBox somente)
LostFocus	Leave
OLECompleteDrag OLEDragDrop OLEDragOver OLEGiveFeedback OLESetData OLEStartDrag	Nova implementação.Para obter mais informações, consulte Arrastar e soltar para usuários do Visual Basic 6.0.
Scroll	Nova implementação.Para obter mais informações, consulte Propriedade TopIndex e evento Scroll para usuários do Visual Basic 6.0.
Validate	Validating

Observações de Atualização

Durante a atualização, se o Style propriedade de um Visual Basic 6.0 Listbox é definido como 1 Caixa de seleção, ela será atualizada para o CheckedListBox controlar; caso contrário, ela é atualizada para o ListBox controle.

Consulte também

Referência

Caixa de Listagem Controlar Overview (Windows Forms)

CheckedListBox Controlar Overview (Windows Forms)

Partilhar via