OrderField Object (Outlook)
Represents an order field, used to sort information in a view.
Version Information
Version Added: Outlook 2007
Remarks
Use the Add method of the OrderFields object to add an Outlook item property to the SortFields collection for the following objects derived from the View object:
Use the ViewXMLSchemaName property to obtain the name of the order field as referenced in the XML definition of the view.
OrderField objects contained in an OrderFields collection are applied to Outlook items displayed in the view in the order in which the objects are contained in the collection. For each OrderField object, use the IsDescending property to determine whether to sort the contents of the order field in ascending or descending order.
Example
The following Visual Basic for Applications (VBA) example iterates through the SortFields collection of the current TableView object, displaying the label and XML schema names of each OrderField object in the collection.
Private Sub DisplayTableViewSortFields()
Dim objTableView As TableView
Dim objOrderField As OrderField
Dim strOutput As String
If Application.ActiveExplorer.CurrentView.ViewType = _
olTableView Then
' Obtain a TableView object reference for the
' current table view.
Set objTableView = _
Application.ActiveExplorer.CurrentView
' Iterate through the OrderFields collection for
' the table view, obtaining the label and the
' XML schema name for each field used to sort
' the items in the view.
For Each objOrderField In objTableView.SortFields
With objOrderField
strOutput = strOutput & .ColumnFormat.Label & _
" (" & .ViewXMLSchemaName & ")" & vbCrLf
End With
Next
' Display a dialog box containing the concatenated
' sort field information.
MsgBox strOutput
End If
End Sub