DocumentBase.ConvertNumbersToText(Object) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Changes the list numbers and LISTNUM fields in the specified document to text.
public void ConvertNumbersToText (ref object numberType);
member this.ConvertNumbersToText : obj -> unit
Public Sub ConvertNumbersToText (Optional ByRef numberType As Object)
Parameters
- numberType
- Object
The type of number to be converted. Can be any of the following WdNumberType values: wdNumberParagraph, wdNumberListNum, or wdNumberAllNumbers.
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 void DocumentConvertNumbersToText()
{
object numberType = Word.WdNumberType.wdNumberAllNumbers;
this.ConvertNumbersToText(ref numberType);
}
Private Sub DocumentConvertNumbersToText()
Me.ConvertNumbersToText(Word.WdNumberType.wdNumberAllNumbers)
End Sub
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.