Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Expands this range so that any partial units it contains are completely contained.
Syntax
HRESULT Expand(
long Unit,
long *pDelta
);
Parameters
Unit
Type: long
Unit to include, if it is partially within the range. The default value is tomWord. For a list of the other Unit values, see the discussion under ITextRange.
pDelta
Type: long*
The count of characters added to the range. The value can be null.
Return value
Type: HRESULT
The method returns an HRESULT value. If the method succeeds, it returns S_OK. If the method fails, it returns one of the following error codes. For more information about COM error codes, see Error Handling in COM.
| Return code | Description |
|---|---|
|
Unit is not supported. |
|
Failure for some other reason. |
Remarks
For example, if an insertion point is at the beginning, the end, or within a word, ITextRange::Expand expands the range to include that word. If the range already includes one word and part of another, ITextRange::Expand expands the range to include both words. ITextRange::Expand expands the range to include the visible portion of the range's story.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | tom.h |
| DLL | Msftedit.dll |
See also
Conceptual
Reference