CuteEditor for .NET

How To Control the Context Menu in the CuteEditor?

Cute Editor is a context sensitive application, it is aware of it's context and acts accordingly. Many functions of CuteEditor are accessible via the context menus (accessible through a right-click menu in the content area). This section describes how to control the context menu behavior in a Cute Editor control.

There are many ways to control the context menu behaviors in a Cute Editor control:


1. Disable the default context menu.
2. Disable the default context menu of the browser
3. Load the different configuration file dynamically using Editor.ContextMenuMode property.
4. Disable the context menu group by modifying the context menu configuration files.
5. Change the available context menu items and the order of the items by editing context menu definition file.
6. Change the available context menu items and the order of the items by editing context menu definition file.

1. Disable the Default Context Menu

To turn off context menus, you can choose one of the following methods:

1. Using the Editor.EnableContextMenu Property to specify whether the context menu is enabled.

2. Edit context menu configuration files .

All the context menu configuration files can be found in the /CuteEditor/Configuration/ContextMenuMode folder. In the context menu configuration files, you can find the contextmenu element which contains the configuration information for the context menus within CuteEditor.

To turn off context menus, you need to disable all of the context menu groups.

Example:

  1. <?xml version="1.0" encoding="utf-8" ?>  
  2. <configuration>  
  3. <!--definition see shared/common.config-->  
  4.  <contextmenus>  
  5.   <ref name="Undo" />  
  6.   <spliter />  
  7.   <ref name="Cut" />  
  8.   <ref name="Copy" />  
  9.   <ref name="Paste" />  
  10.   <ref name="Delete" />  
  11.   <spliter />  
  12.   <ref name="SelectAll" />  
  13.   <ref name="EditGroup" />  
  14.   <ref name="FormattingGroup" />  
  15.   <ref name="InsertGroup" />  
  16.   <special type="tags"/>  
  17.   <special type="verbs"/>  
  18.   <special type="relative"/>  
  19.   <special type="style" />  
  20.   <special type="property" />  
  21.  </contextmenus>  
  22. </configuration>   


2. Disable the default context menu of the browser

To turn off context menus of the browser, you need to set Editor.EnableBrowserContextMenu Property to false.

Example:


<CE:Editor id="Editor1" EnableBrowserContextMenu="false" EnableContextMenu="false" runat="server"></CE:Editor>

3. Load the different configuration file dynamically using Editor.ContextMenuMode property.

Example:


<CE:Editor id="Editor1" ContextMenuMode="Simple" runat="server"></CE:Editor>

4. Disable the context menu group by modifying the context menu configuration files


For example, to disable edit group menu, you need to remove the following code:


<ref name="EditGroup" />

5. Modify the context menu definition file.

The context menu definition file (Common.config) can be found in the /CuteEditor/Configuration/Shared folder. The context menu definition influences the available context menu items and the order of the context menu items. You can easily customize the context menu to address your unique needs.

For example, to modify EditGroup menu, you need to change the following code:

  1. <define name="EditGroup" text="[[Edit]]">  
  2.   <subItems>  
  3.    <ref name="Undo" />  
  4.    <ref name="Redo" />  
  5.    <spliter />  
  6.    <ref name="SelectAll" />  
  7.    <ref name="PasteText" />  
  8.    <ref name="PasteWord" />  
  9.    <spliter />  
  10.    <ref name="ToggleBorder" />  
  11.    <ref name="FromFullPage" />  
  12.    <ref name="ToFullPage" />  
  13.   </subItems>  
  14.   <initializer>  
  15.   <![CDATA[
  16.   ]]>  
  17.   </initializer>  
  18. </define>   

© 2003 - 2012 CuteSoft.Net. All rights reserved.