Ticket #4355: 4355.patch

_source/plugins/maximize/plugin.js

@@ -111 +111 @@
                         editor.addCommand( 'maximize',
                                 {
                                         modes : { wysiwyg : 1, source : 1 },
-
+                                        editorFocus : false,
                                         exec : function()
                                         {
                                                 var container = editor.container.getChild( [ 0, 0 ] );

_source/plugins/scayt/plugin.js

@@ -250 +250 @@
         var commandDefinition =
         {
                 preserveState : true,
+                editorFocus : false,
 
                 exec: function( editor )
                 {

_source/plugins/showblocks/plugin.js

@@ -89 +89 @@
         var commandDefinition =
         {
                 preserveState : true,
+                editorFocus : false,
 
                 exec : function ( editor )
                 {

_source/core/commanddefinition.js

@@ -70 +70 @@
  *     async : true    // The command need some time to complete after exec function returns.
  * });
  */
+
+/**
+ * Whether the command should give focus to the editor before execution.
+ * @name  CKEDITOR.commandDefinition.editorFocus
+ * @type {Boolean}
+ * @example
+ * editorInstance.addCommand( 'maximize',
+ * {
+ *     exec : function( editor )
+ *     {
+ *     },
+ *     editorFocus : false    // The command doesn't require focusing the editing document.
+ * });
+ */

_source/core/command.js

@@ -12 +12 @@
                 if ( this.state == CKEDITOR.TRISTATE_DISABLED )
                         return false;
 
-                // The editor will always have the focus when executing a command.
-                editor.focus();
+                if( commandDefinition.editorFocus )     // Give editor focus if necessary.
+                        editor.focus();
 
                 return ( commandDefinition.exec.call( this, editor, data ) !== false );
         };
@@ -22 +22 @@
                 // Defaults
                 {
                         modes : { wysiwyg : 1 },
+                        editorFocus : true,
                         state : CKEDITOR.TRISTATE_OFF
                 });