Controle ListView para usuários do Visual Basic 6.0

The ListView controle no Visual Basic 6.0 é substituído pelo ListView 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

Propriedade DropHighlight

No Visual Basic 6.0, quando o cursor move sobre um ListItem objeto em um ListView controle, o DropHighlight propriedade é usada para realçar o ListItem objeto com a cor de realce do sistema. Esta propriedade é normalmente usada em operações arrastar-e-soltar.

In Visual Basic 2008, o DropHighlight propriedade não existe mais; você pode obter o mesmo efeito usando owner-drawn (também conhecido sistema autônomo desenho personalizado) no realce na MouseEnter e MouseLeave eventos. Para obter mais informações, consulte Controles com Built-In Proprietário-Desenho Support.

Propriedade FlatScrollBar

No Visual Basic 6.0, a FlatScrollBar propriedade determina se a BAR de rolar em um ListView controle tem uma aparência plana (bidimensional).

In Visual Basic 2008, o FlatScrollBar propriedade não existe mais; barras de rolar na ListView controle sempre têm uma aparência tridimensional.

Propriedade HideColumnHeaders

No Visual Basic 6.0, a HideColumnHeaders propriedade determina se ColumnHeader objetos em um ListView controle são ocultas em Report modo de exibição.

In Visual Basic 2008, o HideColumnHeaders propriedade não existe mais; você pode controlar a visibilidade dos cabeçalhos de coluna, definindo o HeaderStyle propriedade.

Evento ItemClick

O Visual Basic 6.0 ListView controle tiver tanto um Click e um ItemClick evento. The ItemClick evento tem um ListItem objeto sistema autônomo um argumento.

In Visual Basic 2008, não é mais um ItemClick evento. Em vez disso, você pode usar o Click evento e o EventSender.FocusedItem argumento para determinar qual ListViewItem foi clicado.

Classificação

No Visual Basic 6.0, classificação de um ListView controle é realizado usando uma combinação da Sorted, SortKey, e SortOrder Propriedades. Sorted Determina se a classificação está ativada, SortOrder Determina se a classificação é crescente ou decrescente, e SortKey Especifica um sub-item a ser usado para classificação no lugar do texto.

In Visual Basic 2008, a classificar é realizada usando o Sorting propriedade, que ativa a classificar e define a ordem de classificar em uma única etapa. The SortKey propriedade é substituída pelo ListViewItemSorter propriedade.

Propriedade View

No Visual Basic 6.0, a View propriedade determina sistema autônomo sistema autônomo itens em um ListView controle são exibidos — sistema autônomo ícones grandes com texto ()lvwIcon), sistema autônomo ícones pequenos com texto ()lvwSmallIcon), sistema autônomo uma lista (lvwList), ou sistema autônomo uma lista com subitens ()lvwReport).

In Visual Basic 2008, o View propriedade ainda existe, mas as enumerações são diferentes. lvwIcon é substituído por LargeIcon, lvwSmallIcon Por SmallIcon, lvwList Por List, e lvwReport Por Details. Além disso, há um novo modo de exibição, Tile, onde cada item aparece sistema autônomo um ícone em tamanho normal com sistema autônomo informações de rótulo e sub-item de item para a direita dele.

Alterações de código para o controle ListView

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

Alterações de código para determinar o item selecionado em um controle ListView

O exemplo de código a seguir atribui o selecionadoListView item a uma variável.

' Visual Basic 6.0
Dim theItem As ListItem
theItem = ListView1.SelectedItem

' Visual Basic
Dim theItem As ListViewItem
If ListView1.SelectedItems.Count > 0 Then
    theItem = ListView1.SelectedItems(0)
Else
    theItem = Nothing
End If

Alterações de código para determinar todos os itens selecionados em um controle ListView

O exemplo de código a seguir exibe uma caixa de mensagem com o texto de cada item selecionado em um ListView controle.

' Visual Basic 6.0
For i = 1 To ListView1.ListItems.Count
    If ListView1.ListItems(i).Selected = True Then
        MsgBox(ListView1.SelectedItem
    End If
Next i

' Visual Basic
For Each selectedItem As ListViewItem In ListView1.SelectedItems
    MsgBox(selectedItem.Text)
Next

Equivalências de propriedades, métodos e eventos do controle ListView

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.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.
Arrange	Alignment
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.
ColumnHeaderIcons	ImageIndex, ImageKey
ColumnsHeaders	Columns
Container	Parent
DragIcon DragMode	Nova implementação.Para obter mais informações, consulte Arrastar e soltar para usuários do Visual Basic 6.0.
DropHighlight	Nova implementação.
FlatScrollBar	Nova implementação.
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.
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
Icons	LargeImageList
Index	Nova implementação.Para obter mais informações, consulte Controle de matrizes para usuários do Visual Basic 6.0.
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.
ListItems	Items
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.
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
Picture	BackgroundImage
PictureAlignment	BackgroundImageTiled
SelectedItem	SelectedItems
SmallIcons	SmallImageList
Sorted SortOrder	Sorting
SortKey	ListViewItemSorter
TextBackground	BackColor
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
Drag	Nova implementação.Para obter mais informações, consulte Arrastar e soltar para usuários do Visual Basic 6.0.
FindItem	FindItemWithText
GetFirstVisible	TopItem
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.
Refresh	RedrawItems
SetFocus	Focus
ShowWhatsThis	Nova implementação.Para obter mais informações, consulte Suporte de Ajuda para Usuários do Visual Basic 6.0.
StartLabelEdit	BeginEdit
ZOrder	BringToFront ou SendToBack método

Eventos

Observações de Atualização

Quando um projeto Visual Basic 6.0 é atualizado para Visual Basic 2008, qualquer ListView controles são atualizados para Windows Forms ListView controles. Onde propriedades, métodos, e eventos não tem equivalência ou têm comportamentos diferentes, notas de atualização ou avisos são adicionados no seu código.

Consulte também

Outros recursos

Controlar de Exibição em Lista (Windows Forms)