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	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
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	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.
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
SelAlignment	SelectionAlignment
SelBold	SelectionFont
SelBullet	SelectionBullet
SelCharOffset	SelectionCharOffset
SelColor	SelectionColor
SelFontName	SelectionFont
SelFontSize	SelectionFont
SelHangingIndent	SelectionHangingIndent
SelIndent	SelectionIndent
SelItalic	SelectionFont
SelLength	SelectionLength
SelProtected	SelectionProtected
SelRightIndent	SelectionRightIndent
SelRTF	SelectedRtf
SelStart	SelectionStart
SelStrikethru	SelectionFont
SelTabCount	SelectionTabs.Length
SelTabs	SelectionTabs
SelText	SelectedText
SelUnderline	SelectionFont
TextRTF	Rtf
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.
GetLineFromChar	GetLineFromCharIndex
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	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.
SelPrint	Nueva implementación. Para obtener más información, vea La propiedad SelPrint no se ha actualizado.
SetFocus	Focus
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

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)

Otros recursos

RichTextBox (Control, formularios Windows Forms)