Control TextBox para usuarios de Visual Basic 6.0

Artículo
10/07/2008

Actualización: noviembre 2007

El control TextBox de Visual Basic 6.0 se ha reemplazado por el control TextBox 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

En Visual Basic 6.0, la propiedad MaxLength determina el número de caracteres que se pueden escribir en un control TextBox. Si intenta insertar el texto mediante programación, se truncará en la longitud especificada por la propiedad MaxLength.

En Visual Basic 2008, el comportamiento de la propiedad MaxLength ya no se aplica al texto que se agrega mediante programación. Para duplicar el comportamiento de Visual Basic 6.0, el propio usuario debe truncar la cadena.

En Visual Basic 6.0, la propiedad PasswordChar es de tipo String; en Visual Basic 2008 es de tipo Char.

Existen muchas diferencias conceptuales que se aplican a todos los controles, como diferencias en los enlaces de datos, control de fuentes, operaciones de arrastrar y colocar, compatibilidad con la Ayuda, etc. Para obtener más información, vea Conceptos de formularios Windows Forms para usuarios de Visual Basic 6.0.

Cambios de código para el control TextBox

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

Cambios de código para buscar en un control TextBox

El siguiente código muestra cómo buscar una cadena en un control TextBox y resaltarlo.

' Visual Basic 6.0
Private Sub Form_Load ()
    Text1.Text = "Two of the peak human experiences"
    Text1.Text = Text1.Text & " are good food and classical music."
End Sub
Private Sub Form_Click ()
    Dim Search, Where
    ' Get search string from user.
    Search = InputBox("Enter text to be found:")
    ' Find string in text.
    Where = InStr(Text1.Text, Search)
    If Where Then
        Text1.SetFocus
        Text1.SelStart = Where - 1
        Text1.SelLength = Len(Search)
    Else
        MsgBox "String not found."
    End If
End Sub

' Visual Basic
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As _
System.EventArgs) Handles MyBase.Load
    TextBox1.Text = "Two of the peak human experiences are "
    TextBox1.Text = TextBox1.Text & "good food and classical music."
End Sub
Private Sub Form1_Click(ByVal sender As Object, ByVal e As _
System.EventArgs) Handles Me.Click
    Dim Search As String
    Dim Where As String
    ' Get search string from user.
    Search = InputBox("Enter text to be found:")
    ' Find string in text.
    Where = InStr(TextBox1.Text, Search)
    If Where Then
        TextBox1.Focus()
        TextBox1.SelectionStart = Where - 1
        TextBox1.SelectionLength = Len(Search)
    Else
        MsgBox("String not found.")
    End If
End Sub

Cambios de código para limitar el número de caracteres en un control TextBox

El siguiente código muestra cómo utilizar la propiedad MaxLength para especificar un número máximo de caracteres.

' Visual Basic 6.0
Private Sub Form_Load()
    Text1.MaxLength = 5
End Sub
Private Sub SetText()
    ' Only the first five characters will be displayed.
    Text1.Text = "Hello World"
End Sub

' Visual Basic
Private Sub Form1_Load2(ByVal sender As System.Object, ByVal e As _
System.EventArgs) Handles MyBase.Load
    TextBox1.MaxLength = 5
End Sub
Private Sub SetText()
    ' Truncate the string to equal MaxLength.
    TextBox1.Text = Strings.Left("Hello World", TextBox1.MaxLength)
End Sub

Equivalencias de propiedad, método y evento de control TextBox

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. Salvo que se indique lo contrario, todas las enumeraciones de Visual Basic 2008 se asignan al espacio de nombres System.Windows.Forms.

Esta tabla proporciona 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

Visual Basic 6.0	Equivalente en Visual Basic 2008
Alignment	TextAlign
Appearance	Nueva implementación. Para obtener más información, vea Propiedades Appearance y BorderStyle para usuarios de Visual Basic 6.0.
BackColor	BackColor Nota: Los colores se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Control del color para usuarios de Visual Basic 6.0.
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.
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 Objeto Font para usuarios de Visual Basic 6.0.
ForeColor	ForeColor Nota: Los colores se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Control del color para 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.
LinkItem LinkMode LinkTimeOut LinkTopic	Nueva implementación. Para obtener más información, vea Intercambio dinámico de datos para usuarios de Visual Basic 6.0.
Locked	ReadOnly
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.
OLEDragMode 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.
SelLength	SelectionLength
SelStart	SelectionStart
SelText	SelectedText
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.
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

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.
LinkExecute LinkPoke LinkRequest LinkSend	Nueva implementación. Para obtener más información, vea Intercambio dinámico de datos 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	Función BringToFront o SendToBack

Eventos

Visual Basic 6.0	Equivalente en Visual Basic 2008
Change	TextChanged
DblClick	DoubleClick
DragDrop DragOver	Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.
GotFocus	Enter
LinkClose LinkError LinkNotify LinkOpen	Nueva implementación. Para obtener más información, vea Intercambio dinámico de datos para usuarios de Visual Basic 6.0.
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 la actualización

Cuando se actualiza una aplicación de Visual Basic 6.0 a Visual Basic 2008, los controles TextBox se actualizan a controles TextBox de formularios Windows Forms, y las propiedades, métodos y eventos se actualizan a sus equivalentes. Donde puedan haber diferencias en comportamiento, los comentarios de actualización se insertan en el código.

Vea también

Referencia

Información general sobre el control TextBox (formularios Windows Forms)