![](../../Home/Icons/Home.gif)
![](../icons/UpCNM.gif)
![](../icons/CNMContext.gif)
![](../../Home/Icons/Search.gif)
Taxonomy Categories:
Member Functions:
Interface Category:
API.
Inherits From:
TChangeStylesCommand
Inherited By:
None.
Purpose:
TRemoveStylesCommand, derived from TChangeStylesCommand, is used to remove a set of styles from the currently selected text. This command does not change the current selection.
Instantiation:
Allocate on the heap or the stack.
Deriving Classes:
The class is designed to be used directly.
Concurrency:
This command's functions assume that any required locks have already been acquired by the client.
Resource Use:
No special requirements.
Other Considerations:
None.
- TRemoveStylesCommand ()
- TRemoveStylesCommand (const TStyleSet & stylesToChange)
- TRemoveStylesCommand (const TRemoveStylesCommand &)
Interface Category:
API.
Purpose:
- Default constructor.
- Constructs a command that will remove the specified set of styles from the target selection.
- Copy constructor.
Calling Context:
- Called by the stream-in operators. Call this function directly.
- Call to construct a command that will remove particular styles. Called when creating the menus for the view. Call this function directly.
- Called to copy an object. Call this function directly.
Parameters:
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
This command's functions assume that any required locks have already been acquired by the client.
Other Considerations:
None.
virtual ~ TRemoveStylesCommand ()
Interface Category:
API.
Purpose:
Destructor.
Calling Context:
Typically not called directly by clients.
Parameters:
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
This command's functions assume that any required locks have already been acquired by the client.
Other Considerations:
None.
TRemoveStylesCommand & operator =(const TRemoveStylesCommand &)
Interface Category:
API.
Purpose:
Assignment operator.
Calling Context:
Call this function directly.
Parameters:
Return Value:
A non-const reference to the left-hand side object.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
This command's functions assume that any required locks have already been acquired by the client.
Other Considerations:
None.
virtual void HandleChangeStyles (MTextRepresentation * textToChange, const TStyleSet & styleToChange, const TTextArea & whereToChange, const TStyleKind & kind =TCharacterStyleRuns :: GetStyleKind ())
Interface Category:
API.
Purpose:
Calls the text representation's RemoveStyles function to remove the specified styles from the selected text in the representation. Called by HandleDoBegin when the command to remove the styles is executed.
Calling Context:
Called by the Text Framework classes. Typically not called directly by clients.
Parameters:
- MTextRepresentation * textToChange -The text representation for the text whose styles are to be removed.
- const TStyleSet & styleToChange -The styles to remove.
- const TTextArea & whereToChange -The selection of text whose styles are to be removed.
- const TStyleCategory & kind =TCharacterStyleRuns :: GetStyleKind() -The category of styles to be removed (default: character).
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
This command's functions assume that any required locks have already been acquired by the client.
Other Considerations:
This protected function overrides the inherited TChangeStylesCommand function.
Click the icon to mail questions or corrections about this material to Taligent personnel.
Copyright©1995 Taligent,Inc. All rights reserved.