Fields.Add(Range, Object, Object, 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.
public Microsoft.Office.Interop.Word.Field Add (Microsoft.Office.Interop.Word.Range Range, ref object Type, ref object Text, ref object PreserveFormatting);abstract member Add : Microsoft.Office.Interop.Word.Range * obj * obj * obj -> Microsoft.Office.Interop.Word.FieldPublic Function Add (Range As Range, Optional ByRef Type As Object, Optional ByRef Text As Object, Optional ByRef PreserveFormatting As Object) As FieldParameters
- Range
- Range
Required Range object. The range where you want to add the field. If the range isn't collapsed, the field replaces the range.
- Type
- Object
Optional Object. Can be any WdFieldType constant. For a list of valid constants, consult the Object Browser. The default value is wdFieldEmpty.
- Text
- Object
Optional Object. Additional text needed for the field. For example, if you want to specify a switch for the field, you would add it here.
- PreserveFormatting
- Object
Optional Object. True to have the formatting that's applied to the field preserved during updates.
Returns
Remarks
This method returns the Field object at the specified range.
You cannot insert some fields (such as wdFieldOCX and wdFieldFormCheckBox) by using the Add method of the Fields collection. Instead, you must use specific methods such as the AddOLEControl(Object, Object, Object, Object, Object, Object) method and the Add method for the FormFields collection.