com.xmlmind.xmleditapp.desktop.edit

Class IncludeCmd

java.lang.Object

com.xmlmind.xmledit.cmd.CommandBase

com.xmlmind.xmledit.cmd.include.Include

com.xmlmind.xmleditapp.desktop.edit.IncludeCmd

All Implemented Interfaces:

InclusionChooser.IncludableFilter, Command

public final class IncludeCmd
extends Include

Field Summary

Fields inherited from class com.xmlmind.xmledit.cmd.include.Include

currentDocView, includableId

Fields inherited from class com.xmlmind.xmledit.cmd.CommandBase

recordable, repeatable

Constructor Summary

Constructors

Constructor and Description
IncludeCmd()

Method Summary

Modifier and Type	Method and Description
CommandResult	doExecute(DocumentView docView, String parameter, int x, int y) Actually executes this command with specified parameter and in specified context.
CommandResult	execute(DocumentView docView, String parameter, int x, int y) This method invokes CommandBase.doExecute(com.xmlmind.xmledit.view.DocumentView, java.lang.String, int, int) to actually execute the command.
protected InclusionChooser	getInclusionChooser(DocumentView docView)
void	resetCommand()

Methods inherited from class com.xmlmind.xmledit.cmd.include.Include

chooseInclusion, execute, filterIncludables, getInclusionChoice, getSimpleInclusionSchemes, hasSimpleInclusionSchemes, includableNotFound, prepare

Methods inherited from class com.xmlmind.xmledit.cmd.CommandBase

doExecuteByName, executeCommand, isRecordable, isRepeatable, prepareCommand

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.xmlmind.xmledit.control.Command

copy

Constructor Detail

IncludeCmd

public IncludeCmd()

Method Detail

execute

public CommandResult execute(DocumentView docView,
                             String parameter,
                             int x,
                             int y)

Description copied from class: CommandBase

This method invokes CommandBase.doExecute(com.xmlmind.xmledit.view.DocumentView, java.lang.String, int, int) to actually execute the command. It's basically a convenience method which automatically deals with the command history and the macro-recorder (if any).

IMPORTANT: a command which executes another command must always use CommandBase.doExecute(com.xmlmind.xmledit.view.DocumentView, java.lang.String, int, int) to do so, NOT CommandBase.execute(com.xmlmind.xmledit.view.DocumentView, java.lang.String, int, int) or CommandBase.executeCommand(com.xmlmind.xmledit.gadget.Gadget, java.lang.String, int, int).

Overrides:

execute in class CommandBase

doExecute

public CommandResult doExecute(DocumentView docView,
                               String parameter,
                               int x,
                               int y)

Description copied from class: CommandBase

Actually executes this command with specified parameter and in specified context.

This method assumes that CommandBase.prepare(com.xmlmind.xmledit.view.DocumentView, java.lang.String, int, int) has been successfully invoked immediately before its own invocation.

IMPORTANT: application code which executes a command must always use CommandBase.execute(com.xmlmind.xmledit.view.DocumentView, java.lang.String, int, int) or CommandBase.executeCommand(com.xmlmind.xmledit.gadget.Gadget, java.lang.String, int, int) to do so, NOT CommandBase.doExecute(com.xmlmind.xmledit.view.DocumentView, java.lang.String, int, int). CommandBase.doExecute(com.xmlmind.xmledit.view.DocumentView, java.lang.String, int, int) is intended to be used only by commands which invoke helper "sub-commands".

Overrides:

doExecute in class Include

Parameters:

docView - the target of this command

parameter - parameterizes the command (that is, modifies the behavior of the command in a command specific way)

x - X position relative to docView of the mouse event having triggered this command; -1 if this command was triggered by a keyboard input

y - Y position relative to docView of the mouse event having triggered this command; -1 if this command was triggered by a keyboard input

Returns:

the result of the command; may NOT be null.

If the command execution is successful and the command is repeatable and/or recordable then CommandResult.details field of the result is expected to be one of:

null

The repeat/record parameter is simply the parameter used as an argument of this method.

An Object

The repeat/record parameter is the string value of this object.

An array of 2 Strings

First string is the repeat/record parameter. Second string is the description of the command to be displayed by repeat commands.

resetCommand

public void resetCommand()

Overrides:

resetCommand in class Include

getInclusionChooser

protected InclusionChooser getInclusionChooser(DocumentView docView)

Overrides:

getInclusionChooser in class Include