Export (0) Print
Expand All
Expand Minimize

RichTextBoxStreamType Enumeration

Specifies the types of input and output streams used to load and save data in the RichTextBox control.

[Visual Basic]
<Serializable>
Public Enum RichTextBoxStreamType
[C#]
[Serializable]
public enum RichTextBoxStreamType
[C++]
[Serializable]
__value public enum RichTextBoxStreamType
[JScript]
public
   Serializable
enum RichTextBoxStreamType

Remarks

Use the members of this enumeration when calling the LoadFile and SaveFile methods of the RichTextBox control.

Members

Member name Description
PlainText A plain text stream that includes spaces in places of Object Linking and Embedding (OLE) objects.
RichNoOleObjs A Rich Text Format (RTF) stream with spaces in place of OLE objects. This value is only valid for use with the SaveFile method of the RichTextBox control.
RichText A Rich Text Format (RTF) stream.
TextTextOleObjs A plain text stream with a textual representation of OLE objects. This value is only valid for use with the SaveFile method of the RichTextBox control.
UnicodePlainText A text stream that contains spaces in place of Object Linking and Embedding (OLE) objects. The text is encoded in Unicode.

Example

[Visual Basic, C#, C++] The following example saves the contents of the RichTextBox into an ASCII text file. The example uses the SaveFileDialog class to display a dialog to request the path and file name from the user. The code then saves the contents of the control to that file. The example uses this version of the SaveFile method to specify that the file be saved as an ASCII text file instead of the standard Rich Text Format. This example assumes that the code is placed in a Form class that has a RichTextBox control named richTextBox1.

[Visual Basic] 
Public Sub SaveMyFile()
    ' Create a SaveFileDialog to request a path and file name to save to.
    Dim saveFile1 As New SaveFileDialog()
    
    ' Initialize the SaveFileDialog to specify the RTF extension for the file.
    saveFile1.DefaultExt = "*.rtf"
    saveFile1.Filter = "RTF Files|*.rtf"
    
    ' Determine if the user selected a file name from the saveFileDialog.
    If (saveFile1.ShowDialog() = System.Windows.Forms.DialogResult.OK) _
        And (saveFile1.FileName.Length) > 0 Then
    
        ' Save the contents of the RichTextBox into the file.
        richTextBox1.SaveFile(saveFile1.FileName, _
            RichTextBoxStreamType.PlainText)
    End If
End Sub


[C#] 
public void SaveMyFile()
{
   // Create a SaveFileDialog to request a path and file name to save to.
   SaveFileDialog saveFile1 = new SaveFileDialog();

   // Initialize the SaveFileDialog to specify the RTF extension for the file.
   saveFile1.DefaultExt = "*.rtf";
   saveFile1.Filter = "RTF Files|*.rtf";

   // Determine if the user selected a file name from the saveFileDialog.
   if(saveFile1.ShowDialog() == System.Windows.Forms.DialogResult.OK &&
      saveFile1.FileName.Length > 0) 
   {
      // Save the contents of the RichTextBox into the file.
      richTextBox1.SaveFile(saveFile1.FileName, RichTextBoxStreamType.PlainText);
   }
}


[C++] 
public:
void SaveMyFile()
{
   // Create a SaveFileDialog to request a path and file name to save to.
   SaveFileDialog* saveFile1 = new SaveFileDialog();

   // Initialize the SaveFileDialog to specify the RTF extension for the file.
   saveFile1->DefaultExt = S"*.rtf";
   saveFile1->Filter = S"RTF Files|*.rtf";

   // Determine if the user selected a file name from the saveFileDialog.
   if(saveFile1->ShowDialog() == System::Windows::Forms::DialogResult::OK &&
      saveFile1->FileName->Length > 0) 
   {
      // Save the contents of the RichTextBox into the file.
      richTextBox1->SaveFile(saveFile1->FileName, RichTextBoxStreamType::PlainText);
   }
}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Namespace: System.Windows.Forms

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Assembly: System.Windows.Forms (in System.Windows.Forms.dll)

See Also

System.Windows.Forms Namespace | RichTextBox | LoadFile | SaveFile

Show:
© 2014 Microsoft