Package org.fife.ui.rtextarea
Class Macro
- java.lang.Object
-
- org.fife.ui.rtextarea.Macro
-
public class Macro extends Object
A macro as recorded/played back by anRTextArea
.Macro
s are static; when a Macro is loaded, it can be run by any instance ofRTextArea
in the application. To activate and play back a macro, use the following methods:RTextArea.beginRecordingMacro()
(this discards the previous "current" macro, if any)RTextArea.endRecordingMacro()
(at this point, you could callplaybackLastMacro()
to play this macro immediately if desired)RTextArea.getCurrentMacro()
.saveToFile(File)
Macro
s save themselves as XML files, a common technique is to save all macros in files named "
", and place them all in a common directory.getName()
.xml
-
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
addMacroRecord(org.fife.ui.rtextarea.Macro.MacroRecord record)
Adds a macro record to this macro.List<org.fife.ui.rtextarea.Macro.MacroRecord>
getMacroRecords()
Returns the macro records that make up this macro.String
getName()
Returns the name of this macro.void
saveToFile(File file)
Saves this macro to an XML file.void
saveToFile(String fileName)
Saves this macro to a file.void
setName(String name)
Sets the name of this macro.
-
-
-
Constructor Detail
-
Macro
public Macro()
Constructor.
-
Macro
public Macro(File file) throws FileNotFoundException, IOException
Loads a macro from a file on disk.- Parameters:
file
- The file from which to load the macro.- Throws:
FileNotFoundException
- If the specified file does not exist, is a directory instead of a regular file, or otherwise cannot be opened.IOException
- If an I/O exception occurs while reading the file.- See Also:
saveToFile(String)
,saveToFile(File)
-
Macro
public Macro(String name)
Constructor.- Parameters:
name
- The name of the macro.
-
-
Method Detail
-
addMacroRecord
public void addMacroRecord(org.fife.ui.rtextarea.Macro.MacroRecord record)
Adds a macro record to this macro.- Parameters:
record
- The record to add. Ifnull
, nothing happens.- See Also:
getMacroRecords()
-
getMacroRecords
public List<org.fife.ui.rtextarea.Macro.MacroRecord> getMacroRecords()
Returns the macro records that make up this macro.- Returns:
- The macro records.
- See Also:
addMacroRecord(org.fife.ui.rtextarea.Macro.MacroRecord)
-
getName
public String getName()
Returns the name of this macro. A macro's name is simply something to identify it with in a UI; it has nothing to do with the name of the file to save the macro to.- Returns:
- The macro's name.
- See Also:
setName(String)
-
saveToFile
public void saveToFile(File file) throws IOException
Saves this macro to an XML file. This file can later be read in by the constructor taking aFile
parameter; this is the mechanism for saving macros.- Parameters:
file
- The file in which to save the macro.- Throws:
IOException
- If an error occurs while generating the XML for the output file.- See Also:
saveToFile(String)
-
saveToFile
public void saveToFile(String fileName) throws IOException
Saves this macro to a file. This file can later be read in by the constructor taking aFile
parameter; this is the mechanism for saving macros.- Parameters:
fileName
- The name of the file in which to save the macro.- Throws:
IOException
- If an error occurs while generating the XML for the output file.- See Also:
saveToFile(File)
-
-