Controle DataGrid para usuários do Visual Basic 6.0

Artigo
08/25/2010

The DataGrid controle no Visual Basic 6.0 é substituído pelo Windows Forms DataGridView 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

Ligação de Dados

The Visual Basic 2008 DataGridView control does not need data-specific methods or events because all actions are performed through the data source.Devido a essa separação da apresentação e funcionalidade dados, a fonte de dados pode ser alterada com ou sem entrada de interface do usuário.Além disso, vários controles acoplados a mesma fonte de dados sempre ficarão em sincronia.

Navegação

Propriedades para visão e navegação no DataGrid controle (sistema autônomo TabAction, EnterAction, AllowArrows, WrapCellPointer, e Scrollable) não são mais necessários. Por exemplo, a grade funciona sistema autônomo meio de Scrollable propriedade é conjunto para True: Se existir mais dados que podem ser exibidos, uma BAR de rolar aparecerá automaticamente.Navegação no estilo Excel através da grade é o padrão, permitindo ao usuário mover para frente com a tecla TAB e para trás com a combinação de teclas SHIFT+TAB.Para obter mais informações, consulte Teclado e mouse Manipulação in the Windows Forms Exibição em Grade de Dados Controlar padrão.

Propriedade Caption

No Visual Basic 6.0, a Caption propriedade é usada para exibir um BAR de título acima da grade; se a Caption propriedade for deixada vazia, nenhuma BAR de título é exibida.

The Visual Basic 2008 DataGridView control does not support a title bar.No entanto, você pode obter o mesmo efeito usando um Label controle.

Formato dos Dados

No Visual Basic 6.0, formatação de dados no DataGrid controle é tratado usando a DataFormat propriedade e um StdDataFormat objeto. Formatação é aplicada em uma base coluna por coluna.

In the Visual Basic 2008 DataGridView control, formatting is accomplished using the Format property of a DataGridViewCellStyle object.A formatação pode ser aplicada a células individuais, colunas ou linhas.Para obter mais informações, consulte Dados Formatação in the Windows Forms Exibição em Grade de Dados Controlar.

Propriedade hWndEditor

No Visual Basic 6.0, a hWndEditor propriedade é usada para passar a janela designada para uma DataGrid controle de edição de janela para uma telefonar à API do Windows.

The Visual Basic 2008 DataGridView control does not have a separate window handle when in edit mode; instead, use the Handle property of the DataGridView control or any embedded edit controls.

Propriedade MarqueeStyle

No Visual Basic 6.0, a MarqueeStyle propriedade controla a aparência de uma célula selecionada ou linha, mudando o estilo da borda, invertendo as cores de primeiro plano e plano de fundo ou executando uma janela de edição.

There is no direct equivalent for the Visual Basic 2008 DataGridView control.No entanto, você pode obter o mesmo efeito através de uma combinação do SelectionMode, CellBorderStyle, e Format Propriedades. Para obter mais informações, consulte Modes de seleção in the Windows Forms Exibição em Grade de Dados Controlar.

Propriedades SelLength, SelStart e SelText

No Visual Basic 6.0 DataGrid controle, quando uma célula entra em modo de edição, o SelLength, SelStart, e SelText propriedades podem ser usadas para conjunto a posição inicial do acento circunflexo ou para realçar a porção do texto na célula.

In the Visual Basic 2008 DataGridView control, these properties no longer exist.As células a DataGridView controle se baseiam no TextBox controlar; adicionando código para o EditingControlShowing evento manipulador, você pode acessar o SelectionLength, SelectionStart, e SelectedText Propriedades do controle base.

Split Views

O Visual Basic 6.0 DataGrid controle suporta um modo divisão, permitindo que o usuário exibir a mesmos dados lado a lado. The Split objeto e o Split, Splits, e TabAcrossSplits propriedades controlam a capacidade de exibir uma vista dividida.

In the Visual Basic 2008 DataGridView control, these properties no longer exist.No entanto, você pode obter o mesmo efeito usando um ou mais SplitContainer controles e múltiplo DataGridView controles.Para duplicar a funcionalidade do TabAcrossSplits propriedade, você pode usar o StandardTab propriedade das DataGridView controle.

Alterações do código para o controle DataGrid

O código a seguir demonstra as diferenças entre Visual Basic 6.0 e Visual Basic 2008 mostrando como cada versão, para realçar o texto em uma célula quando um usuário seleciona a célula em uma DataGridView controle.

' Visual Basic 6.0
Private Sub DataGrid1_Click()
    DataGrid1.SelStart = 1
    DataGrid1.SelLength = DataGrid1.Text
    MsgBox("The selected text is " & DataGrid1.SelText)
End Sub

' Visual Basic
Private Sub DataGridView1_EditingControlShowing( _
ByVal sender As Object, ByVal e As System.Windows.Forms. _
DataGridViewEditingControlShowingEventArgs) _
Handles DataGridView1.EditingControlShowing
    CType(e.Control, TextBox).SelectionStart = 0
    CType(e.Control, TextBox).SelectionLength = Len(CType(e.Control, _
      TextBox).Text)
    MsgBox("The selected text is " & CType(e.Control, _
      TextBox).SelectedText)
End Sub

Propriedade, Método e Evento Equivalente do controle DataGrid

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	Equivalente Visual Basic 2005
AddNewMode	Nova implementação.Operações de dados são manipuladas na fonte de dados.Para obter mais informações, consulte Exibindo dados no Controlarar Exibição em Grade de Dados do Windows Forms.
Align	Dock e Anchor
AllowAddNew	AllowNew (BindingSource)
AllowArrows	Não mais uma propriedade ajustável; navegação de seta sempre permitida.Para obter mais informações, consulte Teclado e mouse Manipulação in the Windows Forms Exibição em Grade de Dados Controlar padrão.
AllowDelete	AllowRemove (BindingSource)
AllowRowSizing	AllowUserToResizeRows
AllowUpdate	AllowEdit (BindingSource)
Appearance	Nova implementação.Para obter mais informações, consulte Propriedades Appearance e BorderStyle para usuários do Visual Basic 6.0.
ApproxCount	Nova implementação.Operações de dados são manipuladas na fonte de dados.Para obter mais informações, consulte Exibindo dados no Controlarar Exibição em Grade de Dados do Windows Forms.
BackColor	BackgroundColor 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.
Bookmark	Nova implementação.Agora você pode acessar diretamente qualquer item.
Caption	Nova implementação.Use um Label controle para simular uma BAR de título.
Col	SelectedColumns
ColumnHeaders	ColumnHeadersVisible
Container	Parent; herdada do Control.
CurrentCellModified	IsCurrentCellDirty, IsCurrentCellInEditMode
CurrentCellVisible	CurrentCell Observação: Se a CurrentCell propriedade estiver definida para uma célula que não estiver visível, a grade rola para mostrar a célula (semelhante a configuração CurrentCellVisible = True).
DataChanged	IsCurrentCellDirty, IsCurrentRowDirty
DataFormats	DataGridViewCellStyle.objeto. Observação: Formatação pode ser definida para uma célula individual, coluna ou linha.
DefColWidth	WidthDataGridViewColumn objeto.
DragIcon DragMode	Nova implementação.Para obter mais informações, consulte Arrastar e soltar para usuários do Visual Basic 6.0.
EditActive	IsCurrentCellInEditMode
FirstRow	FirstDisplayedScrollingRowIndex
Font 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 Fonte de tratamento 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 Color Behavior for Visual Basic 6.0 Users.
HeadFont	DataGridViewCellStyle objeto. 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.
HeadLines	Há equivalente direto.Use o WrapMode propriedade das DataGridViewCellStyle objeto em combinação com ColumnHeadersHeight.
Height	Height, herdadas de Control classe. 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
hWndEditor	Nova implementação.Usar Handle
Index	Nova implementação.Para obter mais informações, consulte Controle de matrizes para usuários do Visual Basic 6.0.
Left	Left, herdadas de Control classe. 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.
LeftCol	FirstDisplayedScrollingColumnIndex
MarqueeStyle	Há equivalente direto.Use o SelectionMode, CellBorderStyle, e Format Propriedades.
RecordSelectors	RowHeadersVisible
Row	SelectedRows
RowDividerStyle	GridColor, CellBorderStyle, RowHeadersBorderStyle, ColumnHeadersBorderStyle Propriedades.
RowHeight	Height
SelBookmarks	Nova implementação.Agora você pode acessar diretamente qualquer item.
SelEndCol SelStartCol	SelectedCells, SelectedColumns
SelLength	Há equivalente direto.Use o SelectionLength propriedade no EditingControlShowing manipulador de eventos.
SelStart	Há equivalente direto.Use o SelectionStart propriedade no EditingControlShowing manipulador de eventos.
SelText	Há equivalente direto.Use o SelectedText propriedade no EditingControlShowing manipulador de eventos.
Split Splits TabAcrossSplits	Nova implementação.Split views não são suportados; use um SplitContainer controle.
TabAction	StandardTab
Tag	Nova implementação.
Text	CurrentCell.Value Observação: O Value propriedade para retornar uma Object; use CStr ou ToString para convertê-lo para um String.
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.
VisibleCols	DisplayedColumnCount método. Observação: No Visual Basic 6.0, colunas parcialmente visíveis são sempre incluídas na contagem; o DisplayedColumnCount método usa um valor booliano includePartialColumns parâmetro para determinar se as colunas parcialmente visíveis são incluídas.
VisibleRows	DisplayedRowCount método. Observação: No Visual Basic 6.0, linhas parcialmente visíveis são sempre incluídas na contagem; o DisplayedRowCount método usa um valor booliano includePartialRows parâmetro para determinar se linhas parcialmente visíveis são incluídas.
WhatsThisHelpID	Nova implementação.Para obter mais informações, consulte Suporte de Ajuda para Usuários do Visual Basic 6.0.
Width	Width, herdadas de Control classe. 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.
WrapCellPointer	Não há mais uma propriedade ajustável; padrão comportamento é WrapCellPointer = True.

Métodos

Visual Basic 6,0	Equivalente Visual Basic 2005
CaptureImage	Nova implementação.Capturar o Sumário de um DataGridView o controle para um PictureBox Não há suporte para o controle.
ClearFields	Nova implementação.Formatação da coluna é automática quando revinculada.
ClearSelCols	ClearSelection
ColContaining	IndexOf (DataGridViewColumnCollection)
Drag	Nova implementação.Para obter mais informações, consulte Arrastar e soltar para usuários do Visual Basic 6.0..
GetBookmark	Nova implementação.Indicadores não têm mais suporte.
HoldFields	Nova implementação.Formatação coluna da é preservada quando revinculada.
Move	SetBounds, herdadas de Control classe. 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.
Rebind	ResetBindings, herdadas de Control classe.
RowBookmark	Nova implementação.Indicadores não têm mais suporte.
RowContaining	IndexOf (DataGridViewColumnCollection)
RowTop	GetContentBounds (DataGridViewCell)
Scroll	Novo método implementação.Use o CurrentCell propriedade.
SetFocus	Focus
ShowWhatsThis	Nova implementação.Para obter mais informações, consulte Suporte de Ajuda para Usuários do Visual Basic 6.0.
SplitContaining	Nova implementação.Split views não são suportados; use um SplitContainer controle.
ZOrder	BringToFront()ou SendToBack()funções

Eventos

Visual Basic 6,0	Equivalente Visual Basic 2005
AfterColEdit	CellEndEdit
AfterColUpdate AfterDelete	Nova implementação.Operações de dados são manipuladas na fonte de dados.Para obter mais informações, consulte Exibindo dados no Controlarar Exibição em Grade de Dados do Windows Forms.
AfterUpdate	RowsAdded
BeforeColEdit	CellBeginEdit
BeforeColUpdate BeforeDelete BeforeInsert BeforeUpdate	Nova implementação.Operações de dados são manipuladas na fonte de dados.Para obter mais informações, consulte Exibindo dados no Controlarar Exibição em Grade de Dados do Windows Forms.
ButtonClick	Click (Button controle)
Change	TextChanged Observação: O comportamento das TextChanged evento é um pouco diferente. Para obter mais informações, consulte Evento Change do Controle ComboBox para usuários do Visual Basic 6.0.
Click	SelectedIndexChanged
ColEdit	CellBeginEdit
ColResize	ColumnWidthChanged
DblClick	CellMouseDoubleClick
DragDrop DragOver	Nova implementação.Para obter mais informações, consulte Arrastar e soltar para usuários do Visual Basic 6.0.
Error	DataError
HeadClick	ColumnHeaderMouseClick
MouseDown	CellMouseDown
MouseMove	CellMouseMove
MouseUp	CellMouseUp
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.
OnAddNew	RowsAdded
RowColChange	CurrentCellChanged
RowResize	RowHeightChanged
SelChange	SelectionChanged
SplitChange	Nova implementação.Split views não são suportados; use um SplitContainer controle.
Validate	Validating

Observações de Atualização

When a Visual Basic 6.0 project is upgraded to Visual Basic 2008, the Change event of the DataGrid control is mapped to the TextChanged event of the Visual Basic 2008 DataGridView control.O comportamento do TextChanged evento é diferente da Change evento; essa diferença pode causar resultados não intencionais no seu código.

Qualquer código relacionado a métodos ou eventos específicos de dados não é atualizado.Comentários de aviso são adicionados ao código, e estes devem ser removidos ou modificados antes de compilar o aplicativo.

Consulte também

Partilhar via