Tooltip for InsertTable and InsertForm

[Roger Withnell]

I would like to change the tooltip for InsertTable and InsertForm in the ToolsFile.xml.

<tool name="ForeColor" text="Font colour" />

works but

<tool name="InsertTable" text="Table manager" />

or

<EditorToolStrip name="InsertFormElement" text="Form manager" />

do not.

Your help would be much appreciated.

Thanking you in anticipation.

Roger

[Dobromir]

Hi Roger,

Tools like InsertTable and InsertFormElement are more complex tools, and by design they do not use the Text property. However, you can modify the tooltips of these tools using the following approach:

<telerik:RadEditor ID="RadEditor1" runat="server" OnClientLoad="OnClientLoad">
    <Tools>
        <telerik:EditorToolGroup>
            <telerik:EditorTool Name="InsertTable" Text="blah" ShowText="true" />
            <telerik:EditorTool Name="InsertFormElement" Text="blah" />
        </telerik:EditorToolGroup>
    </Tools>
</telerik:RadEditor>

<script type="text/javascript">
    function OnClientLoad(sender, args)
    {
        //get reference to the tool
        var insertTableTool = sender.getToolByName("InsertTable");
        var insertFormTool = sender.getToolByName("InsertFormElement");
        //set title attribute to modify the tooltip
        insertFormTool.get_element().setAttribute("title", "Form manager");
        insertTableTool.get_element().setAttribute("title", "Table manager");
    }
</script>

I hope this helps.

Kind regards,
Dobromir
the Telerik team

[Roger Withnell]

Thanks for your reply, Dobromir.

Your code works fine, but if I declare ToolbarMode="PageTop" in the RadEditor, I get the error:

'null' is null or not an object

at

insertFormTool.get_element().setAttribute(

"title", "Form manager");

 

Please advise.

Roger

[Dobromir]

Hi Roger,

The reported JavaScript error occurs because RadEditor's tools are not initialized during the OnClientLoad event whenToolbarMode is set to PageTop. For this specific scenario you can use the following code:

<script type="text/javascript">
    function OnClientLoad(sender, args)
    {
        var toolbarWnd = sender.get_toolAdapter().get_window();//get reference to the window containing the toolbar
        function setTitles ()
        {
            toolbarWnd.remove_show(setTitles);
            //get reference to the tool
            var insertTableTool = sender.getToolByName("InsertTable");
            var insertFormTool = sender.getToolByName("InsertFormElement");
            //set title attribute to modify the tooltip
            insertFormTool.get_element().setAttribute("title", "Form manager");
            insertTableTool.get_element().setAttribute("title", "Table manager");
        }
        toolbarWnd.add_show(setTitles);//add OnClientShow handler which will modify the tooltips
    }
</script>

Sincerely yours,
Dobromir
the Telerik team

[Roger Withnell]

Great, Dobromir, that works a treat.

On a related question, when I select an item from the InsertForms list, the InsertForms icon changes to the icon of the item that was last selected.

How do I stop this happening so that the InsertForms icon always displays?

Many thanks.

Roger

[Dobromir]

Hi Roger,

You can achieve the required functionality by calling the tool's client-side method set_updateHeader(false), e.g.:

<script type="text/javascript">
    function OnClientLoad(sender, args)
    {
        var toolbarWnd = sender.get_toolAdapter().get_window();//get reference to the window containing the toolbar
        function setTitles ()
        {
            toolbarWnd.remove_show(setTitles);
            //get reference to the tool
            var insertTableTool = sender.getToolByName("InsertTable");
            var insertFormTool = sender.getToolByName("InsertFormElement");
            //set title attribute to modify the tooltip
            insertFormTool.get_element().setAttribute("title", "Form manager");
            insertFormTool.set_updateHeader(false);
            insertTableTool.get_element().setAttribute("title", "Table manager");
        }
        toolbarWnd.add_show(setTitles);//add OnClientShow handler which will modify the tooltips
    }
</script>

Kind regards,
Dobromir
the Telerik team