NavigationFolder.Position Property (Outlook)
Returns or sets an Long value that represents the ordinal position of the NavigationFolder object when displayed in the Navigation Pane. Read/write.
Version Information
Version Added: Outlook 2007
Syntax
expression .Position
expression A variable that represents a NavigationFolder object.
Remarks
This property can only be set to a value between 1 and the value of the Count property for the parent NavigationFolders 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 NavigationFolder object changes the Position values of other navigation folders contained by a NavigationFolders collection, depending on the relative change between the new value and the original value of the Position property for that NavigationFolder object:
If the new value is less than the original value, then the specified NavigationFolder object moves up to the new position and pushes the other navigation folders already at or below that new position down.
If the new value is greater than the original value, then the specified NavigationFolder object moves down to the new position and pushes the other navigation folders between the old position and the new position up, filling the old position.
If the navigation folder has been removed from the Navigation Pane, then this property returns -1 to indicate that the navigation folder is no longer part of the navigation group.