ImportXML

PowerScript function

Description

Loads the RibbonBar content from an XML string. XML version 1.0 is
supported.

Applies to

RibbonBar controls

Syntax

controlname.ImportXML ( Data )

1	controlname.ImportXML ( Data )

Argument	Description
controlname	The name of the RibbonBar control.
Data	An XML string that contains the RibbonBar content.

Return value

Integer.

1 – Successful.

-1 – An internal error occurs.

-2 – The library fails to load.

-5 – Any of the following: 1) XML syntax error; 2) XML encode error;
3) XML data is null.

If any argument’s value is null, returns null.

Examples

This example loads an XML string to create the ribbon bar:

Integer li_return
string ls_xml

ls_xml = '&lt;?xml version="1.0" encoding="utf-8" standalone="yes"?&gt;&amp;
   &lt;RibbonBar Font="FaceName:Tahoma; TextSize:8" BuiltinTheme="0"&gt;&amp;
     &lt;RibbonItems&gt;&amp;
      &lt;Categories&gt;&amp;
       &lt;Category Text="MyCategory" Enabled="true" Visible="true"&gt;&amp;
        &lt;Panel Text="MyPanel" Enabled="true" Visible="true" PictureName="TabsSmall!"&gt;&amp;
         &lt;SmallButton Text="MySmallButton" Clicked="ue_ButtonClicked" PictureName="EmployeeSmall!"/&gt;&amp;
        &lt;/Panel&gt;&amp;
       &lt;/Category&gt;&amp;
      &lt;/Categories&gt;&amp;
     &lt;/RibbonItems&gt;&amp;
   &lt;/RibbonBar&gt;'

li_return = rbb_1.ImportXML(ls_xml)