Initializes the ribbon in a single call with XML.
Syntax
Send_Message(Ctrl, "OLE.Init", XmlData)
Parameters
Property | Description |
---|---|
XmlData | The XML snippet used to initialize this control. |
Remarks
The Init method is a fast and convenient way to initialize the ribbon. The ribbon consists of many elements in a hierarchical relationship--lots of parents and children. With such complexity, using lots of properties and methods to initialize the control is confusing and prone to error. XML provides a nice way to handle the complex relationships without sacrificing clarity.
To use this method, pass a string containing XML. It does not matter where the XML was originally stored. All that matters is that the one parameter you pass contains XML with one <Control> element. Each XML element is documented on the wiki, but you'll want to start with the <Control> element and work your way down.
NOTE: Do not call this method multiple times. It is designed to be called only once. If you need to add new elements, see the AddControls, AddGroups, and AddTabs methods.
Example
// Read the XML from a table and pass it to the Init method SetupXml = Xlate("SETUP", "MY_RIBBON_SETUP_XML", "", "X") Send_Message(@Window:".OLE_RIBBON", "OLE.Init", SetupXml)