Controllo CheckBox per gli utenti di Visual Basic 6.0

Aggiornamento: novembre 2007

In questo argomento viene presentato un confronto fra il controllo CheckBox di Visual Basic 6.0 e l'oggetto equivalente di Visual Basic 2008.

Il controllo CheckBox di Visual Basic 6.0 viene sostituito dal controllo CheckBox di Windows Form in Visual Basic 2008. I nomi di alcuni metodi, eventi, proprietà e costanti sono differenti e in certi casi esistono anche delle differenze di comportamento.

Differenze concettuali

Evento Click

In Visual Basic 6.0, quando lo stato del controllo CheckBox viene modificato a livello di codice, viene generato l'evento Click. In Visual Studio 2005, invece, si utilizza l'evento CheckStateChanged e non l'evento Click.

Altre differenze

Oltre a quanto indicato, vi sono numerose differenze concettuali che riguardano tutti i controlli, tra cui le differenze nell'associazione dati, nella gestione del tipo di carattere, nel trascinamento della selezione e nel supporto della Guida. Per ulteriori informazioni, vedere Panoramica sui Windows Form e Nuove aggiunte a Windows Form per .NET Framework 2.0.

Modifiche del codice per il controllo CheckBox

Nell'esempio riportato di seguito vengono illustrate le differenze nelle tecniche di codifica tra Visual Basic 6.0 e Visual Basic 2008.

Modifiche del codice per rispondere agli eventi Click del controllo CheckBox

Nel codice riportato di seguito viene illustrato come modificare il testo di un controllo CheckBox quando un utente seleziona o deseleziona tale controllo. La proprietà Value di Visual Basic 6.0 viene sostituita dalla proprietà Checked di Visual Basic 2008, mentre la proprietà Caption viene sostituita dalla proprietà Text. Si noti che nell'esempio relativo a Visual Basic 2008 si utilizza l'evento CheckStateChanged per simulare il funzionamento dell'evento Click di Visual Basic 6.0.

' Visual Basic 6.0
Private Sub Check1_Click()
    If Check1.Value = 1 Then
        Check1.Caption = "Checked"
    Else
        Check1.Caption = "Unchecked"
    End If
End Sub
' Visual Basic
Private Sub CheckBox1_CheckStateChanged(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles CheckBox1.CheckStateChanged
    If CheckBox1.Checked = True Then
        CheckBox1.Text = "Checked"
    Else
        CheckBox1.Text = "Unchecked"
    End If
End Sub

Modifiche del codice per l'identificazione dello stato di un controllo CheckBox

Nell'esempio seguente viene illustrato come verificare lo stato di un controllo CheckBox in fase di esecuzione.

' Visual Basic 6.0
Select Case Check1.Value
    Case vbUnchecked
        Check1.Caption = "Unchecked"
    Case vbChecked
        Check1.Caption = "Checked"
    Case vbGrayed
        Check1.Caption = "Disabled"
End Select
' Visual Basic
Select Case CheckBox1.CheckState
    Case CheckState.Unchecked
        CheckBox1.Text = "Unchecked"
    Case CheckState.Checked
        CheckBox1.Text = "Checked"
    Case CheckState.Indeterminate
        CheckBox1.Text = "Disabled"
End Select

Proprietà, metodi ed eventi equivalenti del controllo CheckBox

Nelle tabelle riportate di seguito sono elencati le proprietà, i metodi e gli eventi di Visual Basic 6.0, insieme ai rispettivi equivalenti di Visual Basic 2008. Non sono riportati nell'elenco le proprietà, i metodi e gli eventi aventi stesso nome e comportamento. Le costanti sono visualizzate, ove applicabile, sotto la proprietà o il metodo. Se non diversamente specificato, tutte le enumerazioni Visual Basic 2008 sono mappate allo spazio dei nomi System.Windows.Forms.

Ove necessario, vengono inoltre forniti collegamenti ad argomenti in cui sono descritte le differenze di comportamento. Quando non è presente un equivalente diretto in Visual Basic 2008, vengono forniti collegamenti ad argomenti in cui sono illustrate le alternative disponibili.

Proprietà

Proprietà di Visual Basic 6.0

Visual Basic 2008Equivalente

Alignment

0 (Left Justify)

1 (Right Justify)

CheckAlign

Valore di enumerazione MiddleLeft

Valore di enumerazione MiddleRight

Appearance

0 (Flat)

1 (3D)

Enumerazione FlatStyle

Valore di enumerazione Flat

Valore di enumerazione Standard

BackColor

BackColor

Nota:

Per un elenco di costanti dei colori, vedere Gestione dei colori per gli utenti di Visual Basic 6.0.

Nota:

I colori sono gestiti in modo diverso in Visual Basic 2008. Per ulteriori informazioni, vedere Comportamento dei colori per gli utenti di Visual Basic 6.0.

Caption

Text

Container

Parent

DataChanged

DataField

DataFormat

DataMember

DataSource

Nuova implementazione. Per ulteriori informazioni, vedere Accesso ai dati per gli utenti di Visual Basic 6.0.

DisabledPicture

DownPicture

Nuova implementazione. Per ulteriori informazioni, vedere Procedura: emulare un controllo a tre stati di Visual Basic 6.0 in un'applicazione aggiornata.

DragIcon

DragMode

Nuova implementazione. Per ulteriori informazioni, vedere Trascinamento della selezione per gli utenti di Visual Basic 6.0.

Font

FontBold

FontItalic

FontName

FontSize

FontStrikethrough

FontUnderline

Font

Nota:

I tipi di carattere sono gestiti in modo diverso in Visual Basic 2008. Per ulteriori informazioni, vedere Gestione dei tipi di carattere per gli utenti di Visual Basic 6.0.

ForeColor

ForeColor

Nota:

Per un elenco di costanti dei colori, vedere Gestione dei colori per gli utenti di Visual Basic 6.0.

Nota:

I colori sono gestiti in modo diverso in Visual Basic 2008. Per ulteriori informazioni, vedere Comportamento dei colori per gli utenti di Visual Basic 6.0.

Height

Height, Size

Nota:

Le coordinate sono gestite in modo diverso in Visual Basic 2008. Per ulteriori informazioni, vedere Sistema di coordinate per gli utenti di Visual Basic 6.0.

HelpContextID

Nuova implementazione. Per ulteriori informazioni, vedere Supporto della Guida per gli utenti di Visual Basic 6.0.

HWnd

Handle

Index

Nuova implementazione. Per ulteriori informazioni, vedere Matrici di controlli per gli utenti di Visual Basic 6.0.

Left

Left

Nota:

Le coordinate sono gestite in modo diverso in Visual Basic 2008. Per ulteriori informazioni, vedere Sistema di coordinate per gli utenti di Visual Basic 6.0.

MaskColor

Nuova implementazione. Per ulteriori informazioni, vedere MaskColor per gli utenti di Visual Basic 6.0.

MouseIcon

Nuova implementazione. Per ulteriori informazioni, vedere Impossibile impostare un MousePointer personalizzato.

MousePointer

Cursor

Per un elenco di costanti, vedere MousePointer per gli utenti di Visual Basic 6.0.

OLEDropMode

Nuova implementazione. Per ulteriori informazioni, vedere Trascinamento della selezione per gli utenti di Visual Basic 6.0.

Parent

Metodo FindForm

Picture

Image

RightToLeft

True

RightToLeft

Valore di enumerazione Yes

Valore di enumerazione No

Style

0 (Standard)

1 (Graphical)

Appearance

Valore di enumerazione Normal

Valore di enumerazione Button

Nota:

Vi sono differenze nel modo in cui lo stile Graphical viene gestito in Visual Basic 2008. Per ulteriori informazioni, vedere Procedura: emulare un controllo a tre stati di Visual Basic 6.0 in un'applicazione aggiornata.

Tag

Tag

ToolTipText

Componente ToolTip

Per ulteriori informazioni, vedere Supporto di ToolTip per gli utenti di Visual Basic 6.0.

Top

Top

Nota:

Le coordinate sono gestite in modo diverso in Visual Basic 2008. Per ulteriori informazioni, vedere Sistema di coordinate per gli utenti di Visual Basic 6.0.

UseMaskColor

Nuova implementazione. Per ulteriori informazioni, vedere MaskColor per gli utenti di Visual Basic 6.0.

Value

0 (vbUnchecked)

1 (vbChecked)

2 (vbGrayed)

CheckState

Valore di enumerazione Unchecked

Valore di enumerazione Checked

Valore di enumerazione Indeterminate

WhatsThisHelpID

Nuova implementazione. Per ulteriori informazioni, vedere Supporto della Guida per gli utenti di Visual Basic 6.0.

Width

Width, Size

Nota:

Le coordinate sono gestite in modo diverso in Visual Basic 2008. Per ulteriori informazioni, vedere Sistema di coordinate per gli utenti di Visual Basic 6.0.

Metodi

Metodo di Visual Basic 6.0

Visual Basic 2008Equivalente

Drag

Nuova implementazione. Per ulteriori informazioni, vedere Trascinamento della selezione per gli utenti di Visual Basic 6.0.

Move

SetBounds

Nota:

Le coordinate sono gestite in modo diverso in Visual Basic 2008. Per ulteriori informazioni, vedere Sistema di coordinate per gli utenti di Visual Basic 6.0.

OLEDrag

Nuova implementazione. Per ulteriori informazioni, vedere Trascinamento della selezione per gli utenti di Visual Basic 6.0.

SetFocus

Focus

ShowWhatsThis

Nuova implementazione. Per ulteriori informazioni, vedere Supporto della Guida per gli utenti di Visual Basic 6.0.

ZOrder

0 (vbBringToFront)

1 (vbSendToBack)

BringToFront, SendToBack

Eventi

Evento di Visual Basic 6.0

Visual Basic 2008Equivalente

Click

CheckStateChanged

Nota:

In Visual Basic 6.0, quando lo stato del controllo CheckBox viene modificato a livello di codice, viene generato l'evento Click. In Visual Basic 2008 l'evento Click non viene generato, pertanto occorre utilizzare l'evento CheckStateChanged.

DragDrop

DragOver

Nuova implementazione. Per ulteriori informazioni, vedere Trascinamento della selezione per gli utenti di Visual Basic 6.0.

GotFocus

Enter

LostFocus

Leave

OLECompleteDrag

OLEDragDrop

OLEDragOver

OLEGiveFeedback

OLESetData

OLEStartDrag

Nuova implementazione. Per ulteriori informazioni, vedere Trascinamento della selezione per gli utenti di Visual Basic 6.0.

Validate

Validating

Note sull'aggiornamento

Quando un'applicazione in Visual Basic 6.0 viene aggiornata mediante l'apposita procedura di aggiornamento guidato, tutti i controlli CheckBox vengono aggiornati in controlli CheckBox di Windows Form e il codice viene aggiornato in modo da utilizzare le proprietà, i metodi e gli eventi equivalenti. Nel caso in cui non vi fossero elementi equivalenti o vi siano possibili differenze di funzionamento, nel codice vengono inseriti dei commenti contenenti dei collegamenti utili agli argomenti della Guida.

Vedere anche

Concetti

Accesso ai dati per gli utenti di Visual Basic 6.0

Proprietà Style per gli utenti di Visual Basic 6.0

Gestione dei tipi di carattere per gli utenti di Visual Basic 6.0

Sistema di coordinate per gli utenti di Visual Basic 6.0

Matrici di controlli per gli utenti di Visual Basic 6.0

Supporto della Guida per gli utenti di Visual Basic 6.0

MousePointer per gli utenti di Visual Basic 6.0

Supporto di ToolTip per gli utenti di Visual Basic 6.0

Riferimenti

Cenni preliminari sul controllo CheckBox (Windows Form)

Altre risorse

Aggiornamento di applicazioni create in versioni precedenti di Visual Basic