Partilhar via


Controle PictureBox para usuários do Visual Basic 6.0

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

PictureBox como um contêiner

O Visual Basic 6.0 PictureBox o controle é um caixa de controles; Além disso, para exibir imagens ele pode ser usado para agrupar e exibir outros controles.

The Visual Basic 2008 PictureBox control is not a container control; it is only used to display pictures.Você pode usar o novo Panel controle sistema autônomo uma substituição para o PictureBox controle onde você precisa um caixa de controles.

Propriedade AutoSize

No Visual Basic 6.0, a AutoSize propriedade determina se um PictureBox controle retém seu dimensionar do time de criação (AutoSize = False) ou é redimensionado dinamicamente para se ajuste às dimensões da (FiguraAutoSize = True).

In Visual Basic 2008, o AutoSize propriedade é substituída pelo SizeMode propriedade; além de Normal e AutoSize modos, opções também estão disponível para centralizar, alongar ou aplicar zoom à imagem.

Propriedades e métodos de elementos gráficos

No Visual Basic 6.0, várias propriedades gráficas e métodos podem ser usados para desenhar linhas, formas e texto na parte superior de um PictureBox controle.

In Visual Basic 2008, controles não têm mais propriedades e métodos gráficos; vo ainda pode desenhar na parte superior de um PictureBox controle usando um T:System.Drawing.Graphics objeto. Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0.

Outras diferenças

Além disso, existem várias diferenças de conceito que se aplicam a todos os controles, inclusive diferenças em vinculação de dados, manipulação de fontes, funcionalidade de arrastar/soltar, suporte para ajuda e mais.Para obter mais informações, consulte Conceitos de Windows Forms para usuários do Visual Basic 6.0.

Alterações no código para o controle PictureBox

Os exemplos a seguir ilustram diferenças na codificação técnicas entre o Visual Basic 6.0 e Visual Basic 2008.

Alterações no código para exibir uma figura

O código a seguir demonstra como exibir uma imagem em um PictureBox controle em time de execução.

' Visual Basic 6.0
Picture1.Picture = LoadPicture(App.Path & "\somepicture.jpg")
' Visual Basic
PictureBox1.Image = System.Drawing.Bitmap.FromFile( _
  My.Application.Info.DirectoryPath & "\somepicture.jpg")

Alterações no código para a eliminação de um controle PictureBox

O código a seguir demonstra como desmarcar um PictureBox controle em time de execução para que nenhuma imagem seja exibida.

' Visual Basic 6.0
Picture1.Picture = LoadPicture("")
' Visual Basic
If Not (PictureBox1.Image Is Nothing) Then
    PictureBox1.Image.Dispose()
    PictureBox1.Image = Nothing
End If

Alterações no código para desenhar em um controle PictureBox

O código a seguir demonstra como desenhar um círculo vermelho com diâmetro de 40 pixels no centralizar de um PictureBox controle em time de execução.

' Visual Basic 6.0
Private Sub Picture1_Paint
    Dim x As Integer
    Dim y As Integer
    Picture1.ScaleMode = vbPixels
    x = Picture1.ScaleWidth / 2
    y = Picture1.ScaleHeight / 2
    Picture1.Circle (x, y), 20, vbRed
End Sub
' Visual Basic
Private Sub PictureBox1_Paint(ByVal sender As Object, ByVal e _
As System.Windows.Forms.PaintEventArgs) Handles PictureBox1.Paint
    Dim radius As Integer = 20
    Dim diameter As Integer = radius * 2
    Dim x As Integer = (PictureBox1.Width / 2) - radius
    Dim y As Integer = (PictureBox1.Height / 2) - radius
    e.Graphics.DrawEllipse(Pens.Red, x, y, diameter, diameter)
End Sub

Equivalências de Propriedades, Métodos e Eventos do controle PictureBox.

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.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.

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

Visual Basic 2008 Equivalente a

Align

Dock

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.

AutoSize

SizeMode

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

BorderStyle

Observação:
No Visual Basic 6.0, o padrão é Fixed Single; em Visual Basic 2008 o padrão é None.

ClipControls

Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0.

Container

Parent

CurrentX

CurrentY

Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0.

DataChanged

DataField

DataFormat

DataMember

DataSource

Nova implementação.Para obter mais informações, consulte Acesso de dados 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.

DrawMode

DrawStyle

DrawWidth

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

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.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0.

Observação:
Em Visual Basic 2008, o Image propriedade não é uma propriedade de elementos gráficos. Ela é o equivalente do Visual Basic 6.0 Picture propriedade.

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.

LinkItem

LinkMode

LinkTimeOut

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.

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.

OLEDragMode

OLEDropMode

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

Parent

FindForm

Picture

Image

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.

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:
Coordinates 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.

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

Circle

Cls

Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0.

Drag

Nova implementação.Para obter mais informações, consulte Arrastar e soltar 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.

LinkExecute

LinkPoke

LinkRequest

LinkSend

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.

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.

PaintPicture

Point

Print

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

Focus

ShowWhatsThis

Nova implementação.Para obter mais informações, consulte Suporte de Ajuda para Usuários do Visual Basic 6.0.

TextHeight

TextWidth

Nova implementação.Para obter mais informações, consulte Elementos gráficos para usuários do Visual Basic 6.0.

ZOrder

BringToFront ou SendToBack método

Eventos

Visual Basic 6,0

Visual Basic 2008 Equivalente a

Change

Nova implementação.Há eventos individuais (BackgroundImageChanged, SizeChangede assim por diante) que são acionados quando algumas propriedades são alteradas.

DblClick

DoubleClick

DragDrop

DragOver

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

GotFocus

Enter

KeyDown

KeyPress

KeyUp

Nova implementação.The Visual Basic 2008 PictureBox control is not a container control and does not receive keystrokes.

LinkClose

LinkError

LinkNotify

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.

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.

Validate

Validating

Observações de Atualização

Durante a atualização, PictureBox controles que contêm controles são atualizados para Panel controles. Para o Visual Basic 6.0 PictureBox controles que foram atualizados para Panel controles, imagens atribuídas para o Picture propriedade são mapeados para o BackgroundPicture propriedade das Panel controle.

Consulte também

Referência

PictureBox Controlar Overview (Windows Forms)