Objeto Form para usuários do Visual Basic 6.0
The Form objeto no Visual Basic 6.0 é substituído pelo Form classe na 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
Eventos Activate e Deactivate
No Visual Basic 6.0, a Activate e Deactivate eventos são disparados somente quando se alterna entre formulários.
In Visual Basic 2008, o Activated e Deactivate eventos também são disparados quando se alterna entre outros aplicativos.
Evento queryUnload
No Visual Basic 6.0, a QueryUnload evento leva dois argumentos: Cancel e UnloadMode. Consultando o UnloadMode argumento podem determinar por que o formulário está sendo descarregado e então cancelar se necessário.
In Visual Basic 2008, o QueryUnload evento é substituído pelo FormClosing evento; UnloadMode é substituído por CloseReason.
Propriedade Picture
No Visual Basic 6.0, uma imagem atribuída à Picture propriedade é exibida no canto superior esquerdo do formulário se o bitmap for menor que o formulário.
In Visual Basic 2008, o Picture propriedade é substituída pelo BackgroundImage propriedade; se a imagem atribuída para o BackgroundImage propriedade é menor que o formulário, ela ficará lado a lado por padrão.
Propriedade Moveable
No Visual Basic 6.0, a Moveable propriedade de um formulário pode ser conjunto para False Para impedir que um usuário mova o formulário em time de execução. Windows Forms em Visual Basic 2008 não tem uma propriedade equivalente.
Embora geralmente seja considerado um design incorreto para a interface do usuário, você pode obter semelhante comportamento no Visual Basic 2008 Por configuração o FormBorderStyle propriedade para None e o ControlBox propriedade para False.
Método ValidateControls
No Visual Basic 6.0, a ValidateControls método é usado para forçar o Validate evento para o controle tem foco quando um formulário é fechado; se a Validate evento falha, será gerado um erro.
In Visual Basic 2008, o ValidateControls método é substituído pelo Validate método, que retorna True ou False.
Eventos de Mouse para formulários MDI
No Visual Basic 6.0, os formulários MDI oferecem suporte a eventos de mouse.In Visual Basic 2008, o Click, MouseDown, MouseMove, e MouseUp eventos não há mais suporte para formulários MDI, porque o formulário MDI não tem nenhuma área de cliente para receber eventos de mouse.
Alterações de código para o objeto Form
Os exemplos a seguir ilustram as diferenças na codificação técnicas entre o Visual Basic 6.0 e Visual Basic 2008.
Alterações de código para determinar por que um formulário é fechado
O código a seguir pode ajudá-lo a determinar porque um formulário é fechado e como atuar de acordo com o motivo.No exemplo do Visual Basic 6.0, a UnloadMode argumento das QueryUnload evento é usado. No Visual Basic 2008 exemplo, o argumento é substituído pelo CloseReason parâmetro na FormClosing manipulador de eventos.
' Visual Basic 6.0
Private Sub Form_QueryUnload(Cancel As Integer, UnloadMode As Integer)
If UnloadMode = vbFormControlMenu Then
Cancel = True
End If
End Sub
' Visual Basic
Private Sub Form1_FormClosing(ByVal sender As System.Object, _
ByVal e As System.Windows.Forms.FormClosingEventArgs) Handles _
MyBase.FormClosing
If e.CloseReason.UserClosing Then
e.Cancel = True
End If
End Sub
Alterações de código para validação de um controle no formulário
O código a seguir demonstra como forçar a validação do controle que tem foco quando o formulário é fechado.Este exemplo assume que o CausesValidation propriedade das TextBox controle estiver definida como o valor padrão de True.
' Visual Basic 6.0
Private Sub Text1_Validate(Cancel As Boolean)
If Text1.Text = "" Then
MsgBox ("Please enter a name")
Cancel = True
End If
Private Sub Form_Unload(Cancel As Integer)
OnError GoTo ERR_HANDLER
Me.ValidateControls
ERR_HANDLER:
' If validation failed cancel the Unload event.
If Err.Number = 380 Then
Cancel = True
End If
End Sub
' Visual Basic
Private Sub TextBox1_Validating(ByVal sender As Object, ByVal e As _
System.ComponentModel.CancelEventArgs) Handles TextBox1.Validating
If TextBox1.Text = "" Then
MsgBox("Please enter a name")
e.Cancel = True
End If
End Sub
Private Sub Form1_FormClosing(ByVal sender As System.Object, ByVal e _
As System.Windows.Forms.FormClosingEventArgs) Handles _
MyBase.FormClosing
' If validation failed cancel the Closing event.
If Me.Validate = False Then
e.Cancel = True
End If
End Sub
Equivalências de eventos, métodos e propriedades do objeto Form
As tabelas a seguir listam propriedades, métodos e eventos, juntamente com seus do Visual Basic 6.0Visual Basic 2008 Propriedades. 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.
Links são fornecidos conforme necessário para tópicos explicando diferenças no comportamento.Onde não há nenhum equivalente direto no Visual Basic 2008, são fornecidos links para tópicos que apresentam alternativas.
Propriedades do Form
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. |
AutoRedraw |
Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0. |
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.
|
BorderStyle |
|
Caption |
|
ClipControls |
Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0. |
Controls |
Observação:
Existem diferenças na Controls coleção no Visual Basic 2008. Para obter mais informações, consulte Coleção controles para usuários do Visual Basic 6.0.
|
Count |
Observação:
Existem diferenças na Controls coleção no Visual Basic 2008. Para obter mais informações, consulte Controles Windows Forms para Usuários do Visual Basic 6.0.
|
CurrentX CurrentY |
Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0. |
DrawMode DrawStyle DrawWidth |
Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0. |
FillColor FillStyle |
Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0. |
Font FontBold FontItalic FontName FontSize FontStrikethrough FontUnderline |
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 |
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.
|
HasDC |
Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0. |
HDC |
Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0. |
Height |
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 |
|
Image |
Nova implementação.The Image propriedade no Visual Basic 6.0 retornava um identificador para um bitmap; imagens no Visual Basic 2008 não têm identificadores. |
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.
|
LinkMode LinkTopic |
Não há equivalente.Para obter mais informações, consulte A Dinâmico intercâmbio de dados para usuários do Visual Basic 6.0. |
MaxButton |
|
MDIChild |
Observação:
Comportamento MDI é diferente de Visual Basic 2008.Para obter mais informações, consulte MDI para usuários do Visual Basic 6.0.
|
MinButton |
|
MouseIcon |
Nova implementação.Para obter mais informações, consulte Não é possível definir um MousePointer personalizado. |
MousePointer |
Para obter uma lista de constantes, consulte MousePointer para usuários do Visual Basic 6.0. |
Moveable |
Nova implementação.Para obter mais informações, consulte A Propriedade Moveable para usuários do Visual Basic 6.0. |
Name |
|
NegotiateMenus |
Nova implementação.Para obter mais informações, consulte Objeto MENU para usuários do Visual Basic 6.0. |
OLEDropMode |
Nova implementação.Para obter mais informações, consulte Arrastar e soltar para usuários do Visual Basic 6.0. |
Palette PaletteMode |
Nova implementação.Para obter mais informações, consulte Paletas para usuários do Visual Basic 6.0. |
Picture |
Observação:
No Visual Basic 6.0, o Picture foi exibido em canto superior esquerdo do formulário; no Visual Basic 2008, o BackgroundImage é disposta lado a lado.
|
RightToLeft: True False |
Yes valor de enumeração |
ScaleHeight ScaleLeft ScaleMode ScaleTop ScaleWidth |
Nova implementação.Para obter mais informações, consulte Sistema de Coordenadas para usuários do Visual Basic 6.0. |
StartUpPosition: 0 – Manual 1 – CenterOwner 2 – CenterScreen 3 – Windows Default |
Manual valor de enumeração CenterParent valor de enumeração CenterScreen valor de enumeração WindowsDefaultLocation valor de enumeração |
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.
|
WhatsThisButton |
Observação:
Há diferenças de comportamento Ajuda no Visual Basic 2008.Para obter mais informações, consulte Suporte de Ajuda para Usuários do Visual Basic 6.0.
|
WhatsThisHelp |
Nova implementação.Para obter mais informações, consulte Suporte de Ajuda para Usuários do Visual Basic 6.0. |
Width |
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 do Form
Visual Basic 6,0 |
Visual Basic 2008 Equivalente a |
---|---|
Circle |
Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0. |
Cls |
Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0. |
Line |
Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0. |
Move |
Observação:
As coordenadas são manipulada comparação erently 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. |
PaintPicture |
Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0. |
Point |
Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0. |
PopupMenu |
Nova implementação.Para obter mais informações, consulte Objeto MENU para usuários do Visual Basic 6.0. |
PrintForm |
Nova implementação.Para obter mais informações, consulte Alterações na Impressão para usuários do Visual Basic 6.0. |
Pset |
Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0. |
Scale ScaleX ScaleY |
Nova implementação.Para obter mais informações, consulte Sistema de Coordenadas para usuários do Visual Basic 6.0. |
SetFocus |
|
Show |
Show ou ShowDialog |
TextHeight |
Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0. |
TextWidth |
Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0. |
ValidateControls |
Observação:
O Validate método retorna True ou False; ValidateControls gerou um erro se validação falhou.
|
WhatsThisMode |
Nova implementação.Para obter mais informações, consulte Suporte de Ajuda para Usuários do Visual Basic 6.0. |
ZOrder: 0 – vbBringToFront 1 - vbSendToBack |
BringToFront ou SendToBack função |
Eventos do Form
Visual Basic 6,0 |
Visual Basic 2008 Equivalente a |
---|---|
Activate |
Observação:
No Visual Basic 6.0, o Activate evento é disparado somente quando se alterna entre formulários no aplicativo; em Visual Basic 2008, o Activated evento também é disparado quando alterna com outros aplicativos.
|
Click |
Observação:
O Click Não há suporte para o evento para formulários MDI.
|
DblClick |
|
Deactivate |
Observação:
No Visual Basic 6.0, o Deactivate evento é disparado somente quando se alterna entre formulários no aplicativo; em Visual Basic 2008, ele também é disparado quando alterna com outros aplicativos.
|
DragDrop DragOver |
Nova implementação.Para obter mais informações, consulte Arrastar e soltar para usuários do Visual Basic 6.0. |
GotFocus |
|
Initialize |
Método New
Observação:
O comportamento das New método é diferente de Initialize evento. Para obter mais informações, consulte Tarefas em formulários para usuários do Visual Basic 6.0.
|
LinkClose LinkError LinkExecute LinkOpen |
Não há equivalente.Para obter mais informações, consulte A Dinâmico intercâmbio de dados para usuários do Visual Basic 6.0. |
MouseDown |
Observação:
O MouseDown Não há suporte para o evento para formulários MDI.
|
MouseMove |
Observação:
O MouseMove Não há suporte para o evento para formulários MDI.
|
MouseUp |
Observação:
O MouseUp Não há suporte para o evento para formulários MDI.
|
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. |
QueryUnload |
Observação:
No Visual Basic 6.0, QueryUnload leva dois argumentos: Cancel e UnloadMode. In Visual Basic 2008, Cancel é substituído por Cancel; UnloadMode é substituído por CloseReason.
|
Terminate |
Método Dispose
Observação:
O comportamento das Dispose método é diferente de Terminate evento. Para obter mais informações, consulte Eventos de formulário para usuários do Visual Basic 6.0.
|
Unload |
Observação:
O comportamento das FormClosing evento é diferente de Unload evento. Para obter mais informações, consulte Eventos de formulário para usuários do Visual Basic 6.0.
|
Consulte também
Conceitos
Tarefas em formulários para usuários do Visual Basic 6.0