Bookmark.Sort Method
Sorts the paragraphs in the Bookmark control.
Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)
Syntax
'Declaration
Sub Sort ( _
ByRef ExcludeHeader As Object, _
ByRef FieldNumber As Object, _
ByRef SortFieldType As Object, _
ByRef SortOrder As Object, _
ByRef FieldNumber2 As Object, _
ByRef SortFieldType2 As Object, _
ByRef SortOrder2 As Object, _
ByRef FieldNumber3 As Object, _
ByRef SortFieldType3 As Object, _
ByRef SortOrder3 As Object, _
ByRef SortColumn As Object, _
ByRef Separator As Object, _
ByRef CaseSensitive As Object, _
ByRef BidiSort As Object, _
ByRef IgnoreThe As Object, _
ByRef IgnoreKashida As Object, _
ByRef IgnoreDiacritics As Object, _
ByRef IgnoreHe As Object, _
ByRef LanguageID As Object _
)
void Sort(
ref Object ExcludeHeader,
ref Object FieldNumber,
ref Object SortFieldType,
ref Object SortOrder,
ref Object FieldNumber2,
ref Object SortFieldType2,
ref Object SortOrder2,
ref Object FieldNumber3,
ref Object SortFieldType3,
ref Object SortOrder3,
ref Object SortColumn,
ref Object Separator,
ref Object CaseSensitive,
ref Object BidiSort,
ref Object IgnoreThe,
ref Object IgnoreKashida,
ref Object IgnoreDiacritics,
ref Object IgnoreHe,
ref Object LanguageID
)
Parameters
- ExcludeHeader
Type: System.Object%
true to exclude the first row or paragraph header from the sort operation. The default value is false.
- FieldNumber
Type: System.Object%
The fields to sort by. Microsoft Office Word sorts by FieldNumber, then by FieldNumber2, and then by FieldNumber3.
- SortFieldType
Type: System.Object%
The respective sort types for FieldNumber, FieldNumber2, and FieldNumber3. Can be one of the WdSortFieldType constants.
- SortOrder
Type: System.Object%
The sorting order to use when sorting FieldNumber, FieldNumber2, and FieldNumber3. Can be one of the WdSortOrder constants.
- FieldNumber2
Type: System.Object%
The fields to sort by. Microsoft Office Word sorts by FieldNumber, then by FieldNumber2, and then by FieldNumber3.
- SortFieldType2
Type: System.Object%
The respective sort types for FieldNumber, FieldNumber2, and FieldNumber3. Can be one of the WdSortFieldType constants
- SortOrder2
Type: System.Object%
The sorting order to use when sorting FieldNumber, FieldNumber2, and FieldNumber3. Can be one of the WdSortOrder constants.
- FieldNumber3
Type: System.Object%
The fields to sort by. Microsoft Office Word sorts by FieldNumber, then by FieldNumber2, and then by FieldNumber3.
- SortFieldType3
Type: System.Object%
The respective sort types for FieldNumber, FieldNumber2, and FieldNumber3. Can be one of the WdSortFieldType constants
- SortOrder3
Type: System.Object%
The sorting order to use when sorting FieldNumber, FieldNumber2, and FieldNumber3. Can be one of the WdSortOrder constants.
- SortColumn
Type: System.Object%
true to sort only the column specified by the Bookmark control.
- Separator
Type: System.Object%
Object . The type of field separator. Can be one of the WdSortSeparator constants.
- CaseSensitive
Type: System.Object%
true to sort with case sensitivity. The default value is false.
- BidiSort
Type: System.Object%
true to sort based on right-to-left language rules. This argument might not be available to you, depending on the language support (U.S. English, for example) that you have selected or installed.
- IgnoreThe
Type: System.Object%
true to ignore the Arabic characters alef lam when sorting right-to-left language text. This argument might not be available to you, depending on the language support (U.S. English, for example) that you have selected or installed.
- IgnoreKashida
Type: System.Object%
true to ignore kashidas when sorting right-to-left language text. This argument might not be available to you, depending on the language support (U.S. English, for example) that you have selected or installed.
- IgnoreDiacritics
Type: System.Object%
true to ignore bidirectional control characters when sorting right-to-left language text. This argument might not be available to you, depending on the language support (U.S. English, for example) that you have selected or installed.
- IgnoreHe
Type: System.Object%
true to ignore the Hebrew character he when sorting right-to-left language text. This argument might not be available to you, depending on the language support (U.S. English, for example) that you have selected or installed.
- LanguageID
Type: System.Object%
Specifies the sorting language. Can be one of the WdLanguageID constants.
Remarks
Optional Parameters
For information on optional parameters, see Optional Parameters in Office Solutions.
Examples
The following code example adds a Bookmark control with a list of fruits and then sorts the list in ascending order.
This example is for a document-level customization.
Private Sub BookmarkSort()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
Bookmark1.Text = "Oranges" & vbLf & "Bananas" & vbLf & _
"Apples" & vbLf & "Pears"
Dim SortOrder As Object = Word.WdSortOrder.wdSortOrderAscending
Bookmark1.Sort(SortOrder:=Word.WdSortOrder.wdSortOrderAscending)
End Sub
private void BookmarkSort()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
Microsoft.Office.Tools.Word.Bookmark bookmark1 =
this.Controls.AddBookmark(this.Paragraphs[1].Range,
"bookmark1");
bookmark1.Text = "Oranges" + "\n" + "Bananas" + "\n" +
"Apples" + "\n" + "Pears";
object SortOrder = Word.WdSortOrder.wdSortOrderAscending;
bookmark1.Sort(ref missing, ref missing, ref missing,
ref SortOrder, ref missing, ref missing, ref missing,
ref missing, ref missing, ref missing, ref missing,
ref missing, ref missing, ref missing, ref missing,
ref missing, ref missing, ref missing, ref missing);
}
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.