Explore the Office Open XML document package
#INSTALL MICROSOFT WORD ADD IN FOR SGML HOW TO#
We'll also look at the code you need for inserting rich content into a document at the active selection and how to use Office Open XML with the bindings object to add or replace content at specified locations. We'll explore the markup for some types of content shown earlier along with the information you need for minimizing the Office Open XML payload. In this topic, you'll use some common scenarios we've been hearing from the Office Add-ins developer community to show you techniques for simplifying Office Open XML for use in your add-in. If you're one of the many add-in developers seeing Office Open XML markup for the first time, trying to make sense of the massive amount of markup you get for the simplest piece of content might seem overwhelming, but it doesn't have to be. The good news is that you probably don't need most of that markup. Yes, for many scenarios, you could use the full, flattened Office Open XML result you see with either of the preceding methods and it would work. So is that all there is to it? Well, not quite. Be sure to choose Word XML Document and not the Word 2003 option.ĭownload the code sample named Word-Add-in-Get-Set-EditOpen-XML, which you can use as a tool to retrieve and test your markup. If you save the file to an XML format from Word, note that there are two options under the Save as Type list in the Save As dialog box for. Saving the file in the Word XML Document format gives you the entire Office Open XML package flattened into one XML file, which is also what you get when using getSelectedDataAsync to retrieve the Office Open XML markup. Both approaches provide essentially the same result.Īn Office Open XML document is actually a compressed package of files that represent the document contents. Either add your rich content to an otherwise blank Word document and then save the file in Word XML Document format or use a test add-in with the getSelectedDataAsync method to grab the markup. There are two simple ways to get the Office Open XML markup you need. You can insert Excel charts as live charts in Word documents, which also means you can use them in your add-in for Word.Īs you can see by the preceding examples, you can use Office Open XML coercion to insert essentially any type of content that a user can insert into their own document. Office offers a wide array of SmartArt diagram layouts (and you can use Office Open XML to create your own). Use built-in or custom table styles just as easily as using a paragraph style for text. Include text formatting, borders, shading, cell sizing, or any table formatting you need.įigure 9. Insert built-in or custom drawing shapes, with or without text and formatting effects.
Text effects are available in Word for text inside a text box (as shown here) or for regular body text. Use content controls with your add-in to add content at a specified (bound) location rather than at the selection.įigure 6.
An image formatted using picture styles and effectsĪdding high quality formatting and effects to your images requires much less markup than you might expect. Use the same method for inserting any Office-supported image format.įigure 4. Use a style to automatically coordinate the look of text you insert with the user's document. Use direct formatting to specify exactly what the text will look like regardless of existing formatting in the user's document. Throughout this article, the terms content types and rich content refer to the types of rich content you can insert into a Word document. Determining the Office Open XML markup you need to get it done is easier than you might think.
dotx) are written, you can insert virtually any type of content that a user can add to a Word document, with virtually any type of formatting the user can apply. Depending on your scenario, there can be drawbacks to HTML coercion, such as limitations in the formatting and positioning options available to your content.īecause Office Open XML is the language in which Word documents (such as. If APIs aren't yet available, you can use HTML for inserting some types of rich content, such as pictures. For an example, see the Insert formatted text code snippet in Script lab on Word. So what are your options when you need to add rich content to a document, such as images, formatted tables, charts, or even just formatted text? Start with the APIs available through the WordApi requirement sets to see if they provide what you need. These are called coercion types, and they include plain text, tables, HTML, and Office Open XML. If you're building Office Add-ins to run in Word, you might already know that the Office JavaScript API (Office.js) offers several formats for reading and writing document content.
Provided by: Stephanie Krieger, Microsoft Corporation | Juan Balmori Labra, Microsoft Corporation
0 kommentar(er)
