Share via


_NavigationFolder.Position Property

Returns or sets an Integer value that represents the ordinal position of the NavigationFolder object when displayed in the Navigation Pane. Read/write.

Namespace:  Microsoft.Office.Interop.Outlook
Assembly:  Microsoft.Office.Interop.Outlook (in Microsoft.Office.Interop.Outlook.dll)

Syntax

'Declaration
<DispIdAttribute()> _
Property Position As Integer
    Get
    Set
'Usage
Dim instance As _NavigationFolder
Dim value As Integer

value = instance.Position

instance.Position = value
[DispIdAttribute()]
int Position { get; set; }

Property Value

Type: System.Int32

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.

See Also

Reference

_NavigationFolder Interface

_NavigationFolder Members

Microsoft.Office.Interop.Outlook Namespace