- Convert Word Doc To Onenote
- Adding Word Document To Onenote
- Import Word Doc To Onenote
- Onenote To Word Document
You can use Word, PowerPoint, and OneNote for the Web to convert your doc into a PDF. Select File Print Print (in PowerPoint you will select one of three formats). In the dropdown menu under Printer, select Save as PDF and then select Save. About Press Copyright Contact us Creators Advertise Developers Terms Privacy Policy & Safety How YouTube works Test new features Press Copyright Contact us Creators.
The Application interface includes methods help retrieve, manipulate, and update OneNote information and content. The methods are in four general categories:
Notebook structure – Methods for working with notebook structure, including those for discovering, opening, modifying, closing, and deleting notebooks, section groups, and sections.
Page content – Methods for working with pages and page content, including those for discovering, modifying, saving, and deleting page content. Page content includes binary objects, such as ink and images, and text objects, such as outlines.
Navigation – Methods for finding, linking to, and navigating to pages and objects.
Functional – All other methods that perform certain actions or set parameters in OneNote.
In addition, the Application interface includes a number of properties and events .
Notebook Structure methods
The methods described in this section enable you to discover, open, modify, close, and delete OneNote notebooks, section groups, and sections.
GetHierarchy method
| Description | Gets the notebook node hierarchy structure, starting from the node you specify (all notebooks or a single notebook, section group, or section), and extending downward to all descendants at the level you specify. |
| Syntax | HRESULT GetHierarchy([in]BSTR bstrStartNodeID,[in]HierarchyScope hsScope,[out]BSTR * pbstrHierarchyXmlOut,[in,defaultvalue(xs2013)]XMLSchema xsSchema); |
| Parameters | bstrStartNodeID – The node (notebook, section group, or section) whose descendants you want. If you pass a null string ('), the method gets all nodes below the root node (that is, all notebooks, section groups, and sections). If you specify a notebook, section group, or section node, the method gets only descendants of that node. hsScope – The lowest descendant node level you want. For example, if you specify pages, the method gets all nodes as far down as the page level. If you specify sections, the method gets only section nodes below the notebook. For more information, see the HierarchyScope enumeration in the Enumerations topic. pbstrHierarchyXmlOut – (Output parameter) A pointer to the string in which you want OneNote to write the XML output. xsSchema – (Optional) The version of the OneNote XML schema, of type XMLSchema, that you want to be output. You can specify whether you want XML Schema version 2013, 2010, 2007, or the current version. NOTE: We recommend specifying a version of OneNote (such as xs2013) instead of using xsCurrent or leaving it blank, because this will allow your add-in to work with future versions of OneNote. |
The GetHierarchy method returns a string in OneNote 2013 XML format by default or you can set the preferred XML schema version by using the optional xsSchema parameter.
Depending on the parameters you pass, the GetHierarchy method can return various lists (for example all notebooks, all sections in all notebooks, all pages within a given section, or all pages within a given notebook). For each node, the XML string returned provides properties (for example, the section or page title, ID, and last-modified time).
Not all combinations of start node and scope are valid. For example, if you specify a section start node and a notebook scope, GetHierarchy returns a null result because a notebook is higher in the node hierarchy than a section.
The following C# example shows how to use the GetHierarchy method to get the entire OneNote hierarchy, including all notebooks, down to the page level. It copies the output string to the Clipboard, from which you can paste the string into a text editor for review.
UpdateHierarchy method
| Description | Modifies or updates the hierarchy of notebooks. For example, you can add sections or section groups to a notebook, add a new notebook, move sections within a notebook, change the name of a section, add pages to a section, or change the order of pages within sections. |
| Syntax | HRESULT UpdateHierarchy([in]BSTR bstrChangesXmlIn,[in,defaultvalue(xsCurrent)] XMLSchema xsSchema); |
| Parameters | bstrChangesXmlIn – A string that contains OneNote XML code that specifies the hierarchy changes to make. For example, if you want to insert a new section, you can add a Section element in the XML string to indicate where you want the new section to be added. Alternatively, if you want to change the name of an existing section, you can keep the same section ID and change its name attribute in the XML code. xsSchema – (Optional) The OneNote schema version of the string bstrChangesXmln. This optional value is used to specify the version of the OneNote XML schema that the bstrChangesXmlIn string is in. If this value is not specified, OneNote will assume that the XML is in schema version xsCurrent. NOTE: We recommend specifying a version of OneNote (such as xs2013) instead of using xsCurrent or leaving it blank, because this will allow your add-in to work with future versions of OneNote. |
If you pass only a partial OneNote XML string for the bstrChangesXmlIn parameter, OneNote attempts to infer the changes you want. For example, if you include a Notebook element that contains only one section, OneNote adds the section after any existing sections. However, if the operation you specify is ambiguous, the result can be hard to determine. For example, if an existing notebook contains four sections, and the XML string you pass includes the notebook and only the fourth and first sections (in that order), OneNote might place the second and third sections before the fourth section or after the first section.
You cannot use the UpdateHierarchy method to delete part of a notebook. That is, passing an XML string that includes only part of an existing hierarchy does not delete sections that are not included in the string. To delete part of a hierarchy, use the DeleteHierarchy method.
The following C# code shows one way to use the UpdateHierarchy method to change the OneNote hierarchy, by changing the name of an existing section. It reads XML code from a sample file named ChangeSectionName.xml at the root of drive C, loads it into an XML document, and then passes the XML structure of that document to the method.
The following XML code is an excerpt of the ChangeSectionName.xml file that the previous C# code passes to the method. When the XML is passed to the UpdateHierarchy method, it changes the name of one of the sections in the existing hierarchy (by changing the value of the name attribute to 'My Renamed Section'). It then removes all the sections except the one whose name was changed. In addition, the code removes unnecessary attributes from the target Section element, including the lastModifiedTime, isCurrentlyViewed, and color attributes, leaving only the name, ID, and path attributes intact.
The preceding XML code was obtained by using the code shown in the example for the GetHierarchy method, which is modified, as follows, to limit the scope to sections.
The following C# example shows a complete console application that searches for a section named ' Sample_Section', prompts the user to input a new name for the section, and then uses the UpdateHierarchy method to change the section name to the name that the user typed. Before running the code, change ' Sample_Section' to the name of a section that exists in your OneNote hierarchy.
OpenHierarchy method
| Description | Opens a section group or section that you specify. |
| Syntax | HRESULT OpenHierarchy([in]BSTR bstrPath,[in]BSTR bstrRelativeToObjectID,[out]BSTR * pbstrObjectID,[in,defaultvalue(cftNone)]CreateFileType cftIfNotExist); |
| Parameters | bstrPath – The path that you want to open. For a notebook, or for a section group in a notebook, bstrPath can be a folder path or the path to an .one section file. If you specify the path to an .one section file, you must include the .one extension on the file-path string. bstrRelativeToObjectID – The OneNote ID of the parent object (notebook or section group) under which you want the new object to open. If the bstrPath parameter is an absolute path, you can pass an empty string (') for bstrRelativeToObjectID. Alternatively, you can pass the object ID of the notebook or section group that should contain the object (section or section group) that you want to create, and then specify the file name (for example, section1.one) of the object that you want to create under that parent object. pbstrObjectID – (Output parameter) The object ID that OneNote returns for the notebook, section group, or section that the OpenHierarchy method opens. This parameter is a pointer to the string into which you want the method to write the ID. cftlfNotExist – (Optional) An enumerated value from the CreateFileType enumeration. If you pass a value for cftIfNotExist, the OpenHierarchy method creates the section group or section file at the specified path only if the file does not already exist. |
If you specify a section group that is not in an open notebook, the OpenHierarchy method opens the section group as a notebook. If you specify a section that is not in an open notebook, the OpenHierarchy method opens the section in the Recent Opened Sections section group. If you specify a section group or section that is already in an open notebook, nothing happens because the section group or section is already open, as well. In any case, OpenHierarchy returns the object ID for the section group, notebook, or section that you specify, so that you can use it in other operations.
You can also use the OpenHierarchy method to create new sections, instead of doing so by importing XML.
The following code shows how to use the OpenHierarchy method to open the Meetings section in the Work notebook and get the ID for the section. If the section does not already exist, OneNote creates it in the location that you specify.
DeleteHierarchy method
| Description | Deletes any hierarchy object (a section group, section, or page) from the OneNote notebook hierarchy. |
| Syntax | HRESULT DeleteHierarchy([in]BSTR bstrObjectID,[in,defaultvalue(0)]DATE dateExpectedLastModified,[in,defaultvalue(false)]VARIANT_BOOL deletePermanently); |
| Parameters | bstrObjectID – The OneNote ID of the object you want to delete. The object can be a section group, section, or page. dateExpectedLastModified – (Optional) The date and time that you think the object you want to delete was last modified. If you pass a non-zero value for this parameter, OneNote proceeds with the update only if the value you pass matches the actual date and time the object was last modified. Passing a value for this parameter helps prevent accidentally overwriting edits users made since the last time the object was modified. deletePermanently – (Optional) true to permanently delete the content; false to move the content into the OneNote recycle bin for the corresponding Notebook (the default). If the Notebook is in OneNote 2007 format, no recycle bin exists, so the content is permanently deleted. |
CreateNewPage method
| Description | Adds a new page to the section you specify. The new page is added as the last page of the section |
| Syntax | HRESULT CreateNewPage([in]BSTR bstrSectionID,[out]BSTR * pbstrPageID);[in,defaultvalue(npsDefault)]NewPageStyle npsNewPageStyle); |
| Parameters | bstrSectionID – A string that contains the OneNote ID of the section in which you want to create the new page. pbstrPageID – (Output parameter) A pointer to the string into which the method writes the OneNote ID for the newly created page. npsNewPageStyle – A value from the NewPageStyle enumeration that specifies the style of the page to be created. |
The OneNote API includes the CreateNewPage method as a convenience. You can achieve the same result, with greater control over how the new page is positioned in the hierarchy, by calling the UpdateHierarchy method. The UpdateHierarchy method also lets you create subpages at the same time as you create a new page.
CloseNotebook method
| Description | Closes the specified notebook. |
| Syntax | HRESULT CloseNotebook([in]BSTR bstrNotebookID,[in,defaultvalue(false)]VARIANT_BOOL force); |
| Parameters | bstrNotebookID – The OneNote ID of the notebook you want to close. force – (Optional) true to close the notebook, even if there are changes in the notebook that OneNote cannot sync before closing; otherwise, false (the default). |
You can use the CloseNotebook method to close the notebook you specify. When you call this method, OneNote synchronizes any offline files with current notebook content, if necessary, and then closes the specified notebook. After the method returns, the notebook no longer appears in the list of open notebooks in the OneNote user interface (UI).
GetHierarchyParent method
| Description | Gets the OneNote ID for the parent object of a OneNote object. |
| Syntax | HRESULT GetHierarchyParent ([in]BSTR bstrObjectID,[out]BSTR * pbstrParentID); |
| Parameters | bstrObjectID – A string that contains the OneNote ID of the object of which you want to find the parent object. pbstrParentID – (Output parameter) A pointer to the string into which the method writes the OneNote ID of the parent object. |
If the OneNote object has no parent object (for example, when a user wants to get the parent of a Notebook), an exception is thrown.
GetSpecialLocation method
| Description | Finds the path to the location where OneNote stores certain special items, such as backups, unfiled notes, and the default notebook. |
| Syntax | HRESULT GetSpecialLocation([in]SpecialLocation slToGet,[out]BSTR * pbstrSpecialLocationPath); |
| Parameters | slToGet – One of the SpecialLocation enumeration values that specifies the special folder location to get. pbstrSpecialLocationPath – (Output parameter) A pointer to the string into which you want OneNote to write the path of the special folder. |
You can use this method to determine the location on disk of the Unfiled Notes folder. That is the folder in which OneNote stores notes that are created when you drag an item into OneNote, as well as notes that come directly from other applications (such as those that result when you click Send to OneNote in Microsoft Outlook or Microsoft Internet Explorer).
Page Content methods
The methods described in this section enable you to discover, update, and delete the content on pages in OneNote notebooks, as well as to publish OneNote content.
GetPageContent method
| Description | Gets all of the content (in OneNote XML format) of the specified page. |
| Syntax | HRESULT GetPageContent([in]BSTR bstrPageID,[out]BSTR * pbstrPageXmlOut,[in,defaultvalue(piBasic)]PageInfo pageInfoToExport,[in,defaultvalue(xsCurrent)]XMLSchema xsSchema); |
| Parameters | bstrPageId – The OneNote ID of the page whose content you want to get. pbstrPageXmlOut – (Output parameter) A pointer to the string into which you want OneNote to write the XML output. pageInfoToExport – (Optional) Specifies whether the GetPageContent method returns binary content, embedded in the XML code and base-64 encoded. Binary content can include, for example, images and ink data. The pageInfoToExport parameter also specifies whether to mark up the selection in the XML code that the GetPageContent method returns. It takes an enumerated value from the PageInfo enumeration. xsSchema – (Optional) The version of the OneNote XML schema, of type XMLSchema, that you want to be output. You can specify whether you want XML Schema version 2013, 2010, 2007, or the current version. NOTE: We recommend specifying a version of OneNote (such as xs2013) instead of using xsCurrent or leaving it blank, because this will allow your add-in to work with future versions of OneNote. |
By default, to avoid excess length in the XML string it returns, OneNote does not embed binary content in the XML code. For the same reason, it does not mark up the current selection with selection attributes. Binary objects include a OneNote ID in their tags. To get a binary object, you call the GetBinaryPageContent method and pass it the OneNote ID you get from the GetPageContent method. You use the GetPageContent method when you do not need the binary data immediately.
UpdatePageContent method
| Description | Updates or modifies the content on the page. |
| Syntax | HRESULT UpdatePageContent([in]BSTR bstrPageChangesXmlIn,[in,defaultvalue(0)]DATE dateExpectedLastModified,[in,defaultvalue(xsCurrent)]XMLSchema xsSchema,[in,defaultvalue(false)]VARIANT_BOOL force); |
| Parameters | bstrPageChangesXmlIn – A string that contains OneNote XML code that includes the changes you want to make to the page. dateExpectedLastModified – (Optional) The date and time that you think the page you want to update was last modified. If you pass a non-zero value for this parameter, OneNote proceeds with the update only if the value you pass matches the actual date and time the page was last modified. Passing a value for this parameter helps prevent accidentally overwriting edits users made since the last time the page was modified. xsSchema – (Optional) The version of the OneNote XML schema, of type XMLSchema, that you want to be output. You can specify whether you want XML schema version 2013, 2010, 2007, or the current version. NOTE: We recommend specifying a version of OneNote (such as xs2013) instead of using xsCurrent or leaving it blank, because this will allow your add-in to work with future versions of OneNote. force(Optional) true to update the page content, even if there is unknown data on the page from a future version of OneNote; otherwise, false (the default). |
You can use this method to modify the page in various ways. For example, you can use the UpdatePageContent method to add an outline to a page, change the content of an outline, add images, add ink, move content, or modify text in outlines.
As a more specific example, you might use the GetPageContent method to export an existing page, make some changes to the XML code for the page, and then use the UpdatePageContent method to import the entire page again. Or, you might use this method to add new page objects, such as images, to the bottom of an existing page.
The only objects that you must include in the XML code that you pass to the UpdatePageContent method are page-level objects (such as outlines, images on the page, or ink on the page) that have changed. This method does not modify or remove page-level objects that you do not specify in the bstrPageChangesXmlIn parameter. The method entirely replaces page-level objects, such as outlines, whose IDs match those of the objects you pass. Consequently, you must fully specify all page-level objects in your code, including their existing content and changes you want to make to them.
For example, if your page contains an outline and a background page image, you can replace the outline and leave the image unchanged by completely specifying the outline in the XML code, using the ID of the existing outline, and not including the image in the code. Because the revised outline you include in the code completely replaces the existing outline, you must include the entire contents of the outline.
Also, the UpdatePageContent method modifies only element properties that you specify in the bstrPageChangesXmlIn parameter. For example, if you specify some, but not all, properties of the PageSettings element, the properties that you do not specify remain unchanged.
The following example shows how to use the UpdatePageContent method to change the title of a page and add some sample text to the page. Before running the code, substitute a valid page ID for the page ID shown in the code, so that the code works on your computer. You can get the page ID for a page by using the GetHierarchy method and examining the output.
GetBinaryPageContent method
| Description | Returns a binary object, such as ink or images, on an OneNote page as a base-64-encoded string. |
| Syntax | HRESULT GetBinaryPageContent([in]BSTR bstrPageID,[in]BSTR bstrCallbackID,[out]BSTR * pbstrBinaryObjectB64Out); |
| Parameters | bstrPageID – The OneNote ID of the page that contains the binary object to get. bstrCallBackID – The OneNote ID of the binary object you want to get. This ID, known as a callbackID, is in the OneNote XML code for a page returned by the GetPageContent method. pbstrBinaryObectB64Out – (Output parameter) A pointer to a string into which OneNote writes the binary object as a base-64-encoded string. |
DeletePageContent method
| Description | Deletes an object – such as an Outline, Ink, or Image object from a page. |
| Syntax | HRESULT DeletePageContent([in]BSTR bstrPageID,[in]BSTR bstrObjectID,[in,defaultvalue(0)]DATE dateExpectedLastModified,[in,defaultvalue(#)]VARIANT_BOOL force); |
| Parameters | bstrPageID – The OneNote ID of the page that contains the object to delete. bstrObjectID – The OneNote ID of the object that you want to delete. dateExpectedLastModified – (Optional) The date and time that you think the page that contains content you want to delete was last modified. If you pass a non-zero value for this parameter, OneNote proceeds with the deletion only if the value you pass matches the actual date and time the page was last modified. Passing a value for this parameter helps prevent accidentally overwriting edits made by users since the last time the page was modified. force – (Optional) true to update the page content, even if there is unknown data on the page from a future version of OneNote; otherwise, false (the default). |
Publish method
| Description | Exports the page you specify to a file in any format that OneNote supports. |
| Syntax | HRESULT Publish([in]BSTR bstrHierarchyID,[in]BSTR bstrTargetFilePath,[in,defaultvalue(pfOneNote)]PublishFormat pfPublishFormat,[in,defaultvalue(0)]BSTR bstrCLSIDofExporter); |
| Parameters | bstrHierarchyID – The OneNote ID of the hierarchy you want to export. bstrTargetFilePath – The absolute path to the location where you want to save the resulting output file. The file you specify must be one that does not already exist at that location. pfPublishFormat – One of the PublishFormat enumeration values that specifies the format in which you want the published page to be (for example, MTHML, PDF, and so on). bstrCLSIDofExporter – The class ID (CLSID) of a registered COM application that can export Microsoft Windows enhanced metafiles (.emf). The COM application must implement the IMsoDocExporter interface. This parameter is included to permit third-party developers to write their own code to publish OneNote content in a custom format. For more information about the IMsoDocExporter interface, see Extending the Office 2007 Fixed-Format Export Feature. |
Currently, OneNote supports the following file formats:
- MHTML files (.mht)
- Adobe Acrobat PDF files (.pdf)
- XML Paper Specification (XPS) files (.xps)
- OneNote 2013, 2010 or 2007 files (.one)
- OneNote Package files (.onepkg)
- Microsoft Word documents (.doc or .docx)
- Microsoft Windows Enhanced Metafiles (.emf)
- HTML files (.html)
This method produces exactly the same results you would get by clicking Publish in the UI and specifying the format.
Navigation methods
The methods described in this section enable you to find, navigate to, and link to OneNote notebooks, section groups, sections, pages, and page objects.
NavigateTo method
| Description | Navigates to the specified object (for example, sections, pages, and Outline elements within pages). |
| Syntax | HRESULT NavigateTo([in]BSTR bstrHierarchyObjectID,[in,defaultvalue(#)]BSTR bstrObjectID,[in,defaultvalue(0)]VARIANT_BOOL fNewWindow); |
| Parameters | bstrHierarchyObjectID – The OneNote ID of the object you want to navigate to in the OneNote Hierarchy. bstrObjectID – The OneNote ID of the object you want to navigate to on the OneNote page. fNewWindow – (Optional) true to open specified object in a new OneNote window. false does not open a new OneNote window if one is open. |
NavigateToUrl method
| Description | If passed a OneNote link (onenote://), opens the OneNote window to the corresponding location in OneNote. If the link is external to OneNote (such as https:// or file://), a security dialog box will appear. Upon dismissal, OneNote attempts to open the link and an HResult.hrObjectDoesNotExist error is returned. |
| Syntax | HRESULT NavigateTo([in]BSTR bstrUrl,[in,defaultvalue(0)]VARIANT_BOOL fNewWindow); |
| Parameters | bstrUrl – A string that indicates where to navigate to. This could be a OneNote link, or any other URL, such as a web link or network location. fNewWindow – (Optional) true to open the specified URL in a new OneNote window. false does not open a new OneNote window if one is open. |
GetHyperLinkToObject method
| Description | Gets a OneNote hyperlink to the specified notebook, section group, section, page, or page object. |
| Syntax | HRESULT GetHyperlinkToObject([in] BSTR bstrHierarchyID,[in] BSTR bstrPageContentObjectID,[out] BSTR * pbstrHyperlinkOut); |
| Parameters | bstrHierarchyID – The OneNote ID for the notebook, section group, section, or page for which you want a hyperlink. bstrPageContentObjectID – (Optional) The OneNote ID for the object within the page for which you want a hyperlink. For example, the object can be an outline or Outline element. If you pass an empty string ('), the returned link points to the notebook, section group, section, or page that you specified in the bstrHierarchyID parameter. If you pass a non-empty string for the bstrPageContentObjectID parameter, the bstrHierarchyID parameter must be a reference to the page that contains the specified object. pbstrHyperlinkOut – (Output parameter) A pointer to a string into which the GetHyperlinkToObject method writes the output hyperlink text. |
When you attempt to navigate to the resulting link, OneNote opens and displays the specified object in the browser.
GetWebHyperlinktoObject method
| Description | Returns a hyperlink to an object that opens in the OneNote Web Client. |
| Syntax | HRESULT GetWebHyperlinkToObject ([in] BSTR bstrHierarchyID,[in] BSTR bstrPageContentObjectID,[out] BSTR * pbstrHyperlinkOut); |
| Parameters | bstrHierarchyID – The OneNote ID for the notebook, section group, section or page for which you want a web hyperlink. bstrPageContentObjectID – (Optional) The OneNote ID for the object within the page for which you want a hyperlink. For example, the object can be an outline or Outline element. If you pass an empty string ('), the returned link points to the notebook, section group, section, or page that you specified in the bstrHierarchyID parameter. If you pass a non-empty string for the bstrPageContentObjectID parameter, the bstrHierarchyID parameter must be a reference to the page that contains the specified object. pbstrHyperlinkOut – (Output parameter) A pointer to a string into which the GetWebHyperlinkToObject method writes the output hyperlink text. If a web hyperlink cannot be created for the notebook, a null value is returned. |
FindPages method
| Description | Returns a list of pages that match the specified query term. |
| Syntax | HRESULT FindPages([in]BSTR bstrStartNodeID,[in]BSTR bstrSearchBSTR,[out]BSTR * pbstrHierarchyXmlOut,[in,defaultvalue(#)]VARIANT_BOOL fIncludeUnindexedPages,[in,defaultvalue(0)]VARIANT_BOOL fDisplay,[in,defaultvalue(#)]XMLSchema xsSchema); |
| Parameters | bstrStartNodeID – The node (root, notebook, section group, or section) below which to search for content. This parameter sets the scope for the search. bstrSearchString – The search string. Pass exactly the same string that you would type into the search box in the OneNote UI. You can use bitwise operators, such as AND and OR, which must be all uppercase. pbstrHierarchyXmlOut – (Output parameter) A pointer to a string into which you want OneNote to write the output XML string. The resulting XML string contains the notebook hierarchy from the root downward to, and including, any pages that match the search string. For example, the FindPages method does not list sections that have no page matches in the hierarchy. Also, if only one page in a single section matches the string, the returned hierarchy includes the path to that section and page, but to no other parts of the notebook hierarchy. fIncludeUnindexedPages – (Optional) true to search pages that have not been indexed by Windows Search; otherwise, false. fDisplay – (Optional) true to also run the search in the UI for the user, just as if the user had typed it themselves. false to perform the query with no change to the UI (the default). xsSchema – (Optional) The OneNote schema version of the string pbstrHierarchyXmlOut. This optional value is used to specify the version of the OneNote XML schema that contains the pbstrHierarchyXmlOut string. If this value is not specified, OneNote will assume that the XML is in schema version xsCurrent. NOTE: We recommend specifying a version of OneNote (such as xs2013) instead of using xsCurrent or leaving it blank, because this will allow your add-in to work with future versions of OneNote. |
FindPages works only if you have Microsoft Search 3.0 or 4.0 installed on your computer. Windows Vista and Windows 7 include this component. However, if you are running an earlier version of Windows, you must install Windows Search for FindPages to work.
FindMeta method
| Description | Returns a list of OneNote objects that contain metadata that matches the specified query term. |
| Syntax | HRESULT FindMeta ([in]BSTR bstrStartNodeID,[in]BSTR bstrSearchBSTRName,[out]BSTR * pbstrHierarchyXmlOut,[in,defaultvalue(#)]VARIANT_BOOL fIncludeUnindexedPages,[in,defaultvalue(#)]XMLSchema xsSchema); |
| Parameters | bstrStartNodeID – The node (root, notebook, section group, or section) below which to search for content. This parameter sets the scope for the search. bstrSearchStringName – The search string. Pass in any part of the metadata name. If you pass in an empty string or a null value, all objects that have metadata will match the query. pbstrHierarchyXmlOut – (Output parameter) A pointer to a string into which you want OneNote to write the output XML string. The resulting XML string contains the notebook hierarchy from the root downward to, and including, any pages that match the search string. For example, the FindPages method does not list sections that have no page matches in the hierarchy. Also, if only one page in a single section matches the string, the returned hierarchy includes the path to that section and page, but to no other parts of the notebook hierarchy. fIncludeUnindexedPages – (Optional) true to search pages that have not been indexed by Windows Search; otherwise, false. xsSchema – (Optional) The OneNote schema version of the string pbstrHierarchyXmlOut. This optional value is used to specify the version of the OneNote XML schema that contains the pbstrHierarchyXmlOut string. If this value is not specified, OneNote will assume that the XML is in schema version xsCurrent. NOTE: We recommend specifying a version of OneNote (such as xs2013) instead of using xsCurrent or leaving it blank, because this will allow your add-in to work with future versions of OneNote. |
FindMeta works only if you have Microsoft Windows Search 3.0 or 4.0 installed on your computer. Windows Vista and Windows 7 include this component. However, if you are running an earlier version of Windows, you must install Windows Search for FindMeta to work.
Functional methods
The methods described in this section enable you to perform certain actions or set parameters within the OneNote application.
MergeFiles method
| Description | Allows users to merge changes for the same file into one. For the files to be considered the same, they must have the same OneNote ID. |
| Syntax | HRESULT MergeFiles ([in]BSTR bstrBaseFile,[in]BSTR bstrClientFile,[in]BSTR bstrServerFile,[in]BSTR bstrTargetFile); |
| Parameters | bstrBaseFile – The path string to the .one file location of the initial state of the file. bstrClientFile – The path string to the .one file location of the second set of changes to be merged with the base file after the server file changes are merged with the base. bstrServerFile – The path string to the .one file location of the first set of changes to be merged with the base file. bstrTargetFile – The path string to the .one file location of the file with the merged changes. |
The MergeFiles method was intended for mobile scenarios in which multiple versions of an OneNote file may exist.
MergeSections method
| Description | Merges the content of one section into another in OneNote. |
| Syntax | HRESULT MergeSections ([in]BSTR bstrSectionSourceId,[in]BSTR bstrSectionDestinationId); |
| Parameters | bstrSectionSourceId – The OneNote ID of the section to be merged. bstrSectionDestinationId – The OneNote ID of the section to be merged into. The source section will be merged into this destination section. |
This method performs the same operation as the Merge into Another Section feature that is visible when you right-click a section.
QuickFiling method
| Description | Returns an instance of the IQuickFilingDialog dialog box, which can be used to select a location within the OneNote hierarchy tree. |
| Syntax | HRESULT QuickFiling ( ); |
SyncHierarchy method
| Description | Forces OneNote to sync the specified object with the source file on disk. |
| Syntax | HRESULT SyncHierarchy ([in]BSTR bstrHierarchyID); |
| Parameters | bstrHierarchyID – The OneNote ID of the object to be synced. |
SetFilingLocation method
| Description | Allows users to specify where and how certain types of content should be filed in OneNote. |
| Syntax | HRESULT SetFilingLocation ([in]FilingLocation flToSet,[in]FilingLocationType fltToSet,[in]BSTR bstrFilingSectionID); |
| Parameters | flToSet – The object type of the filing location to set. fltToSet – The location in which to file the type. bstrFilingSectionID – The OneNote ID of the section or page at which location you want to set. If not applicable, the user can pass in null or an empty string. |
The types of content that can be filed include Outlook items and Web Notes from Internet Explorer that are imported to OneNote through the Send to OneNote command in each application. The filing location of items that are printed into OneNote can also be set with this method.
Properties
This section describes the properties of the Application interface.
| Property | Description |
|---|---|
| Windows | Gives users access to opened OneNote windows. This property allows users to enumerate through the set of OneNote windows and modify certain window properties. For more information, see Windows Interfaces. |
| COMAddIns | Returns the COMAddIns collection for OneNote. This collection contains all of the COM add-ins that are available to OneNote. The Count property of the COMAddins collection returns the number of available COM add-ins. For more information, see the COMAddIns object. |
| LanguageSettings | Enables you to access some APIs to change the common language settings of OneNote. |
Events
This section describes the events of the Application interface.
Caution
Events cannot currently be added in managed code.
OnNavigate event
| Description | Allows a user to assign a function to be called when the OneNote UI is navigated away from the current OneNote location. |
| Syntax | Event OnNavigate ( ); |
OnHierarchyChange method
| Description | Allows a user to assign a function to be called any time the OneNote hierarchy changes (for example, adding or deleting pages, or moving sections). Hierarchy changes are batched, so if multiple changes occur at or near the same time, OneNote raises the event once. |
| Syntax | Event OnHierarchyChange ( BSTR bstrActivePageID); |
| Parameters | bstrActivePageID – Passes the OneNote ID of the active page. |
See also
-->Use OneNote for the web (formerly OneNote Web App) to take notes online in a OneNote notebook that you can add to from anywhere and easily share with others. All customers can view and lightly edit Office files using Office for the web.
Advanced collaboration: New content shows as unread, presence
Not available in OneNote for the web. With the OneNote desktop app, you can identify and authenticate other authors more easily with the integrated profiles in OneNote. Search for notebook changes and revisions by authors' names and view all recent edits when you return to a shared notebook.
Apply tags
With OneNote for the web, you can apply a variety of tags to notes for easy organization and follow-up. For example, flagging notes as questions, to-do items, or contact information. Learn more about the differences between using a notebook in the browser and in OneNote desktop app.
Office add-ins
OneNote for the web only supports content add-ins for Office. Content add-ins integrate web-based features as content that can be shows in line with a document. Learn more about types of add-ins for Office.
Audio notes recording
Not available in OneNote for the web. With the OneNote desktop app, you can record audio and video notes that are directly linked to any text notes you take while the recording is made. OneNote for the web does not play audio and video content, but the media is preserved in the notebook, and you can download audio and video files to your computer to play them.
Bullets and numbering
With OneNote for the web, you can apply a choice of three bullet styles or five numbering styles. Use the Increase Indent and Decrease Indent buttons to change the list level for existing bulleted and numbered lists in a notebook, as well as those created in OneNote for the web. Learn more about the differences between using a notebook in the browser and in OneNote desktop app.
Clipboard
With OneNote for the web, you can cut, copy, and paste content in a notebook. You can copy and paste text between OneNote for the web and OneNote desktop app. Learn more about the differences between using a notebook in the browser and in OneNote desktop app.
Clipping experiences
Not available in OneNote for the web. With the OneNote desktop app, you can clip whatever you're seeing on your screen, send a web page or an entire document to a notebook section, or to jot down Quick Notes that are automatically saved and filed as part of your notebook.
Co-authoring
Convert Word Doc To Onenote
With OneNote for the web, you can simultaneously edit notebooks with people in other locations who are using either OneNote for the web or OneNote desktop app. Learn more about working together on a OneNote notebook.
Create and manage pages and sections
With OneNote for the web, you can easily add to new or existing notebooks by creating new pages in sections, or new sections in notebooks. Pages and sections can be customized, formatted, and moved or copied between notebooks. Learn more about using a OneNote for the web notebook.
Download copy of embedded Office files
With OneNote for the web, you can insert Office files as attachments or printouts to store them as part of the notebook. OneNote 2013 desktop app adds the ability to embed Excel spreadsheets and Visio drawings in your notes. Learn more about embedding Microsoft Office files in OneNote.
Dropbox
Dropbox is a file hosting service that offers cloud storage, file synchronization, personal cloud, and client software.
Edit embedded files
With OneNote for the web, you can download embedded filed to your computer to open them. With the OneNote desktop app, you can attach just about any computer file to any part of your notes, which stores a copy of the file in your notebook. You can even insert Outlook meeting details and Outlook tasks into OneNote or email a OneNote page to Outlook. You can also create or import Excel spreadsheets and Visio diagrams right within OneNote and edit their information in place in your notes. Inserted files show up as icons on your notes page. Double-click any icon to open its file.
Equations
Not available in OneNote for the web. With the OneNote desktop app, you can jot down math equations during a meeting, conference or class, and OneNote can instantly calculate the results for you.
Hyperlinks
With OneNote for the web, you can insert a hyperlink to a web address or apply a link to selected text. You can also right-click a page tab to copy a direct link to that page. Learn more about the differences between using a notebook in the browser and in OneNote desktop app.
Image optical character recognition (OCR)
Not available in OneNote for the web. Optical character recognition (OCR) translates images of text, such as scanned documents, into actual text characters is only available in the OneNote desktop app.
Ink viewing
In OneDrive, OneNote for the web displays ink, but equations are displayed as placeholders. In SharePoint, ink is viewable, equations are displayed as placeholders, and shapes are hidden. These can't be inserted or edited in OneNote for the web. In OneDrive you can select and delete shapes, ink, and equation placeholders. In SharePoint, you can select and delete placeholders for these objects.
Inking: ink-to-text and math, customizable pens, drawing tools
Not available in OneNote for the web. With the OneNote desktop app, you can smoothly draw, erase, and edit with your finger, stylus, or mouse. If you'd rather write than type, OneNote can convert your handwriting. If you open a notebook from a SharePoint document library, any equations and ink in the notebook will display as placeholders.
Linked notes
The ability to link note-taking to files is not available in OneNote for the web, and links to files are hidden. However, they are preserved in the notes so that you can open them with the OneNote desktop app.
Navigation
With OneNote for the web, you can use the Back and Forward browser-style buttons on the Quick Access toolbar to quickly jump between pages.
Notebook management: Cross section/notebook page filing, section re-order, create/delete section groups
With OneNote for the web, you can drag and drop to reorder pages and sections.
Advanced management features, such as creating, deleting and re-ordering section groups are only available in the OneNote desktop app.
Offline viewing and authoring
Not available in OneNote for the web. Office for the web requires an internet connection and a web browser. You need the OneNote desktop app installed on your computer to view and edit a document while disconnected from Office Web Apps Server or the internet.
Outlook integration (tasks)
OneNote for the web does not support commands that work with Microsoft Outlook, such as Email page, Outlook tasks, or meeting details.
Paragraph formatting
With OneNote for the web, you can change paragraph alignment, increase or decrease the indent from left margin, or change text direction from left to right. Learn more about the differences between using a notebook in the browser and in OneNote desktop app.
Pictures
With OneNote for the web, you can insert a picture from a file or from Bing Images. You can also resize pictures and add alternative text. For more advanced picture features, such as screen clipping, scanned images, or online pictures, you'll need to use the OneNote desktop app. Learn more about the differences between using a notebook in the browser and in OneNote desktop app.
You can print notes in OneNote for the web.
Proofing tools
OneNote for the web automatically checks spelling as users type and applies a wavy red underline to misspelled text. Common AutoCorrect actions are included, such as correcting routing misspellings or converting characters to symbols. Additionally, you can set the proofing language or turn off the spelling checker for selected text. Learn more about the differences between using a notebook in the browser and in OneNote desktop app.
Rights Management: Apply and consume IRM and password protection
OneNote for the web displays notebooks that are protected with Information Rights Management (IRM). However, these notebooks cannot be edited in the browser, and you cannot create IRM-protected notebooks in OneNote for the web. OneNote for the web can't open documents that are encrypted with a password. Advanced document protection features, such as creating IRM-protected notebooks and applying password-protection, are only available in the OneNote desktop app.
Search (on page, within sections)
With OneNote for the web, you can use Instant Search to recall anything you've ever created or saved in OneNote. Learn more about the differences between using a notebook in the browser and in OneNote desktop app.
Search by: tag, title, author/date, audio notes
Not available in OneNote for the web. Advanced search features, such as searching by tag, title, by author/date, and audio file, are only available in the OneNote desktop app.
Share
Adding Word Document To Onenote
If you've saved your OneNote notebook in a SharePoint document library, then your OneNote notebook is online. That means you can share it by sending a link instead of an email attachment. By selecting the link, people can read your notes in their web browser. Learn more about sharing OneNote notes online.
Show or hide authors
With OneNote for the web, you can turn off the author tags that appear when someone edits a notebook. This will remove the initials that appear next to new notes on a page. Author tags are turned on by default.
Styles
With OneNote for the web, you can easily apply text styles for quick formatting. Learn more about the differences between using a notebook in the browser and in the OneNote desktop app.
Tables
With OneNote for the web, you can insert a table, edit table text, and easily edit basic table structure, such as adding or deleting rows and columns. For more advanced table features, such as converting a table to an Excel spreadsheet or cell shading, header rows, and data sorting within table cells, you'll need to use the OneNote desktop app. Learn more about the differences between using a notebook in the browser and in OneNote desktop app.
Template support
Not available in OneNote for the web. With the OneNote desktop app, you can use a template as a page design that can be applied to new pages in your notebook to give them an appealing background, a more uniform appearance, or a consistent layout.
Undo and redo
Using your keyboard, you can undo (Ctrl+ Z) or redo (Alt + F7) recent actions for each page that is edited in the active notebook in OneNote for the web. OneNote for the web gives you a separate undo history for each page edited in the active notebook. You can undo an infinite number of actions per page during the current editing session—until either a picture is inserted or an edit is received from another author. Moving and deleting pages cannot be undone. Learn more about OneNote for the web keyboard shortcuts.
Video playback
Video notes are preserved in notes, but cannot be recorded in OneNote for the web. You can download video files to your computer to play them. Learn more about the differences between using a notebook in the browser and in OneNote desktop app.
View previous page versions
Import Word Doc To Onenote
With OneNote for the web, you can view and restore previous page versions of a page, including who wrote it and when. Changes relative to previous versions of a page are automatically highlighted. Learn more about the differences between using a notebook in the browser and in OneNote desktop app.
Feature availability
Onenote To Word Document
To view feature availability across plans, standalone options, and on-premises solutions, see Office for the web service description.