args - args
func - func
instance - instance
interval - window.setInterval()
running - Boolean
timeout - window.setTimeout()
timer - Number
Expands the abbreviation, if any, at the current cursor position.
abbrev - String
Optional. The abbreviation to expand. If not given, then the current selection or word before the cursor is used.
lang - String
The language name to scope the search. Optional.
sublang - String
The sub-language name top scope the search. Optional.
Returns - Boolean
Find a snippet for the given abbreviation name. Abbreviations used for snippets are looked for in "Abbreviations" groups in these places: 1. the current project (if any) 2. the toolbox 3. the shared toolbox (if any) And for these languages: A. the current buffer sub-lang (for multi-lang files) B. the current buffer lang (if different than A) C. the "General" lang (i.e. not language-specific)
abbrev - String
The abbreviation name.
lang - String
The language name to scope the search. Optional. If not given, then the language of the current view is used. Specify "General" to *not* search for a lang-specific abbreviation.
sublang - String
The sub-language name top scope the search. This can be relevant for multi-language files (e.g. HTML can have HTML and JavaScript and CSS). Optional. If not given, then the sub-lang of the current cursor position in the current view is used. Specify "General" to *not* search for a sub-lang-specific abbreviation.
Returns - Components.interfaces.koITool
Insert an abbreviation snippet into a buffer.
snippet - Components.interfaces.koITool
The snippet part to insert. You can use `ko.abbrev.findAbbrevSnippet()` to get one.
view - Components.interfaces.koIView
The buffer view in which to insert the snippet. Optional. If not specified then the current view is used.
show mailing list archives on ASPN that are related to the topic
topic - String
browse to a predefined url on activestate.com see tag2uri in ko.browse
show the url defined in "localHelpFile" in an instance of koIAppInfoEx
app - String
the app identifier from the CID of a koIAppInfoEx implementation (eg. @activestate.com/koAppInfoEx?app=Perl)
open the given url or complain appropriately
url - String
browser - String
optional, retreived from prefs if not used
show a list of command id's in the browser
show a list of keybindings in the browser
Hide or show the local help entries in the Help->Languages popup depending on whether an actual help file to launch can be found.
show the url defined in "webHelpURL" in an instance of koIAppInfoEx
app - String
the app identifier from the CID of a koIAppInfoEx implementation (eg. @activestate.com/koAppInfoEx?app=Perl)
Link the current Komodo project with the provided codeintel buffer. Note: See bug 88841 for details on why this is necessary.
Trigger a completion (i.e. an autocomplete or calltip session) if appropriate.
Returns - rc
event - Event
Returns - Boolean
node - top.document.getElementById()
controller - top.document.commandDispatcher.getControllerForCommand()
Returns - found
yesNo()
options - String
Returns - ko.dialogs.authenticate2()
Returns - Object
style - String
Returns - obj.response
mruName - String
interpolateValues - Boolean
Returns - obj.response
mode - String
Returns - Object
is_cancellable - Boolean
modal - Boolean
Returns - newName
selectionCondition - String
yesNoCancel - Boolean
Returns - obj.response
response - String
style - String
Returns - obj.response
genericSupportedFlavours - Array
KoDropData - KomodoDropData
Class instance to hold dropped Komodo data.
windowSupportedFlavours - this.genericSupportedFlavours.concat()
event - Event
Returns - Boolean
Convert the Komodo dropped data - this may involve: o viewing the source of HTTP urls o converting mapped urls o treating dropped URLs as text
koDropDataList - Array
- Array of KomodoDropData items.
Returns - Array
Returns - Boolean
event - Event
Returns - Boolean
event - Event
Returns - Boolean
Open all Komodo dropped files or URLs and then return the unhandled list of koDropData items.
koDropDataList - Array
- Array of KomodoDropData items.
Returns - Array
Unpack the dropped data into a Komodo specific data structure.
dataTransfer - Components.interfaces.nsIDOMDataTransfer
- The data.
acceptedFlavours - Array
- Optional - list of supported data types.
Returns - Array
A dialog to pick a directory, and put the directory path into a XUL textbox.
textbox - Element
Pick an executable file for open.
title - String
Returns - String
Browse for a file.
Returns - String
Pick multiple files.
defaultDirectory - ko.uriparse.dirName()
title - String
Returns - Array
A dialog to pick a remote directory and put the path into a XUL textbox.
textbox - Element
Pick a directory/folder.
Returns - String
DEPRECATED: Same as ko.filepicker.browseForExeFile.
Returns - ko.filepicker.browseForFile.apply()
DEPRECATED: Same as ko.filepicker.browseForFile.
Returns - ko.filepicker.browseForFile.apply()
DEPRECATED: Same as ko.filepicker.browseForFiles.
Returns - ko.filepicker.browseForFiles.apply()
Open remote file(s) Same parameters meanings as "filepicker_remoteFileBrowser" (above) Returns nothing. Note: The files will be opened through this function call
Browse for remote file(s)
defaultUrl - currentView.koDoc.file.URI
defaultFilename - String
mode - Components.interfaces.nsIFilePicker.modeOpen
title - _bundle.GetStringFromName()
defaultFilterName - Array
filterNames - Array
helpTag - String
Returns - Object
Choose remote filename to save as Same parameters meanings as "filepicker_remoteFileBrowser" (above) Returns the remote url of the selected file, or null if the dialog is cancelled.
Pick a file for save.
defaultDirectory - ko.uriparse.dirName()
title - String
Returns - String
fname1 - fname1.replace()
fname2 - fname2.replace()
Launches the alternate help command.
Opens language specific help for the current buffer.
searchTerm - String
Open language help for this search term.
Open the Komodo help window.
page - String
A page tag as defined in toc.xml
Open the Komodo error log for viewing.
_recently_did_history - Boolean
event - Event
Common function for moving forward or back
go_method_name - String
either 'go_back' or 'go_forward', used to make this routine work for both directins.
check_method_name - String
either 'can_go_back' or 'can_go_forward', Same rationale as go_method_name
delta - Number
# of hops to make
explicit - Boolean
if true, the user pressed the "Recent Locations" button. Otherwise they hit the go_back or go_forward command.
Returns - _curr_session_name
event - Event
Note the current location.
view - view
An optional view in which to get the current location. If not given the current view is used.
check_section_change - Boolean
Returns - koILocation
Note the current location from functions like view.history.setMostRecentView
view - view
An optional view in which to get the current location. If not given the current view is used.
Returns - koILocation
Returns - Number
args - args
enabled - prefs.getBooleanPref()
enabledPrefName - String
endPos - endPos
func - jump_fn
handler - handler
indic_color - indic_color
indic_style - indic_style
lang_names - lang_names
name - name
startPos - startPos
Add a handler to the list of known hyperlink handlers.
handler - ko.hyperlinks.BaseHandler
- The handler to add.
Return a copy of the available hyperlink handlers.
Returns - Array
Get the available hyperlink handlers for the given language name, or all hyperlink handlers when lang is not set.
Returns - Array
Return the handler with this name from the list of known hyperlink handlers.
name - String
- The handler name to find.
Returns - ko.hyperlinks.BaseHandler
Remove this handler from the list of known hyperlink handlers.
handler - ko.hyperlinks.BaseHandler
- The handler to remove.
Show any available hyperlink at the position in the view.
view - Components.interfaces.koIScintillaView
View to check.
position - Number
Position in the scimoz editor.
reason - String
What the triggering event reason was, can be one of "keypress" or "mousemove".
Returns - ko.hyperlinks.BaseHandler
The base hyperlink handler class. Handlers are responsible for checking to see if an editor position is a hyperlink and then highlighting the hyperlink within the editor.
name - String
A unique name of the hyperlink handler.
jump_fn - Function
Will be called when the user clicks on the jump point. The matching (or replaced) hyperlink value is the only argument passed to this function.
lang_names - {array
Optional - If set, the handler will only show hyperlinks when the editor language is one of these language names.
indic_style - Number
Optional - Indicator style, see scimoz.INDIC_*
indic_color - Number
Optional - Indicator color (BGR), i.e. 0xFFCC33
Called when the mouse dwells on this hyperlink.
view - Components.interfaces.koIScintillaView
The view instance.
hyperlink - ko.hyperlinks.Hyperlink
The hyperlink instance.
Activate this hyperlink instance.
view - Components.interfaces.koIScintillaView
The view instance.
hyperlink - ko.hyperlinks.Hyperlink
The hyperlink instance.
Remove this hyperlink instance.
view - Components.interfaces.koIScintillaView
The view instance.
hyperlink - ko.hyperlinks.Hyperlink
The hyperlink instance.
reason - String
What the triggering event reason was, can be one of "keyup", "mousemove", "mouseup" or "blur".
Returns - Boolean
Set a hyperlink at this position.
view - Components.interfaces.koIScintillaView
View to mark.
startPos - Number
Scimoz position for the start of the hyperlink.
endPos - Number
Scimoz position for the end of the hyperlink.
args - Array
Optional - Array of args to pass to the function.
Returns - ko.hyperlinks.Hyperlink
Try and show a hyperlink at the current position in the view.
view - Components.interfaces.koIScintillaView
View to check.
scimoz - Components.interfaces.ISciMoz
Scimoz for the view.
position - Number
Position in the scimoz editor.
line - String
The current line from the editor.
lineStartPos - Number
Scimoz position for the start of the line.
lineEndPos - Number
Scimoz position for the end of the line.
reason - String
What the triggering event reason was, can be one of "keypress" or "mousemove".
Returns - Boolean
named_css_colors - Array
Returns - color_hex
Activate this hyperlink instance.
view - Components.interfaces.koIScintillaView
The view instance.
hyperlink - ko.hyperlinks.Hyperlink
The hyperlink instance.
Remove this hyperlink instance.
view - Components.interfaces.koIScintillaView
The view instance.
hyperlink - ko.hyperlinks.Hyperlink
The hyperlink instance.
reason - String
What the triggering event reason was, can be one of "keyup", "mousemove", "mouseup" or "blur".
Returns - Boolean
Returns - match.join()
Try and show a hyperlink at the current position in the view.
view - Components.interfaces.koIScintillaView
View to check.
scimoz - Components.interfaces.ISciMoz
Scimoz for the view.
line - String
The current line from the editor.
lineStartPos - Number
Scimoz position for the start of the line.
lineEndPos - Number
Scimoz position for the end of the line.
reason - String
What the triggering event reason was, can be one of "keypress" or "mousemove".
Returns - ko.hyperlinks.Hyperlink
A goto defintion hyperlink handler.
constructor
enabled - prefSet.getBooleanPref()
Called when the mouse dwells on this hyperlink.
view - Components.interfaces.koIScintillaView
The view instance.
hyperlink - ko.hyperlinks.Hyperlink
The hyperlink instance.
Remove this hyperlink instance.
view - Components.interfaces.koIScintillaView
The view instance.
hyperlink - ko.hyperlinks.Hyperlink
The hyperlink instance.
reason - String
What the triggering event reason was, can be one of "keyup", "mousemove", "mouseup" or "blur".
Returns - Boolean
Try and show a hyperlink at the current position in the view.
view - Components.interfaces.koIScintillaView
View to check.
scimoz - Components.interfaces.ISciMoz
Scimoz for the view.
line - String
The current line from the editor.
lineStartPos - Number
Scimoz position for the start of the line.
lineEndPos - Number
Scimoz position for the end of the line.
reason - String
What the triggering event reason was, can be one of "keypress" or "mousemove".
Returns - ko.hyperlinks.Hyperlink
A hyperlink instance created by a handler and set on the view.
handler - ko.hyperlinks.BaseHandler
- Handler that made it.
startPos - Number
Scimoz position for the start of the hyperlink.
endPos - Number
Scimoz position for the end of the hyperlink.
args - Array
Optional - Array of args to pass to the function.
Called when the mouse dwells on this hyperlink.
view - Components.interfaces.koIScintillaView
The view instance.
Activate this hyperlink.
view - Components.interfaces.koIScintillaView
The view instance.
Remove this hyperlink.
view - Components.interfaces.koIScintillaView
The view instance.
reason - String
What the triggering event reason was, can be one of "keyup", "mousemove", "mouseup" or "blur".
Returns - Boolean
Called when the mouse dwells on this hyperlink.
view - Components.interfaces.koIScintillaView
The view instance.
hyperlink - ko.hyperlinks.Hyperlink
The hyperlink instance.
Remove this hyperlink instance.
view - Components.interfaces.koIScintillaView
The view instance.
hyperlink - ko.hyperlinks.Hyperlink
The hyperlink instance.
reason - String
What the triggering event reason was, can be one of "keyup", "mousemove", "mouseup" or "blur".
Returns - Boolean
name - String
A unique name of the hyperlink handler.
findRegex - RegExp
Regular expression used to find the hyperlink.
fn - Function
Will be called when the user clicks on the jump point. The matching (or replaced) hyperlink value is the only argument passed to this function.
replace_str - {string
Optional - If set, will be used to change the matching text into a different value, similar to str.replace(findRegex, replace_str), so you can use the JavaScript regular expression positions: $1, $2, etc... in the string.
lang_names - {array
Optional - If set, the handler will only show hyperlinks when the editor language is one of these language names.
indic_style - Number
Optional - Indicator style, see scimoz.INDIC_*
indic_color - Number
Optional - Indicator color (BGR), i.e. 0xFFCC33
findRegex - findRegex
limit_to_styles - styleNumbers
regex_match - match
replace_str - replace_str
When checking for a hgyperlink match, the style at the cursor position must match one one of these values.
styleNumbers - Array
- List of style numbers.
Try and show a hyperlink at the current position in the view.
view - Components.interfaces.koIScintillaView
View to check.
scimoz - Components.interfaces.ISciMoz
Scimoz for the view.
position - Number
Position in the scimoz editor.
line - String
The current line from the editor.
lineStartPos - Number
Scimoz position for the start of the line.
lineEndPos - Number
Scimoz position for the end of the line.
reason - String
What the triggering event reason was, can be one of "keypress" or "mousemove".
Returns - ko.hyperlinks.Hyperlink
Input buffering When you need to capture user input while a slow XUL window is loading you can use the input buffer. Usage: - in some JS code: ko.inputBuffer.start() // open XUL window - in slow XUL window onload handler: var contents = ko.inputBuffer.finish(); // use the contents somehow
id - String
Returns - contents
event - Event
Utility methods to easily use the KoIInterpolationService from JavaScript. Basically you can use the ko.interpolate.interpolate() method to iterpolation special '%'-escape codes in a given list of strings. See koInterpolationService.py (or play around with "run commands") for an authoritative description of available escape codes. How to interpolate a couple of strings (mystringa, mystringb). You can do as many strings as you want. var imystringa = null; var imystringb = null; try { var istrings = ko.interpolate.interpolate( <ref-to-komodo.xul>, [mystringa, mystringb], // codes are not bracketed [mystringc, mystringd], // codes are bracketed <optional-query-title>); imystringaForUse = istrings[0]; imystringaForDisplay = istrings[1]; imystringbForUse = istrings[2]; imystringbForDisplay = istrings[3]; imystringcForUse = istrings[4]; imystringcForDisplay = istrings[5]; imystringdForUse = istrings[6]; imystringcForDisplay = istrings[7]; } catch (ex) { var errno = lastErrorSvc.getLastErrorCode(); if (errno == Components.results.NS_ERROR_ABORT) { // Command was cancelled. } else if (errno == Components.results.NS_ERROR_INVALID_ARG) { var errmsg = lastErrorSvc.getLastErrorMessage(); alert("Could not interpolate:" + errmsg); } else { log.error(ex); alert("There was an unexpected error: " + ex); } }
Returns - projectFile
Returns - String
Returns - projectFile
Return a list of start and end offsets of interpolation code blocks into the given strings "s".
Returns - offsets
A utility function to retrieving specific view data required by Interpolate_interpolate(). "editor" is a reference to the komodo.xul window. "viewData" (optional) is a object possibly containing overriding values for some of the view data.
viewData - Object
Returns - viewData
Return the current word from the current scimoz character position.
scimoz - Components.interfaces.ISciMoz
(Optional) The scimoz editor to retireive the word from.
Returns - String
Interpolate '%'-escape codes in the given list(s) of strings. "editor" is a reference the komodo.xul window. "strings" is a list of raw strings to interpolate. "bracketedStrings" is a list of raw strings to interpolate, using the bracketed form "queryTitle" (optional) is a title for the possible query dialog raised during interpolation. "viewData" (optional) allows one to override specific view data used for interpolation. By default view data is retrieved from the current view. This may not always be appropriate. It may be an object with one or more of the following attributes: "fileName" is the filename of the current file (null, if N/A); "lineNum" is the current line number (0, if N/A); "word" is the current word under cursor (null if none); "selection" is the current selection (null if none). On success, this function returns a *double* list of interpolated strings: For each string in "strings" and "bracketedStrings" two strings are returned. The first is the interpolated string for use and the second for *display*. In most cases these are the same but they may differ, for example, if a password query response was interpolated into the string which should not be displayed in the Komodo UI. Otherwise an exception is raised and an error set on the last error service: koILastError errno reason ----------------------- ----------------------------------------- NS_ERROR_ABORT User cancelled the query dialog. NS_ERROR_INVALID_ARG A normal interpolation failure because of invalid interp code usage.
viewData - ko.interpolate.getViewData()
Returns - istrings
Interpolate '%'-escape codes in the given string.
s - String
The string to interpolate.
bracketed - Boolean
(optional) Whether "s" uses the bracketed interpolate format
queryTitle - String
(optional) Title for any query dialogs raised during interpolation.
Returns - String
DEPRECATED: [DEPRECATED] Interpolate the given string.
Returns - ko.interpolate.interpolateString()
controller - ISController
_knownconfigs - Array
commanditems
currentConfiguration - gPrefSvc.prefs.getStringPref()
currentPrefixString - String
currentScheme - this.keybindingSchemeService.getScheme()
document - document
inPrefixCapture - Boolean
keybindingSchemeService
keyDownLabels
keylabel2keysequence - keylabel2keysequence
keysequence2keylabel - keysequence2keylabel
prefset - gPrefSvc.prefs
_configDirty - Boolean
_configKeyTree - cloneObject()
_configUnsaved - Boolean
_keyPressCaptureWindow - window
_knownconfigs - schemes.value
activeCommands - cloneObject()
command2key - Object
commanditems - Array
commandnames - Array
constructor
currentConfiguration - configName
currentPrefixMap - this.keyTree
currentPrefixString - String
currentScheme - scheme
inPrefixCapture - Boolean
key2command - Object
keyDownLabels
keynames - Array
keyTree - Object
lastcategory - String
prefset - prefset
rownum - Number
desc - desc.replace()
Returns - String
Returns - Boolean
Returns - root
Returns - part
root - commandMatch
Returns - keysequence2keylabel()
Returns - seqs
Returns - commanddesc
Returns - String
Returns - commanddesc
Returns - commanddesc
Returns - scheme.writeable
event - Event
Returns - Boolean
event - Event
useShift - Boolean
isKeyPressEvent - Boolean
Returns - data.join()
event - Event
isKeyPressEvent - Boolean
Returns - possible
Returns - this._knownconfigs
keyname - keyname.slice()
event - Event
forceReload - Boolean
Returns - String
Returns - String
Returns - newconfigname
forceReload - Boolean
topic - topic.indexOf()
Parse the keybinding configuration file data into commands. Acitivate the keybinding commands.
forceReload - Boolean
Returns - key
Returns - Boolean
Returns - usedbys
Show Komodo's about dialog.
Opens the update manager and checks for updates to the application. From http://plow/source/xref/mozilla/1.8/browser/base/content/utilityOverlay.js#452
diff open the diff dialog, you must provide the diff
diff - String
title - String
message - String
Returns - ko.windowManager.openDialog()
Open the Find dialog.
pattern - String
The pattern to search for.
Returns - ko.windowManager.openDialog()
Open the find dialog for searching in a "collection" find context.
collection - koICollectionFindContext
defines in what to search.
pattern - String
is the pattern to search for. Optional.
Returns - ko.windowManager.openDialog()
Open Find dialog to search in the current project.
pattern - String
Returns - ko.windowManager.openDialog()
Open Find dialog to search in files.
pattern - String
dirs - String
includes - Array
excludes - Array
Returns - ko.windowManager.openDialog()
Returns - ko.windowManager.openDialog()
openAddonsMgr open the extension/add ons manager window
Returns - ko.windowManager.openOrFocusDialog()
Open the Find/Replace dialog.
pattern - String
The pattern to search for.
repl - String
The replacement pattern.
Returns - ko.windowManager.openDialog()
Open the find dialog to find & replace in a "collection" of files.
collection - koICollectionFindContext
defines in what to search.
pattern - String
The pattern to search for.
repl - String
The replacement pattern.
Returns - ko.windowManager.openDialog()
Open Find dialog to find & replace in the current project.
pattern - String
The pattern to search for.
repl - String
The replacement pattern.
Returns - ko.windowManager.openDialog()
Open Find dialog to make replacements in files.
pattern - String
repl - String
dirs - String
includes - Array
excludes - Array
Returns - ko.windowManager.openDialog()
runCommand open the run command dialog
Returns - window.openDialog()
watchLocalFile prompt for a file to watch, then open a new watch window
collection - collection
cwd - cwd
dirs - dirs
excludes - excludes
includes - includes
mode - String
pattern - pattern
repl - repl
_lastRequestId - Number
_lintDisplayer - Components.interfaces.koILintDisplayer
_lintSvc - Components.interfaces.koILintService
_lintTimer
errorString
lintingEnabled - this.view.prefs.getBooleanPref()
lintResults
view - view
event - Event
_lintTimer - objectTimer
constructor
errorString - request.errorString
lintingEnabled - lintingEnabled
lintResults - request.results
view
Returns - this
reason - String
_logger - logger
_logger_name - logger_name
dumpDOM - dumpDOM
getObjectTree - getObjectTree
getStack - getStack
loggingSvc - Components.interfaces.koILoggingService
event - Event
Returns - this.getLoggingMgr().getLogger()
Returns - _gLoggingMgr
name - String
Returns - s
constructor
Log a deprecation warning message. This will also log the stack trace to show where the deprecated code was being called from. Note: This is not a core Python logging function, it's just used from JavaScript code to warn about Komodo JavaScript API deprecations.
message - String
The deprecation warning message.
reportDuplicates - Boolean
Optional, when set to false it only logs the first occurance of the deprecation message.
message - String
Returns - this._logger.getEffectiveLevel()
current - _partSvc.runningMacro
CURRENT_MACRO_VERSION - Number
eventHandler - MacroEventHandler
recorder - MacroRecorder
ko_macro_name - deprecatedName
view - ko.views.manager.currentView
Returns - Boolean
__koNum - val
windowIsClosing - Boolean
Is this window being closed?
Window "close" event handler to close the Komodo window and, if it is the last one, quit. This is called when the application's "x" close button is pressed. It is NOT called when quitting Komodo via "File -> Exit", "Cmd+Q", or equivalent.
event - Event
Window "DOMWindowClose" event sent when the window is about to be closed by `window.close()`. For Komodo shutdown this is called when a window is closed via toolkit's `goQuitApplication()`, but NOT when closed via the application window's "x" close button. However, this method will be called in procedures that cause Komodo to shut down, such as during updates. It's too late to check if we can quit, but we should still save the workspace and run the willCloseHandlers. See bug 67126 for more details. http://developer.mozilla.org/en/docs/Gecko-Specific_DOM_Events#DOMWindowClose http://mxr.mozilla.org/mozilla1.8/source/dom/src/base/nsGlobalWindow.cpp#4737 ... DispatchCustomEvent("DOMWindowClose") ...
event - Event
Register a routine to be called when a Komodo window is closed. To register a simple routine do this: ko.main.addWillCloseHandler(<routine>) To register an object method do this: ko.main.addWillCloseHandler(this.<method>, this); *XXX Do we want to add an optional argument list to pass in?
Remove the given handler from the list of do-close handlers.
Returns - Boolean
MARKERS_MASK_SYMBOLS - Number
MARKNUM_BOOKMARK - Number
MARKNUM_CURRENT_LINE_BACKGROUND - Number
MARKNUM_HISTORYLOC - Number
MARKNUM_STDERR - Number
MARKNUM_STDIN_PROMPT - Number
MARKNUM_STDOUT - Number
MARKNUM_TRANSIENTMARK - Number
Read a file from disk, cache and return the contents.
uri - String
file uri
force - Boolean
force read from file Note: The file contents are cached by URI. This is used to load pixmaps for scintilla markers.
Returns - content_cache[uri]
Setup the standard Komodo markers in the given SciMoz instance and return an appropriate mask for ISciMoz.setMarginMaskN(<n>, <mask>).
scimoz - Components.interfaces.ISciMoz
- A plugin instance.
Returns - ko.markers.MARKERS_MASK_SYMBOLS
pluginContextMenu Verified still necessary with moz 1.8 branch - SMC For some reason popups over the plugin are messed up until the first context menu over mozilla is activated. It is apparently due to popupNode not being initialized, so we do that here. See: http://www.xulplanet.com/references/elemref/ref_popup.html
notify - Boolean
notify - Boolean
index - Number
Returns - retval
maxLength - Math.max()
Returns - retval
Returns - maxEntries
Remove the given "entry" (a string) from the given MRU if it exists.
prefName - String
The mru preference with which it is associated.
entry - String
The entry to remove from the mru.
caseSensitive - Boolean
How to match the entry.
Remove the given URL from the mru preference (if it exists).
prefName - String
The mru preference with which it is associated.
url - String
The URL to remove from the mru.
__XXZZ__
mruFileList - String
mruProjectList - String
mruTemplateList - String
The open namespace contains functionality to open buffers in komodo
_audioUrlREs - Array
_imageUrlREs - Array
accessKey - _viewsBundle.GetStringFromName()
label - _viewsBundle.GetStringFromName()
preNotificationSessionSchemeName - oldSchemeName
Display a notification box that lets the user revert the current color scheme from the one that was just imported to the previous one.
schemeService - nsIScintillaSchemeService
oldSchemeName - String
newSchemeName - String
Returns - undefined
Open the given path in Komodo. If you need the view for the file that is opened from this call, pass in a callback function argument and then this function will be called after the view is opened (or re-focused if it was already open).
displayPath - String
identifies the path to open. Display path may be the display path of an already open (and possibly untitled) document.
viewType - String
optional default "editor", the type of view to create for the openned path. It is ignored if the displayPath indicates an already open view.
callback - Function
optional, to be called when the asynchronous load is complete. This will only be called if this opens or switches to an editor view, e.g. this won't be called for a kpf file. The view will be passed as an argument to the function.
open a file picker, and open the files that the user selects
Returns - Boolean
Returns - Boolean
urls - urls.concat()
Open Komodo's Start Page - the view will be opened synchronously.
open a file picker, and open the templates that the user selects. This allows editing the templates, it is not for creating new files from templates.
Asynchronously open the URI in a new Komodo tab, if the file is already open then this existing tab becomes the currently focused tab. If you need the view for the file that is opened from this call, pass in a callback function argument and then this function will be called after the view is opened (or re-focused if it was already open).
uri - String
the path or URI to open
viewType - String
optional default "editor" type of view component to use. Values can be [ "editor", "browser", "diff" ].
skipRecentOpenFeature - Boolean
optional default false, can be used when the URI to open is a project file to specify that the feature to open files in that project should not be offered.
callback - Function
optional, to be called when the asynchronous load is complete. This will only be called if this opens or switches to an editor view, e.g. this won't be called for a kpf file. The view will be passed as an argument to the function.
Returns - ko.open.URIAtLine()
Asynchronously open the URI in a new Komodo tab, if the file is already open then this existing tab becomes the currently focused tab. If you need the view for the file that is opened from this call, pass in a callback function argument and then this function will be called after the view is opened (or re-focused if it was already open).
uri - String
the path or URI to open
lineno - Number
the line number to open the file at
viewType - String
optional default "editor" type of view component to use. Values can be [ "editor", "browser", "diff" ].
skipRecentOpenFeature - Boolean
optional default false, can be used when the URI to open is a project file to specify that the feature to open files in that project should not be offered.
callback - Function
optional, to be called when the asynchronous load is complete. This will only be called if this opens or switches to an editor view, e.g. this won't be called for a kpf file. The view will be passed as an argument to the function.
tofile - Boolean
selectionOnly - Boolean
Returns - Boolean
_toolboxParts - Array
active - this
BaseManager - BaseManager
extensionManager - projectExtensionManager
managers - Array
peMenu - peMenu
Returns - s_new
Returns - defaultDir
Returns - fixedLines.join()
ko_project_name - deprecatedName
Returns - parts
Returns - this.addPartWithURLAndType()
Returns - part
part - parent.project.createPartFromType()
parent - ko.projects.active.getSelectedItem()
Returns - part
Returns - parts
Returns - part
parent - ko.projects.active.getSelectedItem()
snippet - ko.toolbox2.createPartFromType()
Returns - snippet
part - parent.project.createPartFromType()
parent - ko.toolbox2.getStandardToolbox()
async - part.getBooleanAttribute()
Returns - Boolean
Returns - Boolean
view - ko.views.manager.getViewForURI()
folder - Boolean
Returns - Boolean
Returns - items
findPart find a part in the toolboxes and/or a specifid part's project
type - String
name - String
where - String
one of "container", "toolbox", "shared toolbox", "toolboxes" or "*" where "*" means "current part project, toolbox, shared toolbox"
part - koIPart
defaults to the running macro if available
Returns - koIPart
Return null if there is no part with the given ID.
Returns - ko.toolbox2.findToolById()
Returns - parts
Returns - Boolean
Import a Komodo package (filename) into the given part.
viewMgr - Object
- The project view manager.
part - Components.interfaces.koIPart
- The part to import into.
uri - String
- The URI of the package to import.
Given a koIPart, invoke it (do it's "double-click" action) through whatever code path is appropriate for that part -- i.e. snippets get inserted, commands get run, etc.
Given the ID of a part, find it and invoke it.
Returns - Boolean
skipRecentOpenFeature - Boolean
Returns - Boolean
part - part.parent
Returns - Boolean
items - pview.manager.getSelectedItems()
Returns - Boolean
Recursively removes virtual files and folders, but does not remove any folders that have been added manually or parts that are not files or folders (i.e. snippets, macros, etc...). This function will also remove any manually added files, that were not added as part of the import process, because there is not way to tell manually added files and imported files apart.
Returns - items
Returns - Boolean
view - ko.views.manager.currentView
Returns - enteredUndoableTabstop
_project_opened_during_workspace_restore - Boolean
current_tab_during_workspace_restore - ko.workspace.restoredLeftTabBoxID
Prepare to close Komodo. Return false if cannot yet close Komodo. If there are processes still running then must wait for or kill them.
Returns - Boolean
Keep a list of processes spawned by the RunCommand system. This is necessary to ensure that there are no hangs when Komodo closes because some process is still running. Before closing Komodo all process must be terminated.
Run the given command.
parseOutput - Boolean
parseRegex - String
showParsedOutputList - Boolean
clearOutputWindow - Boolean
saveInMRU - Boolean
saveInMacro - Boolean
Returns - Boolean
Run an "encoded" command. An encoded command is a string that describes the command and possibly a number of optional arguments. The encoding is defined by koIRunService.Decode().
Returns - Boolean
Remove any processes that have terminated from the list.
The interface for using the run output window (where run command output goes to, in the bottom pane of the Komodo workspace). Expected usage: - Someone calls ko.run.output.initialize() at startup and ko.run.output.finalize() at shutdown. - When a command is to be run in the output window do this: * announce intention to start session ko.run.output.startSession(...); *... setup and start running the actual command calling * ko.run.output.getTerminal() and ko.run.output.show() as needed ko.run.output.setProcessHandle(p); * to allow user to kill process *... setup ko.run.output.endSession() to be run when the process * terminates.
Complete a terminal session. The command exited with the given value.
Returns - _gTerminalHandler
Kill the process currently running in the output window's terminal, if any.
event - Event
Pass a koIRunProcess reference to the output window so it can manipulate the process that is being run in its terminal, if necessary.
Show the command output window. "editor" is the XUL window holding the command output window. "showParseOutputList" is a boolean indicating whether to show the tree parsed output list.
Start a terminal session in the output window with the given command. This raises an exception if the run output window is currently busy. "command" is the command being run (note that this is the command string *for display* which might be slight different -- passwords obscured -- than the actual command) "parseOutput" is a boolean indicating whether to parse output lines "parseRegex" is the regular expression to use to parse output lines "cwd" is the directory in which the command is being run (note: ditto *for display* subtlety withh "command") "filename" is the current editor filename (if any) "clearContent" is a boolean indicating whether to clear the output window content (by default "true", i.e. the window _is_ cleared).
clearContent - Boolean
event - Event
event - Event
Returns - Boolean
AddMessage Post a message to the status bar message area. "msg" is the message string. An empty string or null indicates that the message (of the given category) should be cleared. "category" is the message group to which the message belongs. It is an arbitrary string (it must be at least one character). "timeout" is the amount of time, in milliseconds, that the message should appear. A value of 0 indicates that the message does not timeout. "highlight" is a boolean indicating whether the message should be highlighted on the status bar. "interactive" is a boolean indicating whether the message corresponds to an interactive prompt (such as interactive search). These have higher 'priority' over non-interactive messages in case of conflict. A structure similar to a stack of status messages is maintained. The latest message is always shown. When/if it timesout then the previous message is the stack is displayed. There can only be one message per category, so reusing a category allows for removal of status messages that are no longer appropriate. To add a message that does not timeout: ko.statusBar.addMessage("hello there", "my_category", 0, false) To remove that message: ko.statusBar.addMessage(null, "my_category", 0, false) To add a highlighted message for three seconds: ko.statusBar.addMessage("hello there", "my_category", 3000, true)
Set the encoding menu for the current view.
Clear clear all statusbar elements
ClearCheck clear the syntax checking status
dump dump the current message stack to stdout
Set the encoding menu for the current view.
menupopup - DOMElement
Returns - _sysUtils.byteLength()
Returns - _sysUtils.charIndexFromPosition()
Use koIOs.expanduser to expand a leading "~". This contracts it.
path - String
Returns - one
text - text.replace()
Returns - String
value - part.slice().replace().replace()
Return a copy of s with the leading and trailing whitespace removed.
Returns - String
Returns - newtext
Returns - newValue
backrefNum - backrefNum
backrefNumber - backrefNumber
indicator - indicator
isBackref - isBackref
isBackrefAnchor - isBackrefAnchor
message - msg
snippet - snippet
text - String
Returns - indicatorEnd
Returns - Boolean
isBackref - Boolean
Are we the first string to be added in a linked tabstop?
Remove linked tabstops from the document.
view - ko.views.manager.currentView
Remove all traces of tabstops from the view and document.
Returns - Array
This method creates non-empty tabstops where only a zero-width indicator link was found. It's necessary because the indicator might be detected when 'a' is typed like so: a<*> but by the time it's processed, the user has typed 'sd', leading to this situation: asd<*> In this case, only the 'd' is found to be next to a zero-width indicator, so the 'a' and 's' don't appear in the other tabstops. This function fixes that.
Watches for backspace at the start of a tabstop. Further comments in the code.
Similar to handleBackspace, but watches for delete actions at the right of the indicator. This routine is simpler: if we're about to step on the TSCZW indicator at the end of a linked tabstop, it's time to unlink them.
If we're removing a full TSC, but not the trailing TSCZW, remove the linked items anyway. Otherwise we end up in a state where modifying the parent text doesn't affect the linked tabstops, but if we append at this point, the other tabstops get the update. It's asymmetrical, so we'll unlink.
Returns - finalLen
When the user presses the tab key, this method first determines if there is a current set of linked tabstops to unlink, and then finds the next tabstop to visit. If that tabstop is the head of a set of tabstops linked by the same backref, it colors each tabstop with the TSC indicator ("Tabstop Current"), and also places an invisible TSCZW indicator to the right of each one, to allow the user to delete TSC-indicated text.
Returns - Boolean
Parse a stream of pieces of text and tabstop.
Returns - Object
Returns - tabstop_re.test()
When the user makes a modification in a document with tabstops, this routine handles the change. It handles two main events: 1. The first linked tabstop has changed. All other linked tabstops are updated with the new value. 2. Text containing indicators is about to be deleted. This routine removes the appropriate entries from the view's tabstopIndicatorTable.
availIndicators - Array
endingIndicatorsInUse - Array
idx - Number
lastIndicatorInUse - indicator
lim - liveText.length
nestedIndicatorsInUse - Array
subjectText - liveText
Returns - retStrParts.join()
Returns - this.subjectText.substr()
Returns - Node
isInner - Boolean
Returns - ko.tabstops.LiveTextPlain
Exception object. The message field gives a specific message.
constructor - Error.constructor
Inserts the contents of parsed liveText into the buffer
Returns - Number
*************** LiveTextPlain ***************
Returns - indent
Returns - ko.stringutils.bytelength()
*************** LiveTextTabstopBackrefDef ***************
Returns - indent
Returns - insertLiveTextPartHelper()
*************** LiveTextTabstopBackrefUse ***************
Returns - indent
Returns - insertLiveTextPartHelper()
*************** LiveTextTabstopEmpty ***************
Returns - indent
Returns - ko.tabstops.insertEmptyIndicator()
*************** LiveTextTabstopNested ***************
Returns - parts.join()
Returns - len
*************** LiveTextTabstopText ***************
Returns - indent
Returns - insertLiveTextPartHelper()
isBackref - Boolean
Returns - s
_arrowKeys - Array
_sortDirection - String
_webPackageURL - url
log - log
manager - Toolbox2Manager
multipleNodesSelected - Boolean
raggedMultipleSelection - Boolean
selectedIndices - this.getSelectedIndices()
Returns - uri
event - Event
Returns - row.value
Returns - String
Returns - cleanMacros
Returns - Array
Returns - tool
Returns - osPathSvc.join()
index - this.manager.view.getIndexByTool()
Returns - loadedSomething
Returns - uri
parent - this.getStandardToolbox()
selectItem - Boolean
event - Event
Returns - this.manager.toolsMgr.createToolFromType()
event - Event
event - Event
event - Event
Returns - Boolean
event - Event
tool - this._getSelectedTool()
tool - this._getSelectedTool()
tool - this._getSelectedTool()
tool - this._getSelectedTool()
tool - this._getSelectedTool()
tool - this._getSelectedTool()
event - Event
event - Event
Returns - this.manager.toolsMgr.getToolById()
Returns - this.manager.toolsMgr.getAbbreviationSnippet()
Returns - index
index - this.manager.view.getParentIndex()
Returns - item
Returns - obj.value
Returns - obj.value
Returns - this.manager.toolsMgr.getToolById()
Returns - item
rootsOnly - Boolean
Returns - ko.treeutils.getSelectedIndices()
Returns - this.manager.view.getTool()
Returns - this.manager.toolbox2Svc.getStandardToolbox()
Returns - tools.value
Returns - obj.value
Returns - obj.value
event - Event
Returns - ko.toolbox2.onTreeKeyPress()
event - Event
event - Event
event - Event
event - Event
event - Event
event - Event
event - Event
event - Event
tool - this._getSelectedTool()
tool - this._getSelectedTool()
tool - this._getSelectedTool()
tool - this._getSelectedTool()
tool - this._getSelectedTool()
tool - this._getSelectedTool()
tool - this._getSelectedTool()
event - Event
checkMouseClick - Boolean
event - Event
event - Event
event - Event
Returns - Boolean
event - Event
event - Event
event - Event
event - Event
event - Event
Returns - Array
event - Event
event - Event
Returns - this.manager.updateFilter()
ascending - Components.interfaces.koIToolbox2HTreeView.SORT_BY_NAME_ASCENDING
descending - Components.interfaces.koIToolbox2HTreeView.SORT_BY_NAME_DESCENDING
natural - Components.interfaces.koIToolbox2HTreeView.SORT_BY_NATURAL_ORDER
toolboxBaseManager - toolboxBaseManager
user - ko.toolbox2
name - command
Returns - a
Returns - selectedIndices
focusToo - Boolean
event - Event
Returns - _buttonTextShowing
Returns - Boolean
Returns - Boolean
prefs - gPrefs
prefs - gPrefs
Sets the user's tab pane layout to match the Komodo appearance preferences.
force - Boolean
collapseIfFocused - Boolean
limit - Number
buttonTextShowing - broadcaster.hasAttribute()
Functions to convert/parse strings representing URLs, files, etc. This is basically a loose shim around class URIParser in URIlib.py (somewhat obtusely via koIFileEx). Routines: ko.uriparse.localPathToURI(<localPath>) ko.uriparse.pathToURI(<URI or localPath>) ko.uriparse.URIToPath(<URI or path>) ko.uriparse.URIToLocalPath(<URI or localPath>) ko.uriparse.displayPath(<localPath or URI>) ko.uriparse.baseName(<localPath or URI>) ko.uriparse.dirName(<localPath or URI>) ko.uriparse.ext(<localPath or URI>) Dev Notes: - This module caches a single koIFileEx instance to, presumably, speed things up.
Show the dialog for creating a new mapped URI with the supplied uri and path arguments.
uri - String
The URI to add a mapping for.
path - String
The path the URI will be mapped to.
Returns - Boolean
Get the basename (a.k.a. leafName) of the given file. "file" can be a local filename or URI. Examples: file:///D:/trentm/foo.txt -> foo.txt D:\trentm\foo.txt -> foo.txt ftp://ftp.activestate.com/ActivePython -> ActivePython
Returns - koFileEx.baseName
Return an array, holding the the common URI prefix as the first element of the array and an array of the relative paths as the second array entry.
uris - Array
Returns - Array
Return the common URI prefix of the given list of URIs.
uris - Array
Returns - String
Get the dirname of the given file. "file" can be a local filename or URI referring to a local file. Examples: file:///D:/trentm/foo.txt -> D:\trentm D:\trentm\foo.txt -> D:\trentm ftp://ftp.activestate.com/ActivePython -> throws exception
Returns - koFileEx.dirName
Get an appropriate representation of the given URI for display to the user. "uri", typically, is a URI, though it can be a local filename as well. Examples: file:///D:/trentm/foo.txt -> D:\trentm\foo.txt D:\trentm\foo.txt -> D:\trentm\foo.txt ftp://ftp.activestate.com/ActivePython -> ftp://ftp.activestate.com/ActivePython
Returns - koFileEx.displayPath
Get the extension of the given file. "file" can be a local filename or URI
Returns - koFileEx.ext
DEPRECATED: Was once used to ensure URI's were properly formatted.
Returns - uri
This is a reverse of getMappedURI. Return a unmapped URI if there is a pref setup to match the given path, else return whatever was passed in. Note: If a mapping existed, the return result is *always* a URI.
path - String
The path or URI to check for uri mappings.
prefs - Components.interfaces.koIPreferenceSet
Optional. The preference set to check against.
Returns - String
Uses the supplied URI to check if there are any special mappings setup in order to change this URI into another location. If there is a match, return the new URI, else return the original URI.
uri - String
The URI to check.
prefs - Components.interfaces.koIPreferenceSet
Optional. The preference set to check against.
Returns - String
Get the URI representation of the given local file path. "localPath" must be a local file path. Returns the URI for the given path or raises an exception if "localPath" is not a local path. Returned URIs are normalized ("x/./y" => "x/y", etc.) Examples: D:\trentm\foo.txt -> file:///D:/trentm/foo.txt \\planer\d\trentm\tmp\foo.txt -> file://planer/d/trentm/tmp/foo.txt file:///D:/trentm/foo.txt -> throws exception ftp://ftp.activestate.com/ActivePython -> throws exception
Returns - _normalizedPathToURI()
Get the URI representation of the given local file path or URI "path" must be a local file path or a URI Returns the URI for the given path or the URI if one was passed in. Returned URIs are normalized ("x/./y" => "x/y", etc.) Examples: D:\trentm\foo.txt -> file:///D:/trentm/foo.txt file:///D:/trentm/foo.txt -> file:///D:/trentm/foo.txt ftp://ftp.activestate.com/ActivePython -> ftp://ftp.activestate.com/ActivePython
Returns - _normalizedPathToURI()
Return the relative path from 'fromPath' to 'toPath'.
fromPath - String
The local path to get to.
Returns - String
Get the local file path for the given URI. "uri" may be a URI for a local file or a local path. Returns the local file path or raises an exception if there is no local file representation for that URI. Note: I would rather this explicitly raised if "uri" were a local path, but koIFileEx does not work that way. Examples: D:\trentm\foo.txt -> D:\trentm\foo.txt file:///D:/trentm/foo.txt -> D:\trentm\foo.txt ftp://ftp.activestate.com/ActivePython -> throws exception
Returns - koFileEx.path
Get the file path for the given URI. "uri" may be a URI for a local or remote path. Returns the file path or raises an exception if there is no local file representation for that URI. Examples: D:\trentm\foo.txt -> D:\trentm\foo.txt file:///D:/trentm/foo.txt -> D:\trentm\foo.txt ftp://ftp.activestate.com/ActivePython -> /ActivePython
Returns - koFileEx.path
_currentView
_observingCtrlKeyUp - Boolean
_recentViews - Array
inBufferSwitchingSession - Boolean
log - ko.logging.getLogger()
manager - ko.views.viewManager
Get the view manager.
viewManager - viewManager
event - Event
event - Event
event - Event
event - Event
event - Event
Shared code that returns a label and tooltip based on the path info, and other pertinent info on the state of the document/view object.
baseName - String
dirName - String
lineNo - Number
- one-based line number
tabId - String
- Komodo tab id
viewType - String
- editor/browser/startpage/...
sectionTitle - String
showDirty - Boolean
Returns - String
Shared code that returns a label and tooltip based on the supplied view, suitable for a menuitem.
view - Object(koIScintillaView)
lineNo - Number
- one-based line number
showDirty - Boolean
- put a "*" in the label if the view's document is dirty
sectionTitle - String
- optional string that describes a location.
Returns - Array
Returns - Boolean
pos - scimoz.positionAfter()
Returns - pos
view history controller Recently-visited views: The viewhistory object maintains a stack of recently visited lists. This information can be used to switch to recent views. The semantics of the following methods are as follows: - .getNextMostRecentView() and .getNextLeastRecentView() are used by the buffer switching commands to know which views to switch to. - .enterBufferSwitchingSession() and .exitBufferSwitchingSession() are called by the buffer swiching commands to help .setMostRecentView() know how to behave (the "recent views" stack is NOT updated during such a session). Note that .enter...() may be called multiple times for one .exit...() call. - .setMostRecentView() is called by the view manager's .selectView() and can be called directly by the buffer switching commands for proper session handling. NOTE: THIS BEHAVIOR IS TURNED OFF BY SETTING "handlestctrltab" to false on the tabbed view.
_keylistener
_recentViews - newStack
constructor
inBufferSwitchingSession - Boolean
Returns - currIndex
event - Event
event - Event
Generate the view history views in order (current view first, then the next most recent view, ...).
Returns - view
Returns - view
Returns - state
Returns - menuitem
view_checkDiskFiles is only called from the window's focus handler, located in komodo.xul. it handles checking if any files have changed.
event - Event
Returns - Boolean
does scintilla have focus? Return the scintilla widget
Returns - Element
does any view widget have focus? return which one does or null
Returns - Element
get the current working directory for the window, which is the directory of the current buffer, or the home directory of the user
Returns - this.getHomeDirectory()
Returns - String
Close all open windows (or just children of a given parent window). The normal goQuitApplication function in toolkit does this, but we want to prevent quitting if one of the dialogs prevents shutdown by not closing.
parent - Window
An optional argument to only close windows that are children of this window.
Returns - Boolean
Close children of the current main Komodo window.
Returns - this.closeAll()
Returns - args
Return a "fixed-up" version of the "features" argument for window.openDialog(). This tweaks the string on Mac OS X to ensure the dialog is *not* opened as a sheet.
features - String
The features string to fixup. Pass in null to get a reasonable default.
Returns - features
Change the focus to the next Komodo window.
Returns - <Window>
Change the focus to the previous Komodo window.
Returns - <Window>
Return the last opened window - of any window type.
Returns - <Window>
return a reference to the main Komodo window
Returns - <Window>
Returns an array of all Komodo windows that are currently open.
Returns - Array
return true if this is the only Komodo window open
Returns - <Window>
An alternative version of window.openDialog() that does some fixups that Komodo wants in general.
Returns - window.openDialog.apply()
Open a window if no windows of windowType exist. Otherwise, bring the window of windowType to the front. Parameters for this function are identical to window.openDialog()
Returns - <Window>
Returns - Boolean
_calledInitializeEssentials - Boolean
restoredLeftTabBoxID - workspace.getStringPref()
showStartPage - Boolean
Returns - _restoreInProgress
restore all workspace preferences and state, open files and projects
currentWindow - ko.windowManager.getMainWindow()
idx - parseInt()
Returns - _saveInProgress
save all workspace preferences and state
importNS import one namespace into another
to - from[i]
include include an xtk namespace
load load a JavaScript file into the global namespace or a defined namespace
uri - String
uri to a JavaScript File
obj - Object
object to load the JavaScript into, if undefined loads into global namespace
debug - Number
mSelection - s
mSelectionCallback - f
mSingleSelect - Boolean
mSortType - Number
mTotalRows - Number
mTree - tree
rowCount
selection
selectionCallback
singleSelect
Returns - Boolean
Returns - String
Returns - Number
Returns - Number
Returns - Boolean
Returns - Boolean
Returns - Boolean
Returns - Boolean
Returns - Number
Returns - this
Returns - result
event - Event
Returns - result
A flat tree implementation. Sample Usage: XUL: <tree id="sample_tree" flex="1"> <treecols> <treecol id="sample_treecol_name" flex="1" label="Name"/> <splitter class="tree-splitter"/> <treecol id="sample_treecol_value" flex="1" label="Name"/> </treecols> <!-- Tree children are dynamically generated, from our own custom tree view --> <treechildren/> </tree> JavaScript: function SampleTreeView(initial_rows) { if (!initial_rows) { // Default value then this._rows = []; } else { this._rows = initial_rows; // The following two lines ensure proper inheritance (see Flanagan, p. 144). SampleTreeView.prototype = new xtk.dataTreeView(); SampleTreeView.prototype.constructor = SampleTreeView; // Override getCellText method for assigning the celltext SampleTreeView.prototype.getCellText = function(row, column) { // forRow is an item of the _rows array var forRow = this._rows[row]; switch (column.id) { case 'sample_treecol_name': return forRow[0]; case 'sample_treecol_value': return forRow[1]; return "(Unknown column: " + column.id + ")"; // Load the tree view and assign it to a tree element var sampleTreeView = new SampleTreeView(); var sampleTree = document.getElementById("sample_tree"); sampleTree.treeBoxObject.view = sampleTreeView; // SORTING: // Sorting capabilitilies are automatically included (string sorting by // default). These are all of the sort specific attributes: // <treecol sortActive="true|false" /> - marks the default sort column // <treecol sortDirection="ascending|descending|natural" /> // <treecol sortType="string" /> - String sorting (default when not specified) // <treecol sortType="numeric" /> - Numerical sorting // <treecol sortType="function:func_name" /> - Custom sort function: // where "func_name" is a function in the SampleTreeView class. The // signature looks like: "func_name(compare1, compare2)". Each // compare argument is an object that contains these attributes: // compare1.data -> data (string) return by getCellText. // compare1.row -> the real underlying row object. // compare1.oldindex -> original row index before the sort. // See the "_doDataCompare" function below for an example.
_debug - Number
_rows - Array
_sortCaseInsensitive - Boolean
_sortColumn - column
_sortDirection - Number
_unfilteredRows - this._rows
rowCount
rows
SORT_ASCENDING - Number
SORT_DESCENDING - Number
tree - out
text - text.toLowerCase()
Returns - String
Returns - Number
Returns - Boolean
Returns - Boolean
Returns - Boolean
Returns - Boolean
Returns - Boolean
Returns - Boolean
Returns - this
col - this.tree.columns.getFirstColumn().element
sortDirection - xtk.dataTreeView.SORT_ASCENDING
Useful clipboard functions.
Returns - supportCString
Add a text flavor (eg html or plain text) to a transferable object, if passed transferable is null or not defined a new one is created. Returns the tranferable object.
flavor - String
The mime-type flavor (eg "text/html").
text - String
The text to add.
transferable - Components.interfaces.nsITransferable
(Optional) The tranferable to use, if null a new object is created.
Returns - Components.interfaces.nsITransferable
Check if clipboard contains at least one of passed formats (ie flavor). Returns true if clipboard contains one of passed flavor, false otherwise.
flavors - Array
Mime-type strings (eg ["text/html", "text/unicode"])
Returns - Boolean
Check if clipboard contains text in HTML format. Returns true if clipboard contains HTML text, false otherwise.
Returns - Boolean
Copy to clipboard using a tranferable object, this allows to copy text in multiple format for example the same text as HTML and plain text.
transferable - Components.interfaces.nsITransferable
The tranferable object
Create a transferable object useful to copy multiple formats to clipboard and return with it.
Returns - Components.interfaces.nsITransferable
Get HTML source code from clipboard.
Returns - String
Get plain text from clipboard.
Returns - String
Returns - String
Set the clipboard to contain the plain text provided.
text - String
The text to copy to clipboard.
black - this.RGB()
blue - this.RGB()
brightness - Number
gamma - Number
green - this.RGB()
red - this.RGB()
topScale - Number
white - this.RGB()
yellow - this.RGB()
hexToLong Converts a color of the form #ffaabb to a long
hexstring - String
Returns - Number
Return whether this is a dark color.
hexstring - String
- Hexadecimal string of the color.
Returns - Boolean
Return whether this is a light color.
hexstring - String
- Hexadecimal string of the color.
Returns - Boolean
RGB covert rgb value into a long int
Returns - Number
Returns - Math.floor()
Returns - r
Returns - this.NanometerToRGB()
__END__
is this element or an ancestor focused?
Returns - Boolean
is the focused element, or it's ancestor a element with a matching localName?
localName - String
Returns - Element
Helper method to easily create a new DOM element with a bunch of (optional) attributes set. names to values.
name - String
- The element name to create.
attributes - Object
- (Optional) A map object containing attributes
Returns - DOMNode
Returns - _handlers[tooltipName]
LOG_CRITICAL - Number
LOG_DEBUG - Number
LOG_ERROR - Number
LOG_INFO - Number
LOG_NOTSET - Number
LOG_WARN - Number
name - name
Returns - _logs[name]
recurse - Number
compress - Boolean
level - Number
Returns - s
lastErrorMsg - str
level - Number
str - str