RichTextBox-Steuerelement für Visual Basic 6.0-Benutzer

Článek
09/02/2008

Aktualisiert: November 2007

Das RichTextBox-Steuerelement von Visual Basic 6.0 wird in Visual Basic 2008 durch das RichTextBox-Steuerelement von Windows Forms ersetzt. Die Namen einiger Eigenschaften, Methoden, Ereignisse und Konstanten wurden geändert, und in einigen Fällen weicht auch ihr Verhalten ab.

Konzeptionelle Unterschiede

AutoVerbMenu-Eigenschaft

In Visual Basic 6.0 wird mit der AutoVerbMenu-Eigenschaft eines RichTextBox-Steuerelements ein Kontextmenü mit einer Reihe von Standardbefehlen angezeigt.

In Visual Basic 2008 ist die AutoVerbMenu-Eigenschaft nicht mehr vorhanden. Um ein Kontextmenü für ein RichTextBox-Steuerelement bereitzustellen, verwenden Sie eine ContextMenuStrip-Komponente. Weitere Informationen finden Sie unter Die AutoVerbMenu-Eigenschaft wurde nicht aktualisiert.

DisableNoScroll-Eigenschaft

In Visual Basic 6.0 wird über die DisableNoScroll-Eigenschaft bestimmt, ob Bildlaufleisten als nicht verfügbar angezeigt werden, wenn nicht genügend Textzeilen für einen vertikalen Bildlauf bzw. nicht genügend Zeichen für einen horizontalen Bildlauf in einem RichTextBox-Steuerelement vorhanden sind.

In Visual Basic 2008 ist die DisableNoScroll-Eigenschaft nicht mehr vorhanden. Mithilfe der ScrollBars-Eigenschaft können Sie die Anzeige der Bildlaufleisten zwar erzwingen, jedoch nicht als nicht verfügbar anzeigen.

FileName-Eigenschaft und LoadFile-Methode

In Visual Basic 6.0 wird mit der FileName-Eigenschaft oder der LoadFile-Methode eine RTF-Datei oder eine Textdatei in ein RichTextBox-Steuerelement geladen.

In Visual Basic 2008 ist nur die LoadFile-Methode verfügbar, und Sie können zur Entwurfszeit keine Datei zuweisen.

SelPrint-Methode

In Visual Basic 6.0 kann mit der SelPrint-Methode eines RichTextBox-Steuerelements der Inhalt des Steuerelements gedruckt werden. Sie akzeptiert als einziges Argument hDC, das den Gerätekontext des Geräts angibt.

In Visual Basic 2008 ist die SelPrint-Methode nicht mehr vorhanden, und Gerätekontexte werden nicht mehr zum Drucken verwendet. Das RichTextBox-Steuerelement stellt keine Methode für das Drucken seines Inhalts bereit. Sie können aber die RichTextBox-Klasse erweitern, um die EM_FORMATRANGE-Meldung zu verwenden. Sie können dann den Inhalt eines RichTextBox an ein Ausgabegerät senden, z. B. einen Drucker. Weitere Informationen finden Sie unter Die SelPrint-Eigenschaft wurde nicht aktualisiert.

SelTabCount-Eigenschaft

In Visual Basic 6.0 bestimmt die SelTabCount-Eigenschaft die Anzahl der Tabulatorpositionen in den ausgewählten oder den auf die Einfügemarke folgenden Absätzen.

Die SelTabCount-Eigenschaft ist in Visual Basic 2008 nicht mehr vorhanden. Sie wird durch den Length-Parameter der SelectionTabs-Eigenschaft ersetzt (SelectionTabs.Length).

Span-Methode

In Visual Basic 6.0 kann mithilfe der Span-Methode eines RichTextBox-Steuerelements ein Textbereich basierend auf einer Reihe von angegebenen Zeichen ausgewählt werden.

In Visual Basic 2008 ist die Span-Methode nicht mehr vorhanden. Sie können die Find-Methode zusammen mit dem characterSet()-Argument verwenden, um ein bestimmtes Zeichen zu suchen. Dann können Sie mithilfe der SelectedText-Eigenschaft den Bereich auswählen.

Upto-Methode

In Visual Basic 6.0 kann mit der Upto-Methode eines RichTextBox-Steuerelements die Einfügemarke bis zum ersten Zeichen, das ein Member einer Reihe angegebener Zeichen ist, verschoben werden.

In Visual Basic 2008 ist die Upto-Methode nicht mehr vorhanden. Sie können die Find-Methode zusammen mit dem characterSet()-Argument verwenden, um ein bestimmtes Zeichen zu suchen. Dann können Sie mithilfe der SelectionStart-Eigenschaft die Einfügemarke verschieben.

Zusätzliche Unterschiede

Außerdem gibt es zahlreiche konzeptionelle Unterschiede, die für alle Steuerelemente gelten, darunter Unterschiede bei Datenbindung, Schriftartbehandlung, Drag & Drop-Features, Hilfeunterstützung usw. Weitere Informationen finden Sie unter Windows Forms-Konzepte für Visual Basic 6.0-Benutzer.

Änderungen am Code für das RichTextBox-Steuerelement

Im folgenden Beispiel werden Unterschiede in den Codierungstechniken von Visual Basic 6.0 und Visual Basic 2008 dargestellt.

Änderungen am Code zum Durchsuchen eines RichTextBox-Steuerelements

Im folgenden Codebeispiel wird veranschaulicht, wie ein RichTextBox-Steuerelement von der Einfügemarke bis zum Ende eines Satzes durchsucht und dieses dann hervorgehoben wird. Für dieses Beispiel sind das RichTextBox-Steuerelement und mindestens ein eingegebener Satz in der Text-Eigenschaft erforderlich. Außerdem wird ein Button-Steuerelement benötigt. Da das Click-Ereignis der Schaltfläche Code aufruft, sollte die HideSelection-Eigenschaft von RichTextBox auf False festgelegt werden, andernfalls ist die Hervorhebung nicht sichtbar.

' 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

Entsprechungen zu Eigenschaften, Methoden und Ereignissen des RichTextBox-Steuerelements

In den folgenden Tabellen werden Eigenschaften, Methoden und Ereignisse von Visual Basic 6.0 zusammen mit ihren Visual Basic 2008-Entsprechungen aufgeführt. Die Eigenschaften, Methoden und Ereignisse, die über denselben Namen und dasselbe Verhalten verfügen, werden dabei nicht berücksichtigt. Alle Visual Basic 2008-Enumerationen werden, sofern nicht anders angegeben, dem System.Windows.Forms-Namespace zugeordnet.

In dieser Tabelle werden Verknüpfungen zu Themen bereitgestellt, in denen Unterschiede im Verhalten erläutert werden. Wenn in Visual Basic 2008 keine direkte Entsprechung vorhanden ist, werden Links zu Themen bereitgestellt, die Alternativen behandeln.

Eigenschaften

Visual Basic 6.0	Visual Basic 2008-Entsprechung
Appearance	Neue Implementierung. Weitere Informationen finden Sie unter Appearance-Eigenschaft und BorderStyle-Eigenschaft für Visual Basic 6.0-Benutzer.
AutoVerbMenu	Neue Implementierung. Weitere Informationen finden Sie unter Die AutoVerbMenu-Eigenschaft wurde nicht aktualisiert.
BackColor	BackColor Hinweis: Farben werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Behandeln von Farben für Visual Basic 6.0-Benutzer.
Container	Parent
DataBindings DataChanged DataField DataFormat DataMember DataSource	Neue Implementierung. Weitere Informationen finden Sie unter Datenzugriff für Visual Basic 6.0-Benutzer.
DisableNoScroll	Neue Implementierung.
DragIcon DragMode	Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer.
FileName	LoadFile-Methode
Font FontBold FontItalic FontName FontSize FontStrikethrough FontUnderline	Font Hinweis: Schriftarten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Font-Objekt für Visual Basic 6.0-Benutzer.
ForeColor	ForeColor Hinweis: Farben werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Behandeln von Farben für Visual Basic 6.0-Benutzer.
Height	Height, Size Hinweis: Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
HelpContextID	Neue Implementierung. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer.
HWnd	Handle
Index	Neue Implementierung. Weitere Informationen finden Sie unter Steuerelementarrays für Visual Basic 6.0-Benutzer.
Left	Left Hinweis: Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
MouseIcon	Neue Implementierung. Weitere Informationen finden Sie unter Es kann kein benutzerdefinierter MousePointer festgelegt werden.
MousePointer	Cursor Eine Liste mit Konstanten finden Sie unter MousePointer für Visual Basic 6.0-Benutzer.
OLEDragMode OLEDropMode	Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer.
Parent	FindForm-Methode
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	ToolTip-Komponente Weitere Informationen finden Sie unter QuickInfo-Unterstützung für Visual Basic 6.0-Benutzer.
Top	Top Hinweis: Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
WhatsThisHelpID	Neue Implementierung. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer.
Width	Width, Size Hinweis: Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.

Methoden

Visual Basic 6.0	Visual Basic 2008-Entsprechung
Drag	Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer.
GetLineFromChar	GetLineFromCharIndex
LinkExecute LinkPoke LinkRequest LinkSend	Keine Entsprechung. Weitere Informationen finden Sie unter Dynamischer Datenaustausch (Dynamic Data Exchange, DDE) für Visual Basic 6.0-Benutzer.
Move	SetBounds Hinweis: Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
OLEDrag	Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer.
SelPrint	Neue Implementierung. Weitere Informationen finden Sie unter Die SelPrint-Eigenschaft wurde nicht aktualisiert.
SetFocus	Focus
ShowWhatsThis	Neue Implementierung. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer.
Span	Keine direkte Entsprechung. Verwenden Sie die Find-Methode mit einem characterSet-Argument.
Upto	Keine direkte Entsprechung. Verwenden Sie die Find-Methode mit einem characterSet-Argument.
ZOrder	BringToFront-Funktion oder SendToBack-Funktion

Ereignisse

Visual Basic 6.0	Visual Basic 2008-Entsprechung
Change	TextChanged
DblClick	DoubleClick
DragDrop DragOver	Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer.
GotFocus	Enter
LostFocus	Leave
OLECompleteDrag OLEDragDrop OLEDragOver OLEGiveFeedback OLESetData OLEStartDrag	Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer.
SelChange	SelectionChanged
Validate	Validating

Hinweise zum Durchführen eines Updates

Bei einer Aktualisierung einer Visual Basic 6.0-Anwendung auf Visual Basic 2008 werden alle RichTextBox-Steuerelemente auf RichTextBox-Steuerelemente von Windows Forms aktualisiert. Eigenschaften, Methoden und Ereignisse werden auf ihre jeweiligen Entsprechungen aktualisiert. Bei Abweichungen im Verhalten werden Updatekommentare in den Code eingefügt.

Sdílet prostřednictvím