Objeto Form para usuários do Visual Basic 6.0

Artigo
08/25/2010

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	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	FormBorderStyle
Caption	Text
ClipControls	Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0.
Controls	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	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	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.
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	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
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	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	MaximizeBox
MDIChild	MdiParent 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	MinimizeBox
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.
Moveable	Nova implementação.Para obter mais informações, consulte A Propriedade Moveable para usuários do Visual Basic 6.0.
Name	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	BackgroundImage 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	RightToLeft 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	StartPosition Manual valor de enumeração CenterParent valor de enumeração CenterScreen valor de enumeração WindowsDefaultLocation valor de enumeração
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.
WhatsThisButton	HelpButton 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	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 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	SetBounds 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	Activate
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	Validate 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 BringToFront SendToBack

Eventos do Form

Visual Basic 6,0	Visual Basic 2008 Equivalente a
Activate	Activated 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	Click Observação: O Click Não há suporte para o evento para formulários MDI.
DblClick	DoubleClick
Deactivate	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	Enter
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	MouseDown Observação: O MouseDown Não há suporte para o evento para formulários MDI.
MouseMove	MouseMove Observação: O MouseMove Não há suporte para o evento para formulários MDI.
MouseUp	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	FormClosing 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	FormClosing 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.

Compartilhar via