All docs
V21.1
21.2 (EAP/Beta)
21.1
20.2
20.1
The page you are viewing does not exist in version 20.1. This link will take you to the root page.
19.2
The page you are viewing does not exist in version 19.2. This link will take you to the root page.
19.1
The page you are viewing does not exist in version 19.1. This link will take you to the root page.
18.2
The page you are viewing does not exist in version 18.2. This link will take you to the root page.
18.1
The page you are viewing does not exist in version 18.1. This link will take you to the root page.
17.2
The page you are viewing does not exist in version 17.2. This link will take you to the root page.

Footnote and Endnote Dialog

  • 2 minutes to read

The Footnote and Endnote dialog allows users to specify the location, layout and format of footnotes or endnotes.

footnote and endnote dialog

Users can click Footnotes dialog box launcher on the References ribbon tab. Refer to the How to: Create a RichEditControl with a Ribbon UI topic for information on how to add ribbon UI to the RichEditControl.

invoke dialog

This dialog is also available from the context menu. Right-click the notes area and select Note Options.

invoke from context menu

In the invoked Footnote and Endnote dialog, click the Footnotes or Endnotes radio button.

The following API allows you to specify the Footnote and Endnote options in code:

Option Description API Member
Footnote Location Specifies the footnote position within the document. You can place footnotes at the bottom of the page or below text. FootnoteOptions.Position
Endnote Location Specifies the endnote position within the document. You can place endnotes at the end of the document or at the end of each section. Document.EndnotePosition
Footnote Layout Divides footnotes into columns. This property is ignored. You can set this option and save its value to a file for further processing in Microsoft Word or other word processing applications. FootnoteOptions.ColumnCount
Number Format Specifies how to format numbers in footnote or endnote references. FootnoteOptions.NumberingFormat
EndnoteOptions.NumberingFormat
Custom Mark Specifies the symbol used to mark a footnote or endnote reference. NoteCollection.Insert(DocumentPosition, String)
Start At Specifies the start number for a footnote or endnote reference. If you set the Numbering option to Restart each section or Restart each page, the Start At option value is ignored. FootnoteOptions.StartNumber
ReadOnlyEndnoteOptions.StartNumber
Numbering Specifies when reference numbering should be reset. If you set this option to Restart each section or Restart each page and then change the Start At option, the Numbering value is reset to Continuous. FootnoteOptions.RestartType
EndnoteOptions.RestartType

Convert Notes

The dialog’s Convert button invokes the Convert Notes dialog. This dialog allows users to convert footnotes to endnotes and vice versa, and swap footnotes with endnotes.

convert notes dialog

Call the Note.Convert method to convert a footnote to an endnote and vice versa in code. The NoteCollection.Convert method swaps the footnote collection with endnote collection.

Invoke the Dialog in Code

You can use ShowNotesFormCommand to invoke this dialog. You can handle the RichEditControl.NotesFormShowing event to perform actions before the Footnote and Endnote dialog is displayed, customize the default dialog (modify captions, set default dialog values, etc.) or substitute it with a new dialog.