Control CheckBox para usuarios de Visual Basic 6.0

Artículo
10/07/2008

Actualización: noviembre 2007

En este tema se compara el control CheckBox de Visual Basic 6.0 con su equivalente en Visual Basic 2008.

El control CheckBox de Visual Basic 6.0 se ha reemplazado por el control CheckBox de formularios Windows Forms en Visual Basic 2008. Los nombres de algunas propiedades, métodos, eventos y constantes son diferentes y, en algunos casos, existen diferencias de comportamiento.

Diferencias conceptuales

Click (Evento)

En Visual Basic 6.0, el evento Click se desencadena cuanto el estado de CheckBox se modifica mediante programación. En Visual Studio 2005 se utiliza el evento CheckStateChanged, no el evento Click.

Diferencias adicionales

Asimismo, hay numerosas diferencias conceptuales que se aplican a todos los controles, como diferencias en los enlaces de datos, control de fuentes, arrastrar y colocar, compatibilidad con Ayuda, y otras. Para obtener más información, consulte Información general sobre formularios Windows Forms y Adiciones a formularios Windows Forms para .NET Framework 2.0.

Cambios de código para el control CheckBox

En los ejemplos siguientes se muestran las diferencias entre las técnicas de codificación de Visual Basic 6.0 y Visual Basic 2008.

El código se modifica para responder a los clics de CheckBox

El código siguiente muestra cómo se modifica el texto de un control CheckBox cuando un usuario activa o desactiva el control. La propiedad Value de Visual Basic 6.0 se reemplaza por la propiedad Checked de Visual Basic 2008 y la propiedad Caption se reemplaza por la propiedad Text. Observe que en el ejemplo de Visual Basic 2008 se utiliza el evento CheckStateChanged para duplicar el comportamiento del evento Click de 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

El código se modifica para determinar el estado de un control CheckBox

En el ejemplo siguiente se muestra cómo se comprueba el estado de un control CheckBox en tiempo de ejecución.

' 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

Equivalencias de propiedades, métodos y eventos del control CheckBox

En las siguientes tablas se muestran propiedades, métodos y eventos de Visual Basic 6.0, junto con sus equivalentes en Visual Basic 2008. No se enumeran aquellas propiedades, métodos y eventos que tienen el mismo nombre y el mismo comportamiento. Donde corresponde, las constantes aparecen con sangría debajo de la propiedad o método. Salvo que se indique lo contrario, todas las enumeraciones de Visual Basic 2008 se asignan al espacio de nombres System.Windows.Forms.

Cuando es necesario, se proporcionan vínculos a temas que explican las diferencias de comportamiento. Cuando no existe un equivalente directo en Visual Basic 2008, se proporcionan vínculos a temas en los que se incluyen alternativas.

Propiedades

Propiedad de Visual Basic 6.0	Equivalente en Visual Basic 2008
Alignment 0 (Alinear a la izquierda) 1 (Alinear a la derecha)	CheckAlign Valor de la enumeración MiddleLeft Valor de la enumeración MiddleRight
Appearance 0 (Sin formato) 1 (3D)	Enumeración FlatStyle Valor de la enumeración Flat Valor de la enumeración Standard
BackColor	BackColor Nota: Para obtener una lista de las constantes de color, vea Control del color para usuarios de Visual Basic 6.0. Nota: Los colores se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Comportamiento del color para los usuarios de Visual Basic 6.0.
Caption	Text
Container	Parent
DataChanged DataField DataFormat DataMember DataSource	Nueva implementación. Para obtener más información, vea Acceso a datos para usuarios de Visual Basic 6.0.
DisabledPicture DownPicture	Nueva implementación. Para obtener más información, consulte Cómo: Emular un control Tri-State de Visual Basic 6.0 en una aplicación actualizada.
DragIcon DragMode	Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.
Font FontBold FontItalic FontName FontSize FontStrikethrough FontUnderline	Font Nota: Las fuentes se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Control de fuentes para usuarios de Visual Basic 6.0.
ForeColor	ForeColor Nota: Para obtener una lista de las constantes de color, vea Control del color para usuarios de Visual Basic 6.0. Nota: Los colores se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Comportamiento del color para los usuarios de Visual Basic 6.0.
Height	Height, Size Nota: Las coordenadas se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Sistema de coordenadas para usuarios de Visual Basic 6.0.
HelpContextID	Nueva implementación. Para obtener más información, vea Compatibilidad con la Ayuda para usuarios de Visual Basic 6.0.
HWnd	Handle
Index	Nueva implementación. Para obtener más información, vea Matrices de controles para usuarios de Visual Basic 6.0.
Left	Left Nota: Las coordenadas se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Sistema de coordenadas para usuarios de Visual Basic 6.0.
MaskColor	Nueva implementación. Para obtener más información, vea MaskColor para usuarios de Visual Basic 6.0.
MouseIcon	Nueva implementación. Para obtener más información, vea No se puede personalizar la propiedad MousePointer.
MousePointer	Cursor Para obtener una lista de constantes, vea MousePointer para usuarios de Visual Basic 6.0.
OLEDropMode	Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.
Parent	Método FindForm
Picture	Image
RightToLeft True	RightToLeft Valor de la enumeración Yes Valor de la enumeración No
Style 0 (Standard) 1 (Graphical)	Appearance Valor de la enumeración Normal Valor de la enumeración Button Nota: El estilo Graphical se administra de forma diferente en Visual Basic 2008. Para obtener más información, consulte Cómo: Emular un control Tri-State de Visual Basic 6.0 en una aplicación actualizada.
Tag	Tag
ToolTipText	Componente ToolTip Para obtener más información, vea Compatibilidad de la información sobre herramientas para usuarios de Visual Basic 6.0.
Top	Top Nota: Las coordenadas se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Sistema de coordenadas para usuarios de Visual Basic 6.0.
UseMaskColor	Nueva implementación. Para obtener más información, vea MaskColor para usuarios de Visual Basic 6.0.
Value 0 (vbUnchecked) 1 (vbChecked) 2 (vbGrayed)	CheckState Valor de la enumeración Unchecked Valor de la enumeración Checked Valor de la enumeración Indeterminate
WhatsThisHelpID	Nueva implementación. Para obtener más información, vea Compatibilidad con la Ayuda para usuarios de Visual Basic 6.0.
Width	Width, Size Nota: Las coordenadas se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Sistema de coordenadas para usuarios de Visual Basic 6.0.

Métodos

Método de Visual Basic 6.0	Equivalente en Visual Basic 2008
Drag	Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.
Move	SetBounds Nota: Las coordenadas se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Sistema de coordenadas para usuarios de Visual Basic 6.0.
OLEDrag	Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.
SetFocus	Focus
ShowWhatsThis	Nueva implementación. Para obtener más información, vea Compatibilidad con la Ayuda para usuarios de Visual Basic 6.0.
ZOrder 0 (vbBringToFront) 1 (vbSendToBack)	BringToFront, SendToBack

Eventos

Evento de Visual Basic 6.0	Equivalente en Visual Basic 2008
Click	CheckStateChanged Nota: En Visual Basic 6.0, el evento Click se desencadena cuanto el estado de CheckBox se modifica mediante programación. En Visual Basic 2008, no se provoca el evento Click; por lo tanto, debe utilizar el evento CheckStateChanged.
DragDrop DragOver	Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.
GotFocus	Enter
LostFocus	Leave
OLECompleteDrag OLEDragDrop OLEDragOver OLEGiveFeedback OLESetData OLEStartDrag	Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.
Validate	Validating

Notas de actualización

Cuando se actualiza una aplicación de Visual Basic 6.0 con el Asistente para aplicación, los controles CheckBox se actualizan a los controles CheckBox de formularios Windows Forms, y el código se actualiza para que utilice las propiedades, los métodos y los eventos equivalentes. Cuando no existen equivalentes o cuando es probable que existan diferencias en el comportamiento, se incluyen comentarios en el código con un vínculo a un tema de Ayuda.

Vea también

Compartir a través de