Controle CommandButton para Usuários do Visual Basic 6.0

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

Propriedades Default e Cancel

No Visual Basic 6.0, o booliano Default e Cancel Propriedades de um CommandButton controle determine se o controle responde às teclas ENTER ou ESC, respectivamente.

In Visual Basic 2008, o Button controle não possui Default ou Cancel Propriedades. The Form o objeto tem AcceptButton e CancelButton propriedades que fornecem a mesma funcionalidade; essas propriedades levam o nome de um Button controlar sistema autônomo um argumento.

Propriedade Value

No Visual Basic 6.0, o booliano Value propriedade de um CommandButton controle indica se o controle foi escolhido; configuração a propriedade para True invoca do botão Click evento.

In Visual Basic 2008, o Button controle não possui um Value propriedade. Você pode usar o GotFocus evento para determinar se o controle é escolhido; o PerformClick método pode ser usado para invocar o Click evento.

Propriedades Style, Picture, DownPicture, e DisabledPicture

No Visual Basic 6.0, definir o Estilo propriedade um CommandButton o controle para 1 Gráfica altera a aparência do controle para exibir imagens.The Picture, DownPicture, e DisabledPicture propriedades são usadas para atribuir imagens a serem exibidas em resposta à mudanças de estado. Por exemplo, quando um CommandButton controle é clicado, o DownPicture imagem será exibida; se o controle estiver desabilitado, o DisabledPicture imagem é exibida.

Visual Basic 2008 não oferece mais suporte a Style, Picture, DownPicture, ou DisabledPicture Propriedades. The Style propriedade não é mais necessária; atribuir uma figura para o Image propriedade tem o mesmo efeito sistema autônomo configuração de Style propriedade para Graphical. The Picture propriedade é substituída pelo Image propriedade. A funcionalidade do DownPicture e DisabledPicture propriedades podem ser emuladas usando um ImageList controle que contenha várias imagens.

Propriedade MaskColor

No Visual Basic 6.0, a MaskColor propriedade de um CommandButton controle é usado para definir uma cor que se torna transparente, permitindo um imagem de plano de fundo ser mostrada. Para usar essa propriedade, a Estilo a propriedade deve ser definido como Gráfica, the UseMaskColor a propriedade deve ser definido como True, e um bitmap tem que ser atribuído à Picture propriedade.

In Visual Basic 2008, não há nenhum equivalente direto para o MaskColor propriedade. No entanto, você pode, conjunto transparência em um controle usando o MakeTransparent método de um Bitmap objeto.

Outras diferenças

Além disso, existem numerosas diferenças conceituais que se aplicam a todos os controles, incluindo diferenças em ligação de dados, manipulação de fonte, arrastar e soltar, suporte do Help entre outras.Para obter mais informações, consulte Controles Windows Forms para Usuários do Visual Basic 6.0.

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

Os exemplos de código a seguir ilustram as diferenças nas técnicas de codificação entre o Visual Basic 6.0 e Visual Basic 2008.

Alterações de Código para Configuração de Botões Default e Cancel

O exemplo a seguir demonstra a configuração de dois botões para serem os botões padrão e cancelar para um formulário.

' Visual Basic 6.0
' Set the first button to respond to the Enter key.
Command1.Default = True
' Set the second button to respond to the Esc key.
Command2.Cancel = True

' Visual Basic
' Set the first button to respond to the Enter key.
Me.AcceptButton = Button1
' Set the second button to respond to the Esc key.
Me.CancelButton = Button2

Alterações de Código para Adição de Transparência a um Botão

O exemplo a seguir demonstra métodos para definir uma região transparente em um botão que contenha uma imagem; qualquer parte branca da imagem se tornará transparente.

' Visual Basic 6.0
' Assumes a picture has been assigned to the Picture property
' and that the Style property has been set to Graphical.
Command1.UseMaskColor = True
Command1.MaskColor = vbWhite

' Visual Basic
' Assumes a picture has been assigned to the BackgroundImage property.
Dim ButtonBitmap As New System.Drawing.Bitmap(Button1.BackgroundImage)
ButtonBitmap.MakeTransparent(System.Drawing.Color.White)
Button1.BackgroundImage = ButtonBitmap

Equivalências de Propriedade, Método e Evento do Controle CommandButton

As tabelas a seguir listam propriedades, métodos e eventos, juntamente com seus do Visual Basic 6.0Visual Basic 2008 equivalentes. As propriedades, métodos e eventos que têm os mesmos nomes e comportamentos não são listados.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.

Essas tabelas listam links para tópicos explicando diferenças em comportamento.Onde não há nenhum equivalente direto no Visual Basic 2008, links são fornecidos para 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 Tratamento de Cores para Usuários do Visual Basic 6.0.
Cancel	CancelButton (Form objeto)
Caption	Text
Container	Parent
Default	AcceptButton (Form objeto)
DisabledPicture DownPicture	Nova implementação.Para obter mais informações, consulte Propriedade de estilo 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.
Font FontBold FontItalic FontName FontSize FontStrikethrough FontUnderline	Font Observação: Fontes são tratadas Diferentemente em 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
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.
MaskColor	Nova implementação.Para obter mais informações, consulte MaskColor para usuários do Visual Basic 6.0.
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.
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	Image
RightToLeft	RightToLeft
Style	Nova implementação.Para obter mais informações, consulte Propriedade de estilo para usuários do Visual Basic 6.0.
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.
UseMaskColor	Nova implementação.Para obter mais informações, consulte MaskColor para usuários do Visual Basic 6.0.
Value	Nova implementação.The PerformClick método é semelhante a configuração do Value para True; para qualquer Outros uso das Value propriedade lá não é nenhum equivalente.
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

Visual Basic 6,0	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.
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.
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 função

Eventos

Observações de Atualização

Ao atualizar um aplicativo Visual Basic 6.0 usando o Assistente de atualização, qualquer CommandButton controles são atualizados para Windows Forms Button controles e código é atualizado para usar os equivalentes de propriedades, métodos e eventos. Onde não há equivalentes ou onde há possíveis diferenças de comportamento, comentários são inseridos no código com links para tópicos da Ajuda.

Quando um aplicativo é atualizado para Visual Basic 2008, se a Style propriedade é conjunto para 1 – Graphical, the FlatStyle propriedade do controle atualizado é conjunto para Standarde qualquer imagem atribuída para o Picture propriedade em time de design é atribuída para o Image propriedade do controle atualizado.

Se o DownPicture ou DisabledPicture propriedades foram definidas em time de design ou em time de execução, você precisará modificar seu aplicativo atualizado para usar um ImageList controle. Para obter mais informações, consulte Como: Emular um controle de Tri-estado do Visual Basic 6.0 em um aplicativo atualizado.

O Assistente de atualização não atualizará o código que usa o MaskColor propriedade. Avisos de atualização serão inseridos no seu código.Você precisará modificar o código antes de executar o aplicativo.

Consulte também

Conceitos

MaskColor para usuários do Visual Basic 6.0