Contrôle RichTextBox pour les utilisateurs de Visual Basic 6.0
Mise à jour : novembre 2007
Le contrôle RichTextBox de Visual Basic 6.0 est remplacé par le contrôle Windows Forms RichTextBox dans Visual Basic 2008. Les noms de certains événements, propriétés, méthodes et constantes ont changé. En outre, dans certains cas, leur comportement est également différent.
Différences conceptuelles
Propriété AutoVerbMenu
Dans Visual Basic 6.0, la propriété AutoVerbMenu d'un contrôle RichTextBox est utilisée pour afficher un menu contextuel avec un jeu de commandes standard.
Dans Visual Basic 2008, la propriété AutoVerbMenu n'existe plus. Pour fournir un menu contextuel pour un contrôle RichTextBox, utilisez un composant ContextMenuStrip. Pour plus d'informations, consultez La propriété AutoVerbMenu n'a pas été mise à niveau.
Propriété DisableNoScroll
Dans Visual Basic 6.0, la propriété DisableNoScroll détermine si les barres de défilement apparaissent estompées lorsqu'il n'y a pas suffisamment de lignes pour nécessiter un défilement vertical ou pas suffisamment de caractères pour nécessiter un défilement horizontal dans un contrôle RichTextBox.
Dans Visual Basic 2008, la propriété DisableNoScroll n'existe plus. Vous pouvez utiliser la propriété ScrollBars pour forcer l'affichage des barres de défilement, mais vous ne pouvez pas les faire apparaître comme indisponibles.
Propriété FileName et méthode LoadFile
Dans Visual Basic 6.0, la propriété FileName ou la méthode LoadFile peut être utilisée pour charger un fichier texte ou .rtf dans un contrôle RichTextBox.
Dans Visual Basic 2008, seule la méthode LoadFile est disponible ; vous ne pouvez pas assigner de fichier au moment du design.
Méthode SelPrint
Dans Visual Basic 6.0, la méthode SelPrint d'un contrôle RichTextBox peut être utilisée pour imprimer le contenu du contrôle. Elle utilise un seul argument, hDC, qui spécifie le contexte de périphérique (Device Context).
Dans Visual Basic 2008, la méthode SelPrint n'existe plus et les contextes de périphérique ne sont plus utilisés pour l'impression. Le contrôle RichTextBox ne fournit pas de méthode pour imprimer son contenu. Toutefois, vous pouvez étendre la classe RichTextBox pour utiliser le message EM_FORMATRANGE. Vous pouvez envoyer ensuite le contenu d'un RichTextBox à un périphérique de sortie, tel qu'une imprimante. Pour plus d'informations, consultez La propriété SelPrint n'a pas été mise à niveau.
Propriété SelTabCount
Dans Visual Basic 6.0, la propriété SelTabCount détermine le nombre de positions de tabulation dans le ou les paragraphes sélectionnés, ou dans les paragraphes qui suivent le point d'insertion.
Dans Visual Basic 2008, la propriété SelTabCount n'existe plus. Elle est remplacée par le paramètre Length de la propriété SelectionTabs (SelectionTabs.Length).
Méthode Span
Dans Visual Basic 6.0, la méthode Span d'un contrôle RichTextBox peut être utilisée pour sélectionner une plage de texte basée sur un jeu de caractères spécifiés.
Dans Visual Basic 2008, la méthode Span n'existe plus. Vous pouvez utiliser la méthode Find avec l'argument characterSet() pour rechercher un caractère spécifié, puis utiliser la propriété SelectedText pour sélectionner la plage.
Méthode Upto
Dans Visual Basic 6.0, la méthode Upto d'un contrôle RichTextBox peut être utilisée pour déplacer le point d'insertion jusqu'au premier caractère membre d'un jeu de caractères spécifiés.
Dans Visual Basic 2008, la méthode Upto n'existe plus. Vous pouvez utiliser la méthode Find avec l'argument characterSet() pour rechercher un caractère spécifié, puis utiliser la propriété SelectionStart pour déplacer le point d'insertion.
Différences supplémentaires
De plus, de nombreuses différences conceptuelles s'appliquent à tous les contrôles, y compris des différences relatives à la liaison de données, la gestion des polices, les fonctionnalités de glisser-déplacer, la prise en charge de l'aide, etc. Pour plus d'informations, consultez Concepts Windows Forms pour les utilisateurs de Visual Basic 6.0.
Modifications apportées au code du contrôle RichTextBox
Les exemples ci-dessous illustrent les différences entre les techniques de codage dans Visual Basic 6.0 et dans Visual Basic 2008.
Modifications du code pour la recherche dans un contrôle RichTextBox
Le code suivant montre comment effectuer une recherche entre le point d'insertion et la fin d'une phrase dans un contrôle RichTextBox, et le mettre en surbrillance. L'exemple requiert un contrôle RichTextBox avec une ou plusieurs phrases entrées dans la propriété Text, et requiert aussi un contrôle Button. Étant donné que le code est appelé à partir de l'événement Click du bouton, la propriété HideSelection du RichTextBox doit avoir la valeur False faute de quoi la mise en surbrillance ne sera pas visible.
' 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
Équivalences des propriétés, méthodes et événements du contrôle RichTextBox
Les tableaux ci-dessous répertorient les propriétés, les méthodes et les événements de Visual Basic 6.0, ainsi que leurs équivalents dans Visual Basic 2008. Ces propriétés, méthodes et événements qui ont les mêmes nom et comportement ne sont pas répertoriés. Sauf indication contraire, toutes les énumérations Visual Basic 2008 sont mappées à l'espace de noms System.Windows.Forms.
Ce tableau fournit des liens vers les rubriques qui expliquent des différences de comportement. Lorsqu'il n'existe pas d'équivalent direct dans Visual Basic 2008, des liens vous renvoient vers des rubriques proposant des alternatives.
Propriétés
Visual Basic 6.0 |
Équivalent Visual Basic 2008 |
||
---|---|---|---|
Appearance |
Nouvelle implémentation. Pour plus d'informations, consultez Propriétés Appearance et BorderStyle pour les utilisateurs de Visual Basic 6.0. |
||
AutoVerbMenu |
Nouvelle implémentation. Pour plus d'informations, consultez La propriété AutoVerbMenu n'a pas été mise à niveau. |
||
BackColor |
|
||
Container |
|||
DataBindings DataChanged DataField DataFormat DataMember DataSource |
Nouvelle implémentation. Pour plus d'informations, consultez Accès aux données pour les utilisateurs de Visual Basic 6.0. |
||
DisableNoScroll |
Nouvelle implémentation. |
||
DragIcon DragMode |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
||
FileName |
Méthode LoadFile |
||
Font FontBold FontItalic FontName FontSize FontStrikethrough FontUnderline |
|
||
ForeColor |
|
||
Height |
|
||
HelpContextID |
Nouvelle implémentation. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0. |
||
HWnd |
|||
Index |
Nouvelle implémentation. Pour plus d'informations, consultez Tableaux de contrôles pour les utilisateurs de Visual Basic 6.0. |
||
Left |
|
||
MouseIcon |
Nouvelle implémentation. Pour plus d'informations, consultez Impossible de définir un pointeur de souris personnalisé. |
||
MousePointer |
Pour obtenir la liste des constantes, consultez MousePointer pour les utilisateurs de Visual Basic 6.0. |
||
OLEDragMode OLEDropMode |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
||
Parent |
Méthode 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 |
Composant ToolTip Pour plus d'informations, consultez Prise en charge des info-bulles pour les utilisateurs de Visual Basic 6.0. |
||
Top |
|
||
WhatsThisHelpID |
Nouvelle implémentation. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0. |
||
Width |
|
Méthodes
Visual Basic 6.0 |
Équivalent Visual Basic 2008 |
||
---|---|---|---|
Drag |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
||
GetLineFromChar |
|||
LinkExecute LinkPoke LinkRequest LinkSend |
Pas d'équivalent. Pour plus d'informations, consultez Échange dynamique de données pour les utilisateurs de Visual Basic 6.0. |
||
Move |
|
||
OLEDrag |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
||
SelPrint |
Nouvelle implémentation. Pour plus d'informations, consultez La propriété SelPrint n'a pas été mise à niveau. |
||
SetFocus |
|||
ShowWhatsThis |
Nouvelle implémentation. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0. |
||
Span |
Pas d'équivalent direct. Utilisez la méthode Find avec un argument characterSet. |
||
Upto |
Pas d'équivalent direct. Utilisez la méthode Find avec un argument characterSet. |
||
ZOrder |
Fonction BringToFront ou SendToBack |
Événements
Visual Basic 6.0 |
Équivalent Visual Basic 2008 |
---|---|
Change |
|
DblClick |
|
DragDrop DragOver |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
GotFocus |
|
LostFocus |
|
OLECompleteDrag OLEDragDrop OLEDragOver OLEGiveFeedback OLESetData OLEStartDrag |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
SelChange |
|
Validate |
Mettre à niveau des remarques
Lorsqu'une application Visual Basic 6.0 est mise à niveau vers Visual Basic 2008, tous les contrôles RichTextBox sont mis à niveau vers des contrôles Windows Forms RichTextBox, et les propriétés, méthodes et événements sont mis à niveau vers leurs équivalents. Des commentaires de mise à niveau sont insérés dans le code aux endroits où des différences de comportement sont susceptibles de se produire.
Voir aussi
Référence
Vue d'ensemble du contrôle RichTextBox (Windows Forms)