一些必不可少的Sublime Text 2插件当前访客身份：游客 [
已有文章 2110 篇
当前位置：
Sublime Text - 插件开发API参考
英文原文：
0人收藏此文章,
推荐于 2年前 (共 6 段, 翻译完成于 06-03) ()
参与翻译(2人)：
sublime模块
setTimeout(callback, delay)
在给定的延时delay（毫秒为单位）之后，调用给定的回调callback。具有相同延时值的Callbacks，会根据它们被加入的顺序来运行。从多线程中调用setTimeout方法是安全的.
statusMessage(string)
设置在状态栏上显示的信息。
errorMessage(string)
显示给用户一个错误对话框。
messageBox(string)
给用户显示一个消息盒子。
questionBox(string)
显示给用户一个yes / no消息盒子，如果用户选择yes则返回True.
返回指向应用选项的参考。
返回所有打开窗口的列表。
activeWindow()
返回最近使用过的窗口。
runCommand(string, &args&)
使用给定的参数（参数可选）运行已经命名的ApplicationCommand。
canRunCommand(string, &args&)
如果带有参数（参数可选）的命令是可用的，则返回True。
makeCommand(string, &args&)
从一个命令名字和参数中简历一个命令字符串。这个字符串适合作为showCompletions()的参数使用。
packagesPath()
返回包的路径。
installedPackagesPath()
返回所用用户*.sublime-package文件的路径。
getClipboard()
返回剪切板的内容。
setClipboard(string)
设置剪切板的内容。
getMacro()
返回当前宏。宏表示要运行的命令列表。
setMacro([string])
设置当前宏。
&翻译的不错哦!
sublime.View类
表示一个文本缓冲的一个视图。注意到多视图可能指向相同的缓冲，但是它们有各自独一无二的选项和布局。
返回唯一指定此视图的一个值。
bufferId()
返回唯一指定此视图下的缓冲的一个值。
fileName()
和缓冲关联的文件全名，如果在硬盘中不存在，则返回none.
分配给缓冲器的名字。
setName(name)
给缓冲器指派一个名字。
isLoading()
如果缓冲器还在从硬盘中加载数据或者还没有准备好使用，则返回ture.
如果缓冲器有任何没有保存的修改，则返回真。
isReadOnly()
如果缓冲器不能被修改，则返回真。
setReadOnly(value)
设置缓冲器的只读属性。
isScratch()
如果缓冲器是暂存缓冲器，则返回true。暂存缓冲器不会报告为dirty。
setScratch(value)
设置缓冲器的暂存属性
返回视图文件类型选项的一个引用。
返回包含视图的窗口的一个引用。
runCommand(string, &args&)
使用给定的参数（参数可选），运行指定的TextCommand。
canRunCommand(string, &args&)
如果带有指定参数（参数可选）的命令是可用的，则返回ture。
返回文件中字符数量。
substr(region)
以字符串形式，返回指定region的内容。
substr(point)
返回字符到point的左边。
insert(point, string)
插入缓冲器中给定字符串到point。返回插入字符的数量：如果tab建被转换到当前缓冲器空间中，可能很难实现此功能。
erase(region)
从缓冲器中清除当前region的内容。
replace(region, string)
使用给定的字符替换当前region内容。
返回选区的一个指引。
line(point)
返回包含此point的行。
line(region)
返回region的一个修改过的拷贝，以便它开始于一行的去起点。注意到它可能会跨过几行。
fullLine(point)
和line()类似,但是这个region包括尾部换行符。
fullLine(region)
和line()类似,但是这个region包括尾部换行符。
lines(region)
返回region中的一个行列表（排序过的）。
splitByNewlines(region)
拆分region，以便每个region已一行返回。
word(point)
返回包含point的单词。
word(region)
返回region的一个修改的拷贝，开始于一个单词的开头，结束于一个单词的结尾。注意到这可能会跨过几个单词。
find(pattern, fromPosition, &flags&)
返回匹配正则模式的第一个Region，从给定的point开始，如果没有找到则没有。可选的flags参数可能为sublime.LITERAL，sublime.IGNORECASE或则两者一起或的形式。
findAll(pattern, &flags&, &format&, &extractions&)
返回所有匹配正则模式的（非重叠）regions。可选的flags参数可能为sublime.LITERAL，sublime.IGNORECASE或者两者或的形式，然后所有匹配将会以格式化字符串被格式化，并放入取出的列表中。
rowcol(point)
(int, int)
计算关于point的，基于0的行和列的数量。
textPoint(row, col)
计算给定的，基于0的行和列的偏移字符。注意到'col'表示从一行开始的字符的数量。
extractScope(point)
返回给定point位置字符语法名称的范围。.
syntaxName(point)
返回给定point位置字符的语法名称。
matchSelector(point, selector)
如果选择器匹配给定point位置字符的语法名称，则返回true。
show(point, &showSurrounds&)
滚动视图以显示给定point。
show(region, &showSurrounds&)
滚动视图以显示给定 region。
show(regionSet, &showSurrounds&)
滚动视图以显示给定regionSet。
visibleRegion()
返回视图的当前可视区域。
extractCompletions(prefix, &point&)
基于缓冲器中的内容，返回给定prefix的自动补全。补全会根据使用频率来排序，并且如果支持的话，远离给定的point。
showCompletions(point, prefix, [completions])
在给定的point，带着给定的补全方式，显示自动补全菜单。如果选择输入，给定的prefix就会被选定的补全方式替代。每个补全方式，可能是一个字符串，或者包含一个表述的元组，或者要运行的命令。
addRegions(key, [regions], scope, &flags&)
向视图中添加一个region的集合。如果带着给定key的region集合已经存在，它们会被复写。scope被用于获取颜色写入这个region，它的名字为"comment"或者"string"。如果为空，则regions不会被写入。
可选flags参数是关于以下的，一个位逻辑的组合：
sublime.DRAW_EMPTY. 写入带有垂直条的空region。默认地，它们不会被写入。
sublime.HIDE_ON_MINIMAP. 不要再minimap中显示regions。
sublime.DRAW_EMPTY_AS_OVERWRITE. 写入带有水平条的空regions，而不是一个垂直条。
sublime.DRAW_OUTLINED. 绘制外框而不是填充。
sublime.PERSISTENT. 在session中保存regions。
getRegions(key)
返回所有key关联的regions。
eraseRegions(key)
移除指定regions。
setStatus(key, value)
添加状态key到视图中。值会在状态条中显示，通过key排序，所有状态为一个逗号分离的列表。设置值为空字符串将会清除状态。
getStatus(key)
返回先前所有和key关联的值。
eraseStatus(key)
清除是定状态。
&翻译的不错哦!
类 sublime.RegionSet
保存一组选区，并确保它们没有交叠，并按顺序排列：
去除所有选区。
add(region)
添加指定选区。若在选区组里已存在与之相交的选区，二者会合而为一。
addAll(regionSet)
添加指定选区组中所有选区到当前选区组中。
subtract(region)
从选区组中去除指定的选区。
contains(region)
判断指定选区是否包含在此选区组中。当包含时，返回true。
类 sublime.Region
表示缓冲的一个区域。当界定区域两个端点的a和b相等时，表示一个空选区。
Region(a, b)
用初始值a和b创建一个选区.
选区第一个端点。
选区第二个端点。可以比 a 小，形成一个逆向选区。
返回a和b的最小值。
返回a和b的最大值。
返回选区包含的字符数量。始终 &= 0。
当begin() == end()时为true，表示空选区。
cover(region)
返回一个跨越指定选区和当前选区的新选区。
intersection(region)
返回本选区与指定选区的交叠部分（作为一个新选区）。
intersects(region)
判断指定选区与本选区是否相交，当它们完全相同或者有部分相交时，返回true。
contains(region)
判断指定选区是否包含于本选区。
contains(point)
返回指定的位置是否处于本选区，即begin() &= point &= end()。
&翻译的不错哦!
sublime.Window类
返回窗口的唯一标识值。
创建一个新文件。返回视图为空，并且它的isLoaded方法返回true。
openFile(filename, &row&, &col&)
打开指定文件，返回相对应的视图。行和列都是可选的，并且可以被省略。如果文件已经被打开，它会在前端显示。注意到由于加载文件是异步的，在返回的视图上操作是不可能的，知道它的isLoading方法返回为false。
activeView()
返回当前编辑的视图。
activeViewInGroup(groupIdx)
返回给定group中活动的视图。
返回当前窗口中的视图列表。
viewsInGroup(groupIdx)
返回给定group中的视图列表。
focusView(view)
聚焦给定视图。
numGroups()
返回窗口中视图groups 的数量。
activeGroup()
返回当前选中group。
getViewPosition(view)
groupIdx, viewIdx
返回给定视图的group，以及group的索引。
setViewPosition(view, groupIdx, viewIdx)
移动视图到给定group和包含在group内的索引。
runCommand(string, &args&)
使用给定的参数（参数可选）运行指定的WindowCommand。
canRunCommand(string, &args&)
如果使用给定参数（参数可选）的命令是可用的，则返回true。
isFullScreen()
如果窗口当前为全屏模式，则返回true。
showQuickPanel(key, command, args, &displayArgs&, &flags&)
使用displayArgs参数，显示快速面板。当键入entry的时候，带有相应选择的显示参数的命令开始运行。如果异步地升级列表，则需要使用key，否则使其为空。displayArgs是可选参数，并且默认地为参数的列表。可选参数flags是一个位逻辑的组合:
sublime.QUICK_PANEL_FILES. 指明参数相对应的文件名字，这会改变它们如何被绘制。
sublime.QUICK_PANEL_MULTI_SELECT. 使得Ctrl+Enter选择快速面板上所有显示的条目，最大值为16。
sublime.QUICK_PANEL_NO_MULTI_SELECT_SAFETY_CHECK. 和上面联合使用，可以移除16条的限制。
sublime.QUICK_PANEL_UPDATE_ONLY. 当异步地升级面板的时候，如果面板已经被关闭，忽略升级调用。
sublime.QUICK_PANEL_MONOSPACE_FONT. 使用一个等宽字体去绘制快速面板。
showSelectPanel(displayArgs, onSelect, onCancel, flags, &key&, &selectedIndex&)
使用displayArgs参数显示快速面板。onSelect会运行于每一个被选择的条目，条目的索引作为一个参数被传入。如果面板没有选择任何条目而关闭，onCancel将会运行。
可选参数flags是一个位逻辑的组合:
sublime.SELECT_PANEL_FILES. 指明对应于文件名字的参数，这个参数改变它们如何绘制。
sublime.SELECT_PANEL_MULTI_SELECT.使得Ctrl+Enter选择快速面板上所有显示的条目，最大值为16。
sublime.SELECT_PANEL_NO_MULTI_SELECT_SAFETY_CHECK. 和上面联合使用，可以移除16条的限制。
sublime.SELECT_PANEL_UPDATE_ONLY. 当异步地升级面板的时候，如果面板已经被关闭，忽略升级调用。
sublime.SELECT_PANEL_MONOSPACE_FONT. 使用一个等宽字体去绘制快速面板。
如果异步地升级列表，则需要使用key，否则使其为空。
selectedIndex应当为最初选择条目的索引，或者省略。
showInputPanel(caption, initialText, onDone, onChange, onCancel)
显示输入面板，从用户收集一行输入。如果none，onDone和onChange应该是单字符串参数的函数。onCancel应当是一个无参数的函数。用于输入框架的视图被返回。
renderer()
返回活动Renderer的名字，"DirectX"或者"OpenGL"。
返回window的win32窗口手柄。
&翻译的不错哦!
sublime.Options类
getString(name)
返回指定选项的字符串值。
作为合适的类型返回指定选项。
get(name, default)
作为合适的类型返回指定选项，或者如果没有定义，则使用默认值。
set(name, value)
设置指定选项。仅仅接受原始的类型。
erase(name)
移除指定的选项。不要将它从任何父类选项移除。
如果指定选项存在于Options集合或者它的父类中一个，返回true。
sublimeplugin模块
(no methods)
sublimeplugin.Plugin类
注意到这些时间中的大多数，都是在视图之下的缓冲器触发的，并且这个方法仅仅被调用一次，并且将第一个视图作为参数。
Return Value
Description
onNew(view)
当一个新的缓冲器创建的时候调用。
onClone(view)
当从一个存在的视图克隆的时候调用。
onLoad(view)
当文件完成加载的时候调用。
onClose(view)
当一个视图关闭（注意，在相同缓冲器中可能存在其他视图）。
onPreSave(view)
仅仅在一个视图被保存的时候调用。
onPostSave(view)
一个视图已经被保存之后调用。
onModified(view)
对一个视图做出改变之后调用
onSelectionModified(view)
在一个视图中，片区被修改之后调用。
onActivated(view)
当一个视图获得输入聚焦的时候调用。
onProjectLoad(window)
一个工程被加载之后调用
onProjectClose(window)
一个工程被关闭之后调用
onQueryContext(view, key, value)
bool or none
当决定去触发一个和给定上下文key关联的key的时候调用。如果插件知道如何响应上下文，它应该返回True或False。如果这个上下文是未知的，它应当返回None。
&翻译的不错哦!
类 sublimeplugin.ApplicationCommand(插件)
运行命令时将调用此方法。
isEnabled(args)
当此时环境允许命令可以被调用，返回 true。默认返回true。
类 sublimeplugin.WindowCommand(Plugin)
run(window, args)
运行命令时将调用此方法。
isEnabled(window, args)
当此时环境允许命令可以被调用，返回 true。默认返回true。
类&sublimeplugin.TextCommand(Plugin)
run(view, args)
运行命令时将调用此方法。
isEnabled(view, args)
当此时环境允许命令可以被调用，返回 true。默认返回true。
&翻译的不错哦!
能不能 支持中文 好点。。。