Compartilhar via


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

Visual Basic 6,0

Visual Basic 2008 Equivalente a

DragDrop

DragOver

Nova implementação.Para obter mais informações, consulte Arrastar e soltar para usuários do Visual Basic 6.0.

GotFocus

Enter

LostFocus

Leave

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.

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