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

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)