NavigationGroup.Position Property
| Outlook Developer Reference |
Returns or sets an Long value that represents the ordinal position of the NavigationGroup object when displayed in the Navigation Pane. Read/write.
Version Information
Version Added: Outlook 2007
Syntax
expression.Position
expression A variable that represents a NavigationGroup object.
Remarks
This property can only be set to a value between 1 and the value of the Count property for the parent NavigationGroups object. An error occurs if you attempt to set this property to a value outside that range.
Changing the value of this property for a NavigationGroup object changes the Position values of other navigation groups contained by a NavigationGroups collection, depending on the relative change between the new value and the original value of the Position property for that NavigationGroup object:
- If the new value is less than the original value, then the specified NavigationGroup object moves up to the new position and pushes the other navigation groups already at or below that new position down.
- If the new value is greater than the original value, then the specified NavigationGroup object moves down to the new position and pushes the other navigation groups between the old position and the new position up, filling the old position.
If the navigation group is not on the Navigation Pane, then this property returns -1.
See Also