DocumentBase.ConvertNumbersToText Method

Article
07/25/2011

Changes the list numbers and LISTNUM fields in the specified document to text.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Syntax

'Declaration
Public Sub ConvertNumbersToText ( _
    ByRef numberType As Object _
)

public void ConvertNumbersToText(
    ref Object numberType
)

Parameters

numberType
Type: System.Object%
The type of number to be converted. Can be any of the following WdNumberType values: wdNumberParagraph, wdNumberListNum, or wdNumberAllNumbers.

Remarks

There are two types of numbers: preset numbers (wdNumberParagraph), which you can add to paragraphs by selecting a template in the Bullets and Numbering dialog box; and LISTNUM fields (wdNumberListNum), which enable you to add more than one number per paragraph.

The ConvertNumbersToText method is useful if you want to work with a document in another application and that application does not recognize list formatting or LISTNUM fields.

After you convert list numbers to text, you can no longer manipulate them in a list.

Optional Parameters

For information on optional parameters, see Optional Parameters in Office Solutions.

Examples

The following code example uses the ConvertNumbersToText method to convert all list numbers and LISTNUM fields in the document to text. To use this example, run it from the ThisDocument class in a document-level project.

Private Sub DocumentConvertNumbersToText()
    Me.ConvertNumbersToText(Word.WdNumberType.wdNumberAllNumbers)
End Sub

private void DocumentConvertNumbersToText()
{
    object numberType = Word.WdNumberType.wdNumberAllNumbers;
    this.ConvertNumbersToText(ref numberType);
}

.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.

Share via