op.promote
| Syntax |
op.promote ()
|
| Params |
None required.
|
| Action |
Moves all subheads beneath the currently selected heading to the left one level, promoting them in the outline hierarchy.
|
| Returns |
True unless the current heading has no subheads, in which case it returns false.
|
| Examples |
In examples.Sample Outline 2, place the cursor on "Subhead 1.1." Now execute: op.promote ()
Notice that subheadings 1.1.1, 1.1.1.1, and 1.1.1.1.1, all move to the left one position, with Subhead 1.1.1 now directly under Subhead 1.1. Undo this operation. |
| Errors |
An attempt to execute op.promote on a heading with no subheads produces a result of false, but it is not an error.
|
| See Also |
op.demote
|
