Control RichTextBox para usuarios de Visual Basic 6.0
Actualización: noviembre 2007
El control RichTextBox de Visual Basic 6.0 se ha reemplazado por el control RichTextBox 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
AutoVerbMenu (propiedad)
En Visual Basic 6.0, para mostrar un menú contextual con un conjunto de comandos estándar se utiliza la propiedad AutoVerbMenu del control RichTextBox.
En Visual Basic 2008, la propiedad AutoVerbMenu ya no existe. Para proporcionar un menú contextual para un control RichTextBox, utilice un componente ContextMenuStrip. Para obtener más información, vea La propiedad AutoVerbMenu no se ha actualizado.
DisableNoScroll (propiedad)
En Visual Basic 6.0, la propiedad DisableNoScroll determina si las barras de desplazamiento aparecerán como no disponibles cuando haya muy pocas líneas de texto para el desplazamiento vertical o muy pocos caracteres para el desplazamiento horizontal en un control RichTextBox.
En Visual Basic 2008, la propiedad DisableNoScroll ya no existe. Puede utilizar la propiedad ScrollBars para forzar que aparezcan las barras de desplazamiento, pero no puede hacer que aparezcan como no disponibles.
FileName (propiedad) y LoadFile (método)
En Visual Basic 6.0, se puede utilizar la propiedad FileName o el método LoadFile para cargar archivos .rtf o de texto en controles RichTextBox.
En Visual Basic 2008, sólo está disponible el método LoadFile; no puede asignar un archivo en tiempo de diseño.
SelPrint (método)
En Visual Basic 6.0, se puede utilizar el método SelPrint de un control RichTextBox para imprimir el contenido del control. Este método acepta un único argumento, hDC, que especifica el contexto del dispositivo.
En Visual Basic 2008, ya no existe el método SelPrint y los contextos de dispositivo no se utilizan para imprimir. El control RichTextBox no proporciona un método para imprimir su contenido. Sin embargo, puede extender la clase RichTextBox para que utilice el mensaje EM_FORMATRANGE. A continuación puede enviar el contenido de un RichTextBox a un dispositivo de salida, como una impresora. Para obtener más información, vea La propiedad SelPrint no se ha actualizado.
SelTabCount (propiedad)
En Visual Basic 6.0, la propiedad SelTabCount determina el número de posiciones de tabulación del párrafo o párrafos seleccionados, o de los párrafos que vienen a continuación del punto de inserción.
En Visual Basic 2008, ya no existe la propiedad SelTabCount; la reemplaza el parámetro Length de la propiedad SelectionTabs (SelectionTabs.Length).
Span (método)
En Visual Basic 6.0, el método Span de un control RichTextBox se puede utilizar para seleccionar un fragmento de texto basándose en un conjunto de caracteres especificado.
En Visual Basic 2008, el método Span ya no existe. Puede utilizar el método Find con el argumento characterSet() para buscar un carácter especificado y luego utilizar la propiedad SelectedText para seleccionar el texto.
Upto (método)
En Visual Basic 6.0, el método Upto de un control RichTextBox se utiliza para mover el punto de inserción hasta el primer carácter (sin incluirlo) que pertenece a un conjunto de caracteres especificado.
En Visual Basic 2008, el método Upto ya no existe. Puede utilizar el método Find con el argumento characterSet() para buscar un carácter especificado y luego utilizar la propiedad SelectionStart para desplazar el punto de inserción.
Diferencias adicionales
Asimismo, hay numerosas diferencias conceptuales que se aplican a todos los controles, incluidas las diferencias en los enlaces de datos, control de fuentes, funciones de arrastrar y colocar, compatibilidad con Ayuda y otras. 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 RichTextBox
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 RichTextBox
En el código siguiente se muestra cómo buscar desde el punto de inserción hasta el final de una frase en un control RichTextBox y resaltarlo. El ejemplo requiere un control RichTextBox con una o más frases escritas en la propiedad Text y requiere un control Button. Dado que se llama al código desde el evento Click del botón, debería establecerse la propiedad HideSelection del control RichTextBox en False; de lo contrario, no estará visible el resaltado.
' Visual Basic 6.0
' Make sure that HideSelection is set to False.
Private Sub Command1_Click()
RichTextBox1.Span ".?!", True, True
End Sub
' Visual Basic
' Make sure that HideSelection is set to False.
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As _
System.EventArgs) Handles Button1.Click
Dim endChars() As Char = New Char() {".", "!", "?"}
Dim intEnd As Integer
intEnd = RichTextBox1.Find(endChars, RichTextBox1.SelectionStart)
RichTextBox1.SelectionLength = intEnd - RichTextBox1.SelectionStart
End Sub
Equivalencias de propiedades, métodos y eventos del control RichTextBox
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 en los que se 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 |
---|---|
Appearance |
Nueva implementación. Para obtener más información, vea Propiedades Appearance y BorderStyle para usuarios de Visual Basic 6.0. |
AutoVerbMenu |
Nueva implementación. Para obtener más información, vea La propiedad AutoVerbMenu no se ha actualizado. |
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 |
|
DataBindings 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. |
DisableNoScroll |
Nueva implementación. |
DragIcon DragMode |
Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0. |
FileName |
Método LoadFile |
Font FontBold FontItalic FontName FontSize FontStrikethrough FontUnderline |
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 |
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 |
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 |
|
Index |
Nueva implementación. Para obtener más información, vea Matrices de controles para usuarios de Visual Basic 6.0. |
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.
|
MouseIcon |
Nueva implementación. Para obtener más información, vea No se puede personalizar la propiedad MousePointer. |
MousePointer |
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 |
SelAlignment |
|
SelBold |
|
SelBullet |
|
SelCharOffset |
|
SelColor |
|
SelFontName |
|
SelFontSize |
|
SelHangingIndent |
|
SelIndent |
|
SelItalic |
|
SelLength |
|
SelProtected |
|
SelRightIndent |
|
SelRTF |
|
SelStart |
|
SelStrikethru |
|
SelTabCount |
SelectionTabs.Length |
SelTabs |
|
SelText |
|
SelUnderline |
|
TextRTF |
|
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 |
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 |
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. |
GetLineFromChar |
|
LinkExecute LinkPoke LinkRequest LinkSend |
No hay equivalente. Para obtener más información, vea Intercambio dinámico de datos para usuarios de Visual Basic 6.0. |
Move |
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. |
SelPrint |
Nueva implementación. Para obtener más información, vea La propiedad SelPrint no se ha actualizado. |
SetFocus |
|
ShowWhatsThis |
Nueva implementación. Para obtener más información, vea Compatibilidad con la Ayuda para usuarios de Visual Basic 6.0. |
Span |
No hay equivalente directo Utilice el método Find con un argumento characterSet. |
Upto |
No hay equivalente directo Utilice el método Find con un argumento characterSet. |
ZOrder |
Función BringToFront o SendToBack |
Eventos
Visual Basic 6.0 |
Equivalente en Visual Basic 2008 |
---|---|
Change |
|
DblClick |
|
DragDrop DragOver |
Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0. |
GotFocus |
|
LostFocus |
|
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. |
SelChange |
|
Validate |
Notas de actualización
Cuando se actualiza una aplicación de Visual Basic 6.0 a Visual Basic 2008, los controles RichTextBox se actualizan a controles RichTextBox de formularios Windows Forms, y las propiedades, métodos y eventos se actualizan a sus equivalentes. Donde puede haber diferencias en el comportamiento, se insertan comentarios de actualización en el código.
Vea también
Referencia
Información general sobre el control RichTextBox (formularios Windows Forms)