CTextDocument2 Class

Members (73)

Documentation

CTextDocument2 Class

Class that wraps all the methods of the ITextDocument and ITextDocument2 interfaces.

---

ITextDocument Interface

The ITextDocument interface is the Text Object Model (TOM) top-level interface, which retrieves the active selection and range objects for any story in the document—whether active or not. It enables the application to:

• Open and save documents.
• Control undo behavior and screen updating.
• Find a range from a screen position.
• Get an ITextStoryRanges story enumerator.

When to implement

Applications typically do not implement the ITextDocument interface. Microsoft text solutions, such as rich edit controls, implement ITextDocument as part of their TOM implementation.

When to Use

Applications can retrieve an ITextDocument pointer from a rich edit control. To do this, send an EM_GETOLEINTERFACE message to retrieve an IRichEditOle object from a rich edit control. Then, call the object's IUnknown::QueryInterface method to retrieve an ITextDocument pointer.

Inheritance

The ITextDocument interface inherits from the IDispatch interface. ITextDocument also has these types of members:

---

ITextDocument2 Interface

Extends the ITextDocument interface, adding methods that enable the Input Method Editor (IME) to drive the rich edit control, and methods to retrieve other interfaces such as ITextDisplays, ITextRange2, ITextFont2, ITextPara2, and so on.

Some ITextDocument2 methods used with the IME need access to the current window handle (HWND). Use the GetWindow method of the ITextDocument2 interface to retrieve the handle.

---

Methods inherited from CTextObjectBase Class

---

CONSTRUCTORS

Called when a CTextDocument2 class variable is created.

DECLARE CONSTRUCTOR
DECLARE CONSTRUCTOR (BYVAL hRichEdit AS HWND)
DECLARE CONSTRUCTOR (BYVAL pTextDocument2 AS ITextDocument2 PTR, BYVAL fAddRef AS BOOLEAN = FALSE)

CONSTRUCTOR (Empty)

Can be used, for example, when we have an ITextDocument2 interface pointer returned by a function and we want to attach it to a new instance of the CTextDocument2 class.

DIM pCTextDocument2 AS CTextDocument2
pCTextDocument2.Attach(pTextDocument2)

CONSTRUCTOR (hRichEdit)

CONSTRUCTOR CTextDocument2 (BYVAL hRichEdit AS HWND)

CONSTRUCTOR (ITextDocument2 PTR)

CONSTRUCTOR CTextDocument2 (BYVAL pTextDocument2 AS ITextDocument2 PTR, BYVAL fAddRef AS BOOLEAN = FALSE)

Return value

A pointer to the new instance of the class.

Usage examples

To use with the dotted syntax.

SCOPE
   ' // Create a new instance of the CTextDocument2 class
   DIM pTextDocument2 AS CTextDocument2 = hRichEdit
   ' // Get the number of characters of the text in the Rich Edit control
   DIM numChars AS LONG = RichEdit_GetTextLength(hRichEdit)
   ' // Get the 0-based range of all the text
   DIM pCRange2 AS CTextRange2 = pCTextDoc.Range2(0, numChars)
   ' // Get the text
   DIM dwsText AS DWSTRING = pCRange2.GetText2(0)
   ' // The CTextDocument2 class and the CTextRange2 class will be destroyed when the scope ends
END SCOPE

To use with the pointer syntax.

' // Create a new instance of the CTextDocument2 class
DIM pCTextDocument2 AS CTextDocument2 PTR = NEW CTextDocument2(hRichEdit)
' // Get the number of characters of the text in the Rich Edit control
DIM numChars AS LONG = RichEdit_GetTextLength(hRichEdit)
' // Get the 0-based range of all the text
DIM pCRange2 AS CTextRange2 = pCTextDoc->Range2(0, numChars)
' // Get the text
DIM dwsText AS DWSTRING = pCRange2->GetText2(0)
' // Delete the range
Delete pCRange2
' // Delete the class
Delete pCTextDocument2

DESTRUCTOR

Called automatically when a class variable goes out of scope or is destroyed.

DESTRUCTOR CTextDocument2

---

LET

Assignment operator. The assigned pointer must be an "addrefed" one.

OPERATOR LET (BYVAL pTextDocument2 AS ITextDocument2 PTR)

---

CAST

Cast operator.

OPERATOR CAST () AS ITextDocument2 PTR

---

TextDocumentPtr

Returns a pointer to the underlying ITextDocument2 interface

FUNCTION TextDocumentPtr () AS ITextDocument2 PTR

---

Attach

Attaches an ITextDocument2 interface pointer to the class.

FUNCTION Attach (BYVAL pTextDocument2 AS ITextDocument2 PTR, _
   BYVAL fAddRef AS BOOLEAN = FALSE) AS HRESULT

---

Detach

Detaches the underlying ITextDocument2 interface pointer from the class

FUNCTION Detach () AS ITextDocument2 PTR

---

GetLastResult

Returns the last result code

FUNCTION GetLastResult () AS HRESULT

---

SetResult

Sets the last result code.

FUNCTION SetResult (BYVAL Result AS HRESULT) AS HRESULT

---

GetErrorInfo

Returns a description of the last result code.

PRIVATE FUNCTION GetErrorInfo (BYVAL nError AS LONG = -1) AS DWSTRING

---

GetName

Gets the file name of this document. This is the ITextDocument default property.

FUNCTION GetName () AS DWSTRING

Return value

The filename of this document, or an empty string if there is not a filename associated with this object.

Result code

If the method succeeds, GetLastResult returns S_OK. If the method fails, it returns one of the following COM error codes.

---

GetSelection

Gets the active selection.

FUNCTION GetSelection () AS ITextSelection PTR

Return value

The ITextSelection pointer of the active selection.

Result code

If the method succeeds, GetLastResult returns S_OK. If the method fails, it returns one of the following COM error codes.

---

GetStoryCount

Gets the count of stories in this document.

FUNCTION GetStoryCount () AS LONG

Return value

The number of stories in the document.

Result code

If the method succeeds, GetLastResult returns S_OK. If the method fails, it returns one of the following COM error codes.

---

GetStoryRanges

Gets the story collection object used to enumerate the stories in a document.

FUNCTION GetStoryRanges () AS ITextStoryRanges PTR

Return value

A pointer to the ITextStoryRanges interface.

Result code

If the method succeeds, GetLastResult returns S_OK. If the method fails, it returns one of the following COM error codes.

Remarks

Invoke this method only if GetStoryCount returns a value greater than 1.

---

GetSaved

Gets a value that indicates whether changes have been made since the file was last saved.

FUNCTION GetSaved () AS LONG

Return value

The value tomTrue if no changes have been made since the file was last saved, or the value tomFalse if there are unsaved changes.

Result code

If the method succeeds, GetLastResult returns S_OK. If the method fails, it returns one of the following COM error codes.

---

SetSaved

Sets the document Saved property.

FUNCTION SetSaved (BYVAL Value AS LONG) AS HRESULT

Return value

The return value is S_OK.

---

GetDefaultTabStop

Gets the default tab width.

FUNCTION GetDefaultTabStop () AS SINGLE

Return value

The default tab width.

Result code

If the method succeeds, GetLastResult returns S_OK. If the method fails, it returns one of the following COM error codes.

---

SetDefaultTabStop

Sets the default tab stop, which is used when no tab exists beyond the current display position.

FUNCTION SetDefaultTabStop (BYVAL Value AS SINGLE = 36.0) AS HRESULT

If the method succeeds it returns S_OK. If the method fails, it returns one of the following COM error codes. For more information on COM error codes, see Error Handling in COM.

Result code

If the method succeeds, GetLastResult returns S_OK. If the method fails, it returns one of the following COM error codes.

---

New_

Opens a new document.

FUNCTION New_ () AS HRESULT

Return value

If the method succeeds, it returns S_OK.

Remarks

If another document is open, this method saves any current changes and closes the current document before opening a new one.

---

Open

Opens a specified document. There are parameters to specify access and sharing privileges, creation and conversion of the file, as well as the code page for the file.

FUNCTION Open (BYVAL pVar AS VARIANT PTR, BYVAL Flags AS LONG = 0, BYVAL CodePage AS LONG = 0) AS HRESULT

Return value

The return value can be an HRESULT value that corresponds to a system error or COM error code, including one of the following values.

---

Save

Saves the document.

FUNCTION Save (BYVAL pVar AS VARIANT PTR, BYVAL Flags AS LONG, BYVAL CodePage AS LONG) AS HRESULT

Return value

The return value can be an HRESULT value that corresponds to a system error or COM error code, including one of the following values.

Remarks

To use the parameters that were specified for opening the file, use zero values for the parameters.

If pVar is null or missing, the file name given by this document's name is used. If both of these are missing or null, the method fails.

If pVar specifies a file name, that name should replace the current Name property. Similarly, the Flags and CodePage arguments can overrule those supplied in the Open method and define the values to use for files created with the New_ method.

Unicode plain-text files should be saved with the Unicode byte-order mark (0xFEFF) as the first character. This character should be removed when the file is read in; that is, it is only used for import/export to identify the plain text as Unicode and to identify the byte order of that text. Microsoft Notepad adopted this convention, which is now recommended by the Unicode standard.

---

Freeze

Increments the freeze count.

FUNCTION Freeze () AS LONG

Return value

The updated freeze count.

Result code

If the count is nonzero, GetLastResult returns S_OK. If the count is zero, it returns FALSE.

Remarks

If the freeze count is nonzero, screen updating is disabled. This allows a sequence of editing operations to be performed without the performance loss and flicker of screen updating. To decrement the freeze count, call the Unfreeze method.

---

Unfreeze

Decrements the freeze count.

FUNCTION Unfreeze () AS LONG

Return value

The updated freeze count.

Result code

If the freeze count is zero, GetLastResult returns S_OK. If the method fails, it returns S_FALSE, indicating that the freeze count is nonzero.

Remarks

If the freeze count goes to zero, screen updating is enabled. This method cannot decrement the count below zero, and no error occurs if it is executed with a zero freeze count.

Note, if edit collection is active, screen updating is suppressed, even if the freeze count is zero.

---

BeginEditCollection

Turns on edit collection (also called undo grouping).

FUNCTION BeginEditCollection () AS HRESULT

Return value

If the method succeeds, it returns S_OK. If the method fails, it returns one of the following COM error codes.

Remarks

A single Undo command undoes all changes made while edit collection is turned on.

---

EndEditCollection

Turns off edit collection (also called undo grouping).

FUNCTION EndEditCollection () AS HRESULT

Return value

If the method succeeds, it returns S_OK. If the method fails, it returns a COM error code.

Remarks

The screen is unfrozen unless the freeze count is nonzero.

---

Undo

Performs a specified number of undo operations.

FUNCTION Undo (BYVAL Count AS LONG) AS LONG

Return value

The actual count of undo operations performed.

Result code

If all of the Count undo operations were performed, GetLastResult returns S_OK. If the method fails, it returns S_FALSE, indicating that less than Count undo operations were performed.

---

Redo

Performs a specified number of redo operations.

FUNCTION Redo (BYVAL Count AS LONG) AS LONG

Return value

The actual count of redo operations performed.

Result code

If the method succeeds GetLastResult returns S_OK. If the method fails, it returns the following COM error code.

---

Range

Retrieves a text range object for a specified range of content in the active story of the document.

FUNCTION Range (BYVAL cpActive AS LONG = 0, BYVAL cpAnchor AS LONG = 0) AS ITextRange PTR

Return value

Pointer to a ITextRange interface to the specified text range.

---

RangeFromPoint

Retrieves a range for the content at or nearest to the specified point on the screen.

FUNCTION RangeFromPoint (BYVAL x AS LONG, BYVAL y AS LONG) AS ITextRange PTR

Return value

Pointer to a ITextRange interface that corresponds to the specified point.

Result code

If the method succeeds GetLastResult returns S_OK. If the method fails, it returns the following COM error code.

---

GetCaretType

Gets the caret type.

FUNCTION GetCaretType () AS LONG

Return value

The caret type. It can be one of the following values:

Result code

If the method succeeds GetLastResult returns S_OK. If the method fails, it returns an HRESULT error code.

---

SetCaretType

Sets the caret type.

FUNCTION SetCaretType (BYVAL Value AS LONG) AS HRESULT

Result code

If the method succeeds, it returns NOERROR. Otherwise, it returns an HRESULT error code.

---

GetDisplays

Gets the displays collection for this Text Object Model (TOM) engine instance.

FUNCTION GetDisplays () AS ITextDisplays PTR

Return value

A pointer to the ITextDisplays interface.

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

Remarks

The rich edit control doesn't implement this method.

---

GetDocumentFont

Gets an object that provides the default character format information for this instance of the Text Object Model (TOM) engine.

FUNCTION GetDocumentFont () AS ITextFont2 PTR

Return value

A pointer to the ITextFont2 interface.

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

---

SetDocumentFont

Sets the default character formatting for this instance of the Text Object Model (TOM) engine.

FUNCTION SetDocumentFont (BYVAL pFont AS ITextFont2 PTR) AS HRESULT

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

Remarks

You can also set the default character formatting by calling the Reset method of the ITextFont interface with a value of tomDefault.

---

GetDocumentPara

Gets an object that provides the default paragraph format information for this instance of the Text Object Model (TOM) engine.

FUNCTION GetDocumentPara () AS ITextPara2 PTR

Return value

A pointer to the ITextPara2 interface.

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

---

SetDocumentPara

Sets the default paragraph formatting for this instance of the Text Object Model (TOM) engine.

FUNCTION SetDocumentPara (BYVAL pPara AS ITextPara2 PTR) AS HRESULT

Return value

If the method succeeds, it returns NOERROR. Otherwise, it returns an HRESULT error code.

Remarks

You can also set the default character formatting by calling the Reset method of the ITextFont interface with a value of tomDefault.

---

GetEastAsianFlags

Gets an object that provides the default paragraph format information for this instance of the Text Object Model (TOM) engine.

FUNCTION GetEastAsianFlags () AS LONG

Return value

The East Asian flags. This parameter can be a combination of the following values.

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

---

GetGenerator

Gets the name of the Text Object Model (TOM) engine.

FUNCTION GetGenerator () AS DWSTRING

Return value

The name of the TOM engine.

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

---

SetIMEInProgress

Sets the state of the Input Method Editor (IME) in-progress flag.

FUNCTION SetIMEInProgress (BYVAL Value AS LONG) AS HRESULT

Return value

If the method succeeds, it returns NOERROR. Otherwise, it returns an HRESULT error code.

---

GetNotificationMode

Gets the notification mode.

FUNCTION GetNotificationMode () AS LONG

Return value

The notification mode. This parameter is set to tomTrue if notifications are active, or tomFalse if not.

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

---

SetNotificationMode

Sets the notification mode.

FUNCTION SetNotificationMode (BYVAL Value AS LONG) AS HRESULT

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

---

GetSelection2

Gets the active selection.

FUNCTION GetSelection2 () AS ITextSelection2 PTR

Return value

A pointer to the ITextSelection2 interface of the selection. This pointer is NULL if the rich edit control is not in-place active.

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

---

GetStoryRanges2

Gets an object for enumerating the stories in a document.

FUNCTION GetStoryRanges2 () AS ITextStoryRanges2 PTR

Return value

A pointer to the ITextStoryRanges2 interface used for enumerating stories.

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

Remarks

Call this method only if the GetStoryCount method returns a value that is greater than one.

---

GetTypographyOptions

Gets the typography options.

FUNCTION GetTypographyOptions () AS LONG

Return value

A combination of the following typography options.

Return value

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

---

GetVersion

Gets the version number of the Text Object Model (TOM) engine.

FUNCTION GetVersion () AS LONG

Return value

The version number. Byte 3 gives the major version number, byte 2 the minor version number, and the low-order 16 bits give the build number.

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

---

GetWindow

Gets the handle of the window that the Text Object Model (TOM) engine is using to display output.

FUNCTION GetWindow () AS __int64

Return value

The handle of the window that the TOM engine is using.

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

Remarks

A rich edit control doesn't need to own the window that the TOM engine is using. For example, the rich edit control might be windowless.

The Input Method Editor (IME) needs the handle of the window that is receiving keyboard messages. This method retrieves that handle.

---

AttachMsgFilter

Attaches a new message filter to the edit instance. All window messages that the edit instance receives are forwarded to the message filter.

FUNCTION AttachMsgFilter (BYVAL pFilter AS IUnknown PTR) AS HRESULT

Return value

If the method succeeds, it returns NOERROR. Otherwise, it returns an HRESULT error code.

Remarks

The message filter must be bound to the document before it can be used.

---

CheckTextLimit

Checks whether the number of characters to be added would exceed the maximum text limit.

FUNCTION CheckTextLimit (BYVAL cch AS LONG) AS LONG

Return value

The number of characters that exceed the maximum text limit. This parameter is 0 if the number of characters does not exceed the limit.

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

---

GetCallManager

Gets the call manager.

FUNCTION GetCallManager () AS IUnknown PTR

Return value

The call manager object.

Result code

If the method succeeds,GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

Remarks

The call manager object is opaque to the caller. The Text Object Model (TOM) engine uses the object to handle internal notifications for particular scenarios.

---

GetClientRect

Retrieves the client rectangle of the rich edit control.

FUNCTION GetClientRect (BYVAL nType AS LONG, BYVAL pLeft AS LONG PTR, _
   BYVAL pTop AS LONG PTR, BYVAL pRight AS LONG PTR, BYVAL pBottom AS LONG PTR) AS HRESULT

Return value

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

---

GetEffectColor

Retrieves the color used for special text attributes.

FUNCTION GetEffectColor (BYVAL Index AS LONG) AS ULONG

Return value

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

Remarks

The first 16 index values are for special underline colors. If an index between 1 and 16 hasn't been defined by a call to the GetEffectColor method, GetEffectColor returns the corresponding Microsoft Word default color.

---

GetPreferredFont

Retrieves the preferred font for a particular character repertoire and character position.

FUNCTION GetPreferredFont (BYVAL cp AS LONG, BYVAL CodePage AS LONG, _
   BYVAL Options AS LONG, BYVAL curCodepage AS LONG, BYVAL curFontSize AS LONG, BYREF dwsFontName AS DWSTRING, _
   BYVAL pPitchAndFamily AS LONG PTR, BYVAL pNewFontSize AS LONG PTR) AS HRESULT

Return value

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

---

GetImmContext

Gets the Input Method Manager (IMM) input context from the Text Object Model (TOM) host.

FUNCTION GetImmContext () AS __int64

Return value

The IMM input context.

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

---

GetProperty

Retrieves the value of a property.

FUNCTION GetProperty (BYVAL nType AS LONG) AS LONG

Return value

The value of the property.

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

---

GetStrings

Gets a collection of rich-text strings.

FUNCTION GetStrings () AS ITextStrings PTR

Return value

A pointer to the ITextStrings interface of the collection of rich-text strings.

---

Notify

Notifies the Text Object Model (TOM) engine client of particular Input Method Editor (IME) events.

FUNCTION Notify (BYVAL nNotify AS LONG) AS HRESULT

Rerturn value

If the method succeeds, it returns NOERROR. Otherwise, it returns an HRESULT error code.

---

Range2

Retrieves a new text range for the active story of the document.

FUNCTION Range2 (BYVAL cpActive AS LONG = 0, BYVAL cpAnchor AS LONG = 0) AS ITextRange2 PTR

Return value

The new text range.

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

---

RangeFromPoint2

Retrieves the degenerate range at (or nearest to) a particular point on the screen.

FUNCTION RangeFromPoint2 (BYVAL x AS LONG, BYVAL y AS LONG, BYVAL nType AS LONG) AS ITextRange2 PTR

Result code

If the method succeeds, GetLastResult^^ returns **NOERROR. Otherwise, it returns an HRESUL error code.

---

ReleaseCallManager

Releases the call manager.

FUNCTION ReleaseCallManager (BYVAL pVoid AS IUnknown PTR) AS HRESULT

Return value

If the method succeeds, it returns NOERROR. Otherwise, it returns an HRESULT error code.

---

ReleaseImmContext

Releases an Input Method Manager (IMM) input context.

FUNCTION ReleaseImmContext (BYVAL Context AS __int64) AS HRESULT

Return value

If the method succeeds, it returns NOERROR. Otherwise, it returns an HRESULT error code.

---

SetEffectColor

Specifies the color to use for special text attributes.

FUNCTION SetEffectColor (BYVAL Index AS LONG, BYVAL Value AS ULONG) AS HRESULT

Return value

If the method succeeds, it returns NOERROR. Otherwise, it returns an HRESULT error code.

Remarks

The first 16 index values are for special underline colors. If an index between 1 and 16 hasn't been defined by a call to the SetEffectColor method of the ITextDocument2 interface, the corresponding Microsoft Word default color is used.

---

SetProperty

Specifies a new value for a property.

FUNCTION SetProperty (BYVAL nType AS LONG, BYVAL Value AS LONG) AS HRESULT

Return value

If the method succeeds, it returns NOERRO. Otherwise, it returns an HRESULT error code.

---

SetTypographyOptions

Specifies the typography options for the document.

FUNCTION SetTypographyOptions (BYVAL Options AS LONG, BYVAL Mask AS LONG) AS HRESULT

Typography options.

Return value

If the method succeeds, it returns NOERROR. Otherwise, it returns an HRESULT error code.

---

SysBeep

Generates a system beep.

FUNCTION SysBeep () AS HRESULT

Return value

If the method succeeds, it returns NOERROR. Otherwise, it returns an HRESULT error code.

---

Update

Updates the selection and caret.

FUNCTION Update (BYVAL Value AS LONG) AS HRESULT

Return value

If the method succeeds, it returns NOERROR. Otherwise, it returns an HRESULT error code.

---

UpdateWindow

Notifies the client that the view has changed and the client should update the view if the Text Object Model (TOM) engine is in-place active.

FUNCTION UpdateWindow () AS HRESULT

Return value

If the method succeeds, it returns NOERROR. Otherwise, it returns an HRESULT error code.

---

GetMathProperties

Gets the math properties for the document.

FUNCTION GetMathProperties () AS LONG

Return value

A combination of the following math properties:

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

---

SetMathProperties

Sets the math properties for the document.

FUNCTION SetMathProperties (BYVAL Options AS LONG, BYVAL Mask AS LONG) AS HRESULT

Return value

If the method succeeds, it returns NOERROR. Otherwise, it returns an HRESULT error code.

---

GetActiveStory

Gets the active story; that is, the story that receives keyboard and mouse input.

FUNCTION GetActiveStory () AS ITextStory PTR

Return value

A pointer to the ITextStory interface of the active story.

Result code

If the method succeeds, GetLastResult returns NOERROR. Otherwise, it returns an HRESULT error code.

---

SetActiveStory

Sets the active story; that is, the story that receives keyboard and mouse input.

FUNCTION SetActiveStory (BYVAL pStory AS ITextStory PTR) AS HRESULT

Return value

If the method succeeds, it returns NOERROR. Otherwise, it returns an HRESULT error code.

---

GetMainStory

Gets the main story.

FUNCTION GetMainStory () AS ITextStory PTR

Return value

A pointer to the ITextStory interface of the main story.

Result code

If this method succeeds, GetLastResult returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

A rich edit control automatically includes the main story; a call to the GetNewStory method is not required.

---

GetNewStory

Gets a new story. Not implemented.

FUNCTION GetNewStory () AS ITextStory PTR

Return value

A pointer to the ITextStory interface of the new story.

Result code

If this method succeeds, GetLastResult returns S_OK. Otherwise, it returns an HRESULT error code.

---

GetStory

Retrieves the story that corresponds to a particular index.

FUNCTION GetStory (BYVAl Index AS LONG) AS ITextStory PTR

Return value

A pointer to the ITextStory interface of the requested story.

Result code

If this method succeeds, GetLastResult returns S_OK. Otherwise, it returns an HRESULT error code.

---