Textadept
- Home |
- Download |
- Lua API |
- Source |
- Language Modules |
- Stats |
- Wiki |
- Mailing List
Contents
- buffer
- Fields
- additional_caret_fore
- additional_carets_blink
- additional_carets_visible
- additional_sel_alpha
- additional_sel_back
- additional_sel_fore
- additional_selection_typing
- all_lines_visible
- anchor
- annotation_lines
- annotation_style
- annotation_style_offset
- annotation_text
- annotation_visible
- auto_c_auto_hide
- auto_c_cancel_at_start
- auto_c_case_insensitive_behaviour
- auto_c_choose_single
- auto_c_current
- auto_c_current_text
- auto_c_drop_rest_of_word
- auto_c_fill_ups
- auto_c_ignore_case
- auto_c_max_height
- auto_c_max_width
- auto_c_order
- auto_c_separator
- auto_c_type_separator
- automatic_fold
- back_space_un_indents
- buffered_draw
- call_tip_back
- call_tip_fore
- call_tip_fore_hlt
- call_tip_position
- call_tip_use_style
- caret_fore
- caret_line_back
- caret_line_back_alpha
- caret_line_visible
- caret_line_visible_always
- caret_period
- caret_sticky
- caret_style
- caret_width
- char_at
- code_page
- column
- control_char_symbol
- current_pos
- cursor
- dirty
- edge_colour
- edge_column
- edge_mode
- encoding
- encoding_bom
- end_at_last_line
- end_styled
- eol_mode
- extra_ascent
- extra_descent
- filename
- first_visible_line
- fold_expanded
- fold_flags
- fold_level
- fold_parent
- h_scroll_bar
- highlight_guide
- hotspot_active_underline
- hotspot_single_line
- indent
- indentation_guides
- indic_alpha
- indic_fore
- indic_outline_alpha
- indic_style
- indic_under
- indicator_current
- indicator_value
- layout_cache
- length
- lexer
- lexer_language
- line_count
- line_end_position
- line_indent_position
- line_indentation
- line_state
- line_visible
- lines_on_screen
- main_selection
- margin_cursor_n
- margin_left
- margin_mask_n
- margin_options
- margin_right
- margin_sensitive_n
- margin_style
- margin_style_offset
- margin_text
- margin_type_n
- margin_width_n
- marker_alpha
- marker_back
- marker_back_selected
- marker_fore
- max_line_state
- modify
- mouse_dwell_time
- multi_paste
- multiple_selection
- overtype
- position_cache
- print_colour_mode
- print_magnification
- print_wrap_mode
- property
- property_expanded
- property_int
- punctuation_chars
- read_only
- rectangular_selection_anchor
- rectangular_selection_anchor_virtual_space
- rectangular_selection_caret
- rectangular_selection_caret_virtual_space
- rectangular_selection_modifier
- rgba_image_height
- rgba_image_scale
- rgba_image_width
- scroll_width
- scroll_width_tracking
- search_flags
- sel_alpha
- sel_eol_filled
- selection_empty
- selection_end
- selection_is_rectangle
- selection_mode
- selection_n_anchor
- selection_n_anchor_virtual_space
- selection_n_caret
- selection_n_caret_virtual_space
- selection_n_end
- selection_n_start
- selection_start
- selections
- style_at
- style_back
- style_bits
- style_bits_needed
- style_bold
- style_case
- style_changeable
- style_character_set
- style_eol_filled
- style_font
- style_fore
- style_hot_spot
- style_italic
- style_size
- style_size_fractional
- style_underline
- style_visible
- style_weight
- tab_indents
- tab_width
- tag
- target_end
- target_start
- text_length
- two_phase_draw
- undo_collection
- use_tabs
- v_scroll_bar
- view_eol
- view_ws
- virtual_space_options
- whitespace_chars
- whitespace_size
- word_chars
- wrap_indent_mode
- wrap_mode
- wrap_start_indent
- wrap_visual_flags
- wrap_visual_flags_location
- x_offset
- zoom
- Functions
- add_selection
- add_text
- allocate
- annotation_clear_all
- append_text
- auto_c_active
- auto_c_cancel
- auto_c_complete
- auto_c_pos_start
- auto_c_select
- auto_c_show
- auto_c_stops
- back_tab
- begin_undo_action
- brace_bad_light
- brace_bad_light_indicator
- brace_highlight
- brace_highlight_indicator
- brace_match
- call_tip_active
- call_tip_cancel
- call_tip_pos_start
- call_tip_set_hlt
- call_tip_show
- can_paste
- can_redo
- can_undo
- cancel
- change_lexer_state
- char_left
- char_left_extend
- char_left_rect_extend
- char_position_from_point
- char_position_from_point_close
- char_right
- char_right_extend
- char_right_rect_extend
- check_global
- choose_caret_x
- clear
- clear_all
- clear_all_cmd_keys
- clear_document_style
- clear_registered_images
- clear_selections
- close
- colourise
- contracted_fold_next
- convert_eo_ls
- copy
- copy_allow_line
- copy_range
- copy_text
- count_characters
- cut
- del_line_left
- del_line_right
- del_word_left
- del_word_right
- del_word_right_end
- delete
- delete_back
- delete_back_not_line
- delete_range
- doc_line_from_visible
- document_end
- document_end_extend
- document_start
- document_start_extend
- edit_toggle_overtype
- empty_undo_buffer
- encoded_from_utf8
- end_undo_action
- ensure_visible
- ensure_visible_enforce_policy
- expand_children
- find_column
- fold_all
- fold_children
- fold_line
- form_feed
- get_cur_line
- get_hotspot_active_back
- get_hotspot_active_fore
- get_last_child
- get_lexer
- get_line
- get_line_sel_end_position
- get_line_sel_start_position
- get_sel_text
- get_style_name
- get_text
- goto_line
- goto_pos
- grab_focus
- hide_lines
- hide_selection
- home
- home_display
- home_display_extend
- home_extend
- home_rect_extend
- home_wrap
- home_wrap_extend
- indicator_all_on_for
- indicator_clear_range
- indicator_end
- indicator_fill_range
- indicator_start
- indicator_value_at
- insert_text
- line_copy
- line_cut
- line_delete
- line_down
- line_down_extend
- line_down_rect_extend
- line_duplicate
- line_end
- line_end_display
- line_end_display_extend
- line_end_extend
- line_end_rect_extend
- line_end_wrap
- line_end_wrap_extend
- line_from_position
- line_length
- line_scroll
- line_scroll_down
- line_scroll_up
- line_transpose
- line_up
- line_up_extend
- line_up_rect_extend
- lines_join
- lines_split
- lower_case
- margin_text_clear_all
- marker_add
- marker_add_set
- marker_define
- marker_define_pixmap
- marker_define_rgba_image
- marker_delete
- marker_delete_all
- marker_delete_handle
- marker_enable_highlight
- marker_get
- marker_line_from_handle
- marker_next
- marker_previous
- marker_symbol_defined
- move_caret_inside_view
- move_selected_lines_down
- move_selected_lines_up
- new
- new_line
- page_down
- page_down_extend
- page_down_rect_extend
- page_up
- page_up_extend
- page_up_rect_extend
- para_down
- para_down_extend
- para_up
- para_up_extend
- paste
- point_x_from_position
- point_y_from_position
- position_after
- position_before
- position_from_line
- position_from_point
- position_from_point_close
- redo
- register_image
- register_rgba_image
- reload
- replace_sel
- replace_target
- replace_target_re
- rotate_selection
- save
- save_as
- scroll_caret
- scroll_range
- scroll_to_end
- scroll_to_start
- search_anchor
- search_in_target
- search_next
- search_prev
- select_all
- selection_duplicate
- set_chars_default
- set_empty_selection
- set_encoding
- set_fold_margin_colour
- set_fold_margin_hi_colour
- set_hotspot_active_back
- set_hotspot_active_fore
- set_length_for_encode
- set_lexer
- set_save_point
- set_sel
- set_sel_back
- set_sel_fore
- set_selection
- set_styling
- set_text
- set_visible_policy
- set_whitespace_back
- set_whitespace_fore
- set_x_caret_policy
- set_y_caret_policy
- show_lines
- start_styling
- stuttered_page_down
- stuttered_page_down_extend
- stuttered_page_up
- stuttered_page_up_extend
- style_clear_all
- style_reset_default
- swap_main_anchor_caret
- tab
- target_as_utf8
- target_from_selection
- text_height
- text_range
- text_width
- toggle_caret_sticky
- toggle_fold
- undo
- upper_case
- user_list_show
- vc_home
- vc_home_display
- vc_home_display_extend
- vc_home_extend
- vc_home_rect_extend
- vc_home_wrap
- vc_home_wrap_extend
- vertical_centre_caret
- visible_from_doc_line
- word_end_position
- word_left
- word_left_end
- word_left_end_extend
- word_left_extend
- word_part_left
- word_part_left_extend
- word_part_right
- word_part_right_extend
- word_right
- word_right_end
- word_right_end_extend
- word_right_extend
- word_start_position
- wrap_count
- zoom_in
- zoom_out
- Fields
buffer
A Textadept buffer object.
Be careful when storing references to a buffer object because if you attempt
call a buffer function with a non-global buffer, you will get an error. See
check_global()
for more information.
Fields
additional_caret_fore
(number)
The foreground color, in “0xBBGGRR” format, of additional carets.
additional_carets_blink
(bool)
Allow additional carets to blink.
The default value is true
.
additional_carets_visible
(bool)
Display additional carets.
The default value is true
.
additional_sel_alpha
(number)
The alpha value, ranging from 0
(transparent) to 255
(opaque), of
additional selections.
The default value is 256
, for no alpha.
additional_sel_back
(number)
The background color, in “0xBBGGRR” format, of additional selections.
This field has no effect when calling buffer:set_sel_back(false, ...)
.
additional_sel_fore
(number)
The foreground color, in “0xBBGGRR” format, of additional selections.
This field has no effect when calling buffer:set_sel_fore(false, ...)
.
additional_selection_typing
(bool)
Type into multiple selections.
The default value is false
.
all_lines_visible
(bool, Read-only)
Whether or not all lines in the buffer are visible.
anchor
(number)
The position of the beginning of the selected text.
annotation_lines
(table, Read-only)
Table of the number of annotation lines for line numbers starting from zero.
annotation_style
(table)
Table of style numbers for annotations for line numbers starting from zero. Only some style attributes are active in annotations: font, size/size_fractional, bold/weight, italics, fore, back, and character_set.
annotation_style_offset
(number)
The beginning of the range of style numbers used for annotations.
Annotation styles may be completely separated from standard text styles by
setting a style offset. For example, setting this to 512
would allow the
annotation styles to be numbered from 512
upto 767
so they do not
overlap styles set by lexers (or margins if margins offset is 256
). Each
style number set with annotation_style
has the offset added before
looking up the style.
The default value is 0
.
annotation_text
(table)
Table of annotation text for line numbers starting from zero.
annotation_visible
(number)
The annotation visibility mode.
_SCINTILLA.constants.ANNOTATION_HIDDEN
(0) Annotations are invisible._SCINTILLA.constants.ANNOTATION_STANDARD
(1) Draw annotations left-justified with no decoration._SCINTILLA.constants.ANNOTATION_BOXED
(2) Indent annotations to match the text and outline with a box.
The default value is 0
.
auto_c_auto_hide
(bool)
Automatically hide the autocompletion list when no entries match typed
text.
The default value is true
.
auto_c_cancel_at_start
(bool)
Cancel autocompletion when backspacing to a position before where
autocompletion started or before the word being completed.
The default value is true
, to cancel when backspacing before where
autocompletion started.
auto_c_case_insensitive_behaviour
(number)
The behavior setting for case insensitive autocompletion when
buffer.auto_c_ignore_case
is true
.
_SCINTILLA.constants.SC_CASEINSENSITIVEBEHAVIOR_RESPECTCASE
(0) Prefer to select case-sensitive matches._SCINTILLA.constants.SC_CASEINSENSITIVEBEHAVIOR_IGNORECASE
(1) No preference.
The default value is 0
.
auto_c_choose_single
(bool)
Automatically choose the item in a single-item autocompletion list.
The default value is false
.
auto_c_current
(number, Read-only)
The index of the currently selected item in the autocompletion list.
auto_c_current_text
(string, Read-only)
The text of the currently selected item in the autocompletion list.
auto_c_drop_rest_of_word
(bool)
Delete word characters after autocompleted text.
The default value is false
.
auto_c_fill_ups
(string, Write-only)
A set of characters that choose the currently selected item in an autocompletion list when typed. The default value is an empty string.
auto_c_ignore_case
(bool)
Ignore case when searching an autocompletion list for matches.
The default value is false
.
auto_c_max_height
(number)
The maximum number of items to show in autocompletion and user lists. The
default value is 5
.
auto_c_max_width
(number)
The maximum number of characters per row to show in autocompletion and user
lists.
The default value is 0
, which automatically sizes the list to fit the
longest item.
auto_c_order
(number)
The order setting for autocompletion lists.
_SCINTILLA.constants.SC_ORDER_PRESORTED
(0) Autocompletion lists passed tobuffer.auto_c_show
are in sorted alphabetical order._SCINTILLA.constants.SC_ORDER_PERFORMSORT
(1) Scintilla should sort autocompletion lists passed tobuffer.auto_c_show
._SCINTILLA.constants.SC_ORDER_CUSTOM
(2) Autocompletion lists passed tobuffer.auto_c_show
are sorted in a custom order.
The default value is 0
.
auto_c_separator
(number)
The character byte that separates autocompletion list items.
The default value is 32
(‘ ’).
auto_c_type_separator
(number)
The character byte that separates autocompletion list items and their
image types.
Autocompletion list items can display both an image and text. Register
images and their types using buffer:register_image()
or buffer:register_rgba_image()
before appending
image types to list items after type separator characters.
The default value is 63 (‘?’).
automatic_fold
(number)
Bit-mask of options for automatic folding behavior.
_SCINTILLA.constants.SC_AUTOMATICFOLD_SHOW
(1) Automatically show lines as needed._SCINTILLA.constants.SC_AUTOMATICFOLD_CLICK
(2) Handle clicks in the fold margin automatically._SCINTILLA.constants.SC_AUTOMATICFOLD_CHANGE
(4) Show lines as needed when the fold structure changes.
The default value is 0
.
back_space_un_indents
(bool)
Un-indent text when backspacing within indentation.
The default value is false
.
buffered_draw
(bool)
Buffer drawing to avoid flickering.
Buffering draws each line of text into a bitmap buffer before drawing the
bitmap to the screen.
The default value is true
.
call_tip_back
(number, Write-only)
The background color, in “0xBBGGRR” format, for a call tip.
call_tip_fore
(number, Write-only)
The foreground color, in “0xBBGGRR” format, for a call tip.
call_tip_fore_hlt
(number, Write-only)
The foreground color, in “0xBBGGRR” format, for the highlighted part of a call tip.
call_tip_position
(boolean)
Display the call tip above or below the text.
The default value is false
to display the call tip below the text.
call_tip_use_style
(number)
The size in pixels of tab characters in call tips.
When non-zero, also enables the use of _SCINTILLA.constants.STYLE_CALLTIP
instead of _SCINTILLA.constants.STYLE_DEFAULT
for call tip styles.
The default value is 0
, which does not treat tab characters specially.
caret_fore
(number)
The foreground color, in “0xBBGGRR” format, of the caret.
caret_line_back
(number)
The background color, in “0xBBGGRR” format, of the line containing the caret.
caret_line_back_alpha
(number)
The background alpha value, ranging from 0
(transparent) to 255
(opaque), of the caret line.
The default value is 256
, for no alpha.
caret_line_visible
(bool)
Color the background of the line containing the caret a different color.
The default value is false
.
caret_line_visible_always
(bool)
Always show the caret line, even when the window is not in focus.
The default value is false
, showing the line only when the window is in
focus.
caret_period
(number)
The time in milliseconds between caret blinks.
A value of 0
stops blinking.
The default value is 500
.
caret_sticky
(number)
The preferred horizontal position of the caret when moving between lines.
_SCINTILLA.constants.SC_CARETSTICKY_OFF
(0) Use the same position as on the previous line._SCINTILLA.constants.SC_CARETSTICKY_ON
(1) Use the last position the caret was moved to via the mouse, left/right arrow keys, home/end keys, etc. Typing text does not affect the position._SCINTILLA.constants.SC_CARETSTICKY_WHITESPACE
(2) Use the same position as on the previous line, but prior to any inserted indentation.
The default value is 0
.
caret_style
(number)
The style of caret to draw.
_SCINTILLA.constants.CARETSTYLE_INVISIBLE
(0) No caret._SCINTILLA.constants.CARETSTYLE_LINE
(1) A line caret._SCINTILLA.constants.CARETSTYLE_BLOCK
(2) A block caret.
The default value is 1
.
caret_width
(number)
The pixel width of the caret in insert mode, either 0
, 1
, 2
, or 3
,
and only applicable to line carets.
The default value is 1
.
char_at
(table, Read-only)
Table of character bytes at positions in the buffer starting from zero.
code_page
(number)
The code page used to interpret buffer bytes as characters.
0
None.932
Japanese Shift-JIS.936
Simplified Chinese GBK.949
Korean Unified Hangul Code.950
Traditional Chinese Big5.1361
Korean Johab._SCINTILLA.constants.SC_CP_UTF8
(65001) UTF-8.
The default value is 0
.
column
(table, Read-only)
Table of column numbers, taking tab widths into account, for positions in the buffer starting from zero.
control_char_symbol
(number)
The byte value of the character displayed in place of control characters,
characters whose byte values are less than 32. Values less than 32 dispay
ASCII mnemonics instead.
The default value is 0
.
current_pos
(number)
The position of the caret. When set, does not scroll the caret into view.
cursor
(number)
The cursor type.
_SCINTILLA.constants.SC_CURSORNORMAL
(-1) The normal cursor._SCINTILLA.constants.SC_CURSORWAIT
(4) The wait cursor.
The default value is -1
.
dirty
(bool)
Whether or not the buffer has unsaved changes.
Unlike buffer.modify
, this field is accessible from any
buffer, not just the global one.
edge_colour
(number)
The color, in “0xBBGGRR” format, used for the long line marker.
edge_column
(number)
The column number to display the long line marker at.
edge_mode
(number)
The long line edge mode.
_SCINTILLA.constants.EDGE_NONE
(0) Long lines are not marked._SCINTILLA.constants.EDGE_LINE
(1) Draw a vertical line whose color isbuffer.edge_colour
at columnbuffer.edge_column
._SCINTILLA.constants.EDGE_BACKGROUND
(2) Change the background color of characters after columnbuffer.edge_column
tobuffer.edge_colour
.
encoding
(string or nil)
The string encoding of the file on the hard drive or nil
for binary
files.
encoding_bom
(string)
The byte-order mark, if any, of the file encoding.
end_at_last_line
(bool)
Disable scrolling past the last line.
The default value is true
.
end_styled
(number, Read-only)
The position of the last correctly styled character.
eol_mode
(number)
The current end of line mode.
_SCINTILLA.constants.SC_EOL_CRLF
(0) “CR+LF” (“\r\n”)._SCINTILLA.constants.SC_EOL_CR
(1) “CR” (“\r”)._SCINTILLA.constants.SC_EOL_LF
(2) “LF” (“\n”).
The default value is 0
on Windows platforms, 2
otherwise.
extra_ascent
(number)
The amount of pixel padding above line text.
The default value is 0
.
extra_descent
(number)
The amount of pixel padding below line text.
The default is 0
.
filename
(string)
The UTF-8-encoded absolute path to the file associated with the buffer.
Use string.iconv()
and _G._CHARSET
for charset conversions.
first_visible_line
(number)
The line number of the line at the top of the view, starting from zero.
fold_expanded
(table)
Table of flags indicating whether or not folds are expanded for line
numbers starting from zero.
Setting expanded fold states does not toggle folds; it only updates fold
margin markers. Use buffer:toggle_fold()
instead.
fold_flags
(number)
Bit-mask of options for drawing folding lines.
_SCINTILLA.constants.SC_FOLDFLAG_LINEBEFORE_EXPANDED
(2) Draw lines above expanded folds._SCINTILLA.constants.SC_FOLDFLAG_LINEBEFORE_CONTRACTED
(4) Draw lines above collapsed folds._SCINTILLA.constants.SC_FOLDFLAG_LINEAFTER_EXPANDED
(8) Draw lines below expanded folds._SCINTILLA.constants.SC_FOLDFLAG_LINEAFTER_CONTRACTED
(16) Draw lines below collapsed folds.
The default value is 0
.
fold_level
(table)
Table of fold level bit-masks for line numbers starting from zero. Fold level masks are composed of an integer level combined with any of the following bits:
_SCINTILLA.constants.SC_FOLDLEVELBASE
(0x400) The initial fold level._SCINTILLA.constants.SC_FOLDLEVELWHITEFLAG
(0x1000) The line is blank._SCINTILLA.constants.SC_FOLDLEVELHEADERFLAG
(0x2000) The line is a header, or fold point.
fold_parent
(table, Read-only)
Table of parent line numbers (fold points) for child line numbers starting
from zero.
A line number of -1
means no line was found.
h_scroll_bar
(bool)
Display the horizontal scroll bar.
The default value is true
.
highlight_guide
(number)
The indentation guide column number to highlight, or 0
to stop
highlighting.
hotspot_active_underline
(bool)
Underline active hotspots.
The default value is true
.
hotspot_single_line
(bool)
Limit hotspots to a single line.
The default value is true
.
indent
(number)
The number of spaces used for one level of indentation.
The default value is 0
, which matches the tab size.
indentation_guides
(number)
The indentation guide drawing mode. Indentation guides are dotted vertical lines that appear within indentation whitespace at each level of indentation.
_SCINTILLA.constants.SC_IV_NONE
(0) Guides are not drawn._SCINTILLA.constants.SC_IV_REAL
(1) Draw guides only within indentation whitespace._SCINTILLA.constants.SC_IV_LOOKFORWARD
(2) Draw guides beyond the current line up to the level of the next non-empty line, but with an additional level if the previous non-empty line is a fold header._SCINTILLA.constants.SC_IV_LOOKBOTH
(3) Draw guides beyond the current line up to either the level of the previous or next non-empty line, whichever is greater.
The default value is 0
.
indic_alpha
(table)
Table of fill color alpha values, ranging from 0
(transparent) to 255
(opaque), for indicator numbers from 0
to 31
whose styles are either
INDIC_ROUNDBOX
, INDIC_STRAIGHTBOX
, or INDIC_DOTBOX
.
The default values are 256
, for no alpha.
indic_fore
(table)
Table of foreground colors, in “0xBBGGRR” format, for indicator numbers
from 0
to 31
.
indic_outline_alpha
(table)
Table of outline color alpha values, ranging from 0
(transparent) to
255
(opaque), for indicator numbers from 0
to 31
whose styles are
either INDIC_ROUNDBOX
, INDIC_STRAIGHTBOX
, or INDIC_DOTBOX
.
The default values are 256
, for no alpha.
indic_style
(table)
Table of styles for indicator numbers from 0
to 31
.
_SCINTILLA.constants.INDIC_PLAIN
(0) An underline._SCINTILLA.constants.INDIC_SQUIGGLE
(1) A squiggly underline 3 pixels in height._SCINTILLA.constants.INDIC_TT
(2) A line of small ’T' shapes._SCINTILLA.constants.INDIC_DIAGONAL
(3) Diagonal hatching._SCINTILLA.constants.INDIC_STRIKE
(4) Strike out._SCINTILLA.constants.INDIC_HIDDEN
(5) Invisible._SCINTILLA.constants.INDIC_BOX
(6) A rectangle around the text._SCINTILLA.constants.INDIC_ROUNDBOX
(7) A translucent rectangle with rounded corners around the text. Usebuffer.indic_alpha
andbuffer.indic_outline_alpha
to set the fill and outline transparency, respectively. Their default values are30
and50
._SCINTILLA.constants.INDIC_STRAIGHTBOX
(8) Similar toINDIC_ROUNDBOX
but with sharp corners._SCINTILLA.constants.INDIC_DASH
(9) A dashed underline._SCINTILLA.constants.INDIC_DOTS
(10) A dotted underline._SCINTILLA.constants.INDIC_SQUIGGLELOW
(11) A squiggly underline 2 pixels in height._SCINTILLA.constants.INDIC_DOTBOX
(12) Similar toINDIC_STRAIGHTBOX
but with a dotted outline. Translucency alternates betweenbuffer.indic_alpha
andbuffer.indic_outline_alpha
starting with the top-left pixel._SCINTILLA.constants.INDIC_SQUIGGLEPIXMAP
(13) Identical toINDIC_SQUIGGLE
but draws faster by using a pixmap instead of multiple line segments._SCINTILLA.constants.INDIC_COMPOSITIONTHICK
(14) A 2-pixel thick underline at the bottom of the line inset by 1 pixel on on either side. Similar in appearance to Asian language input composition.
Use _SCINTILLA.next_indic_number()
for custom indicators.
indic_under
(table)
Table of flags indicating whether or not to draw indicators over text or
under it for indicator numbers from 0
to 31
.
For values to be true
, buffer.two_phase_draw
must be
true
.
The default values are false
for drawing indicators over text.
indicator_current
(number)
The indicator number in the range of 0
to 31
used by
buffer:indicator_fill_range()
and
buffer:indicator_clear_range()
.
indicator_value
(number)
The indicator value used for
buffer:indicator_fill_range()
.
Currently, all values are drawn the same, but it may be possible to draw
different values in different styles in the future.
layout_cache
(number)
The layout cache mode.
_SCINTILLA.constants.SC_CACHE_NONE
(0) No lines are cached._SCINTILLA.constants.SC_CACHE_CARET
(1) Cache the line containing the caret._SCINTILLA.constants.SC_CACHE_PAGE
(2) Cache visible lines._SCINTILLA.constants.SC_CACHE_DOCUMENT
(3) Cache all lines in the buffer.
The default value is 1
.
length
(number, Read-only)
The number of bytes in the buffer.
lexer
(number)
The numeric ID of the Scintilla lexer used by the buffer.
lexer_language
(string)
The name of the Scintilla lexer used by the buffer.
You probably want to use buffer:get_lexer()
instead.
line_count
(number, Read-only)
The number of lines in the buffer. There is always at least one.
line_end_position
(table, Read-only)
Table of positions at the ends of lines, but before any end of line characters, for line numbers starting from zero.
line_indent_position
(table, Read-only)
Table of positions at the ends of line indentation for line numbers starting from zero.
line_indentation
(table)
Table of line indentation amounts, measured in character columns, for line numbers starting from zero.
line_state
(table)
Table of integer line states for line numbers starting from zero. Line states are used for storing longer lived parse states per line. They are available in addition to the 8 bits of styling information per character.
line_visible
(table, Read-only)
Table of flags indicating whether or not lines are visible for line numbers starting from zero.
lines_on_screen
(number, Read-only)
The number of completely visible lines in the view. It is possible to have a partial line visible at the bottom of the view.
main_selection
(number)
The main, or most recent, selection. Only an existing selection can be made main.
margin_cursor_n
(table)
Table of cursors shown for margin numbers from zero to four.
_SCINTILLA.constants.SC_CURSORARROW
(2) Normal arrow cursor._SCINTILLA.constants.SC_CURSORREVERSEARROW
(7) Reversed arrow cursor.
The default values are 7
.
margin_left
(number)
The size in pixels of the left margin of the buffer text.
The default value is 1
.
margin_mask_n
(table)
Table of marker bit-masks for showing margin markers for margin numbers
from zero to four.
The default values are 0
, 0x1FFFFFF
, 0
, 0
, and 0
, for a line
margin and logical marker margin.
margin_options
(number)
A bit-mask of margin option settings.
_SCINTILLA.constants.SC_MARGINOPTION_NONE
(0) None._SCINTILLA.constants.SC_MARGINOPTION_SUBLINESELECT
(1) Select only the sub-line of the wrapped line on margin click.
The default value is 0
.
margin_right
(number)
The size in pixels of the right margin of the buffer text.
The default value is 1
.
margin_sensitive_n
(table)
Table of flags indicating whether or not mouse clicks in margins emit
MARGIN_CLICK
events for margin numbers from zero to four.
The default values are false
.
margin_style
(table)
Table of style numbers for text margin line numbers starting from zero. Only some style attributes are active in text margins: font, size/size_fractional, bold/weight, italics, fore, back, and character_set.
margin_style_offset
(number)
The beginning of the range of style numbers used for margin text.
Margin styles may be completely separated from standard text styles by
setting a style offset. For example, setting this to 256
would allow the
margin styles to be numbered from 256
upto 511
so they do not overlap
styles set by lexers. Each style number set with margin_style
has
the offset added before looking up the style.
margin_text
(table)
Table of text in the text margin for line numbers starting from zero.
margin_type_n
(table)
Table of margin types for margin numbers from zero to four.
_SCINTILLA.constants.SC_MARGIN_SYMBOL
(0) A symbol margin._SCINTILLA.constants.SC_MARGIN_NUMBER
(1) A line number margin._SCINTILLA.constants.SC_MARGIN_BACK
(2) A symbol margin whose background color matches the default text background color._SCINTILLA.constants.SC_MARGIN_FORE
(3) A symbol margin whose foreground color matches the default text foreground color._SCINTILLA.constants.SC_MARGIN_TEXT
(4) A text margin._SCINTILLA.constants.SC_MARGIN_RTEXT
(5) A right-justified text margin.
The default values are true
, false
, false
, false
, and false
, for
a line number margin and symbol margins.
margin_width_n
(table)
Table of margin widths in pixels for margin numbers from zero to four.
marker_alpha
(table, Write-only)
Table of alpha values, ranging from 0
(transparent) to 255
(opaque),
used for markers drawn in the text area, not the margin, for markers
numbers from 0
to 31
.
The default values are 256
, for no alpha.
marker_back
(table, Write-only)
Table of background colors, in “0xBBGGRR” format, used for marker numbers
from 0
to 31
.
marker_back_selected
(table, Write-only)
Table of background colors, in “0xBBGGRR” format, used for markers whose
folding blocks are selected for marker numbers from 0
to 31
.
The default values are 0x0000FF
.
marker_fore
(table, Write-only)
Table of foreground colors, in “0xBBGGRR” format, used for marker numbers
from 0
to 31
.
max_line_state
(number, Read-only)
The last line number with a non-zero line state.
modify
(bool)
Whether or not the buffer has unsaved changes.
Unlike buffer.dirty
, this field is accessible only from the
global buffer.
mouse_dwell_time
(number)
The number of milliseconds the mouse must idle in order to generate a
DWELL_START
event, or _SCINTILLA.constants.SC_TIME_FOREVER
to never
generate one.
multi_paste
(number)
The multiple selection paste mode.
_SCINTILLA.constants.SC_MULTIPASTE_ONCE
(0) Paste into only the main selection._SCINTILLA.constants.SC_MULTIPASTE_EACH
(1) Paste into all selections.
The default value is 0
.
multiple_selection
(bool)
Enable multiple selection.
The default value is false
.
overtype
(bool)
Enable overtype mode, where typed characters overwrite existing ones.
The default value is false
.
position_cache
(number)
The number of entries in the position cache.
The position cache stores position information for short runs of text so
that their layout can be determined more quickly if the run recurs.
The default value is 1024
.
print_colour_mode
(number)
The print color mode.
_SCINTILLA.constants.SC_PRINT_NORMAL
(0) Print with the current set of colors._SCINTILLA.constants.SC_PRINT_INVERTLIGHT
(1) Print on a white background with the light values of the current color set. This mode is good for a dark background color._SCINTILLA.constants.SC_PRINT_BLACKONWHITE
(2) Print black text on a white background._SCINTILLA.constants.SC_PRINT_COLOURONWHITE
(3) Print on a white background with the current color set._SCINTILLA.constants.SC_PRINT_COLOURONWHITEDEFAULTBG
(4) Print on a white background with the current color set except for line numbers which use their own background color.
print_magnification
(number)
The number of points to add to the size of each font when printing.
Negative values are allowed.
The default value is 0
.
print_wrap_mode
(number)
The print line wrap mode.
_SCINTILLA.constants.SC_WRAP_NONE
(0) Truncate long lines._SCINTILLA.constants.SC_WRAP_WORD
(1) Wrap long lines at word boundaries if possible._SCINTILLA.constants.SC_WRAP_CHAR
(2) Wrap long lines at character boundaries.
property
(table)
Map of key-value string pairs used by lexers.
property_expanded
(table, Read-only)
Map of key-value string pairs used by lexers with $()
variable
replacement performed in values.
property_int
(table, Read-only)
Map of key-value pairs used by lexers with values interpreted as numbers,
or 0
if not found.
punctuation_chars
(string)
The set of characters considered to be punctuation characters.
Set this only after setting buffer.word_chars
.
The default value is a string containing all characters not considered to
be whitespace or word characters.
read_only
(bool)
Whether or not the buffer is read-only.
The default value is false
.
rectangular_selection_anchor
(number)
The position of the anchor of the rectangular selection.
rectangular_selection_anchor_virtual_space
(number)
The amount of virtual space for the anchor of the rectangular selection.
rectangular_selection_caret
(number)
The position of the caret of the rectangular selection.
rectangular_selection_caret_virtual_space
(number)
The amount of virtual space for the caret of the rectangular selection.
rectangular_selection_modifier
(number)
The modifier key used in combination with a mouse drag to create a rectangular selection.
_SCINTILLA.constants.SCMOD_CTRL
(2) The “Control” modifier key._SCINTILLA.constants.SCMOD_ALT
(4) The “Alt” modifier key._SCINTILLA.constants.SCMOD_SUPER
(8) The “Super” modifier key, usually defined as the left “Windows” or “Command” key.
The default value is 2
.
rgba_image_height
(number)
The height for an RGBA image to be defined using
buffer:marker_define_rgba_image()
.
rgba_image_scale
(number)
The scale factor in percent for an RGBA image to be defined using
buffer:marker_define_rgba_image()
.
This is useful on OSX with a retina display where each display unit is 2
pixels: use a factor of 200
so that each image pixel is dsplayed using a
screen pixel. The default scale, 100
, will stretch each image pixel to
cover 4 screen pixels on a retina display.
rgba_image_width
(number)
The width for an RGBA image to be defined using
buffer:marker_define_rgba_image()
and
buffer:register_rgba_image()
.
scroll_width
(number)
The assumed buffer width for horizontal scrolling purposes.
For performance, the view does not measure the display width of the buffer
to determine the properties of the horizontal scroll bar, but uses an
assumed width instead. To ensure the width of the currently visible lines
can be scrolled use
buffer.scroll_width_tracking
.
The default value is 2000
.
scroll_width_tracking
(bool)
Set the scroll width to the maximum width of a displayed line beyond
buffer.scroll_width
.
The default value is false
.
search_flags
(number)
The bit-mask of search flags used by
buffer:search_in_target()
.
_SCINTILLA.constants.SCFIND_WHOLEWORD
(2) Match text surrounded by non-word characters._SCINTILLA.constants.SCFIND_MATCHCASE
(4) Match text case sensitively._SCINTILLA.constants.SCFIND_WORDSTART
(0x00100000) Match text when the previous character is a non-word character._SCINTILLA.constants.SCFIND_REGEXP
(0x00200000) Interpret the search string as a regular expression._SCINTILLA.constants.SCFIND_POSIX
(0x00400000) Interpret ‘(’ and ‘)’ as tags instead of “\(” and “\)” in a regular expression.
The default value is 0
.
Regular expression characters recognized are:
.
Matches any character.[set]
Matches any character in set, including ranges (e.g.[A-Za-z]
).[^set]
Matches the complement of set.*
Matches zero or more of the previous match.+
Matches one or more of the previous match.\<
Matches the beginning of a word.buffer.word_chars
defines word characters.\>
Matches the end of a word.buffer.word_chars
defines word characters.^
Matches the start of a line unless inside a set.$
Matches the end of a line unless inside a set.\(
The beginning of a tagged matching region.\)
The end of a tagged matching region.\n
The matched text of the nth tagged region. In replacement text, “\0” is all matched text.\x
Represents character x, ignoring any special meaning it may have by itself.
sel_alpha
(number)
The alpha value, ranging from 0
(transparent) to 255
(opaque), of the
selection.
The default value is 256
, for no alpha.
sel_eol_filled
(bool)
Extend the selection to the right margin of the view.
The default value is false
.
selection_empty
(bool, Read-only)
Whether or not no text is selected.
selection_end
(number)
The position of the end of the selected text. When set, becomes the current position, but is not scrolled into view.
selection_is_rectangle
(bool, Read-only)
Whether or not the selection is a rectangular selection.
selection_mode
(number)
The selection mode.
_SCINTILLA.constants.SC_SEL_STREAM
(0) Character selection._SCINTILLA.constants.SC_SEL_RECTANGLE
(1) Rectangular selection._SCINTILLA.constants.SC_SEL_LINES
(2) Line selection._SCINTILLA.constants.SC_SEL_THIN
(3) Thin rectangular selection. This is the mode after a rectangular selection has been typed into and ensures that no characters are selected.
When set, caret movement alters the selected text until this field is set
again to the same value or buffer:cancel()
is called.
selection_n_anchor
(table)
Table of anchor positions for existing selections numbered from zero, the main selection.
selection_n_anchor_virtual_space
(table)
Table of the amount of virtual space for anchors for existing selections numbered from zero, the main selection.
selection_n_caret
(table)
Table of caret positions for existing selections numbered from zero, the main selection.
selection_n_caret_virtual_space
(table)
Table of the amount of virtual space for carets for existing selections numbered from zero, the main selection.
selection_n_end
(table)
Table of positions at the end of existing selections numbered from zero, the main selection.
selection_n_start
(table)
Table of positions at the beginning of existing selections numbered from zero, the main selection.
selection_start
(number)
The position of the beginning of the selected text. When set, becomes the anchor, but is not scrolled into view.
selections
(number, Read-only)
The number of active selections.
style_at
(table, Read-only)
Table of style bytes at positions in the buffer starting from zero.
style_back
(table)
Table of background colors, in “0xBBGGRR” format, for style numbers from
0
to 255
.
style_bits
(number)
The number of bits in an 8-bit style byte to use for styling.
The number of styling bits required by the current lexer is
buffer.style_bits_needed
.
The default value is 5
.
style_bits_needed
(number, Read-only)
The number of styling bits required by the current lexer.
style_bold
(table)
Table of flags indicating whether or not text within styles has a bold font
face for style numbers from 0
to 255
.
The default values are false
.
style_case
(table)
Table of letter case modes for text within styles for style numbers from
0
to 255
.
_SCINTILLA.constants.SC_CASE_MIXED
(0) Display text in mixed case._SCINTILLA.constants.SC_CASE_UPPER
(1) Display text in upper case._SCINTILLA.constants.SC_CASE_LOWER
(2) Display text in lower case.
The default values are 0
.
style_changeable
(table)
Table of flags indicating whether or not text within styles is changeable
for style numbers from 0
to 255
.
The default values are true
.
Currently, read-only styles do not allow the caret into the range of text,
but ranges containing read-only text are deletable.
style_character_set
(table)
Table of character sets for style numbers from 0
to 255
.
_SCINTILLA.constants.SC_CHARSET_ANSI
(0)_SCINTILLA.constants.SC_CHARSET_DEFAULT
(1)_SCINTILLA.constants.SC_CHARSET_CYRILLIC
(1251)_SCINTILLA.constants.SC_CHARSET_EASTEUROPE
(238)_SCINTILLA.constants.SC_CHARSET_GB2312
(134)_SCINTILLA.constants.SC_CHARSET_HANGUL
(129)_SCINTILLA.constants.SC_CHARSET_RUSSIAN
(204)_SCINTILLA.constants.SC_CHARSET_SHIFTJIS
(128)_SCINTILLA.constants.SC_CHARSET_8859_15
(1000)
The default values are 1
.
style_eol_filled
(table)
Table of flags indicating whether or not to extend the background colors of
styles whose characters occur last on lines all the way to the right margin
of the view for style numbers from 0
to 255
.
The default values are false
.
style_font
(table)
Table of font faces for style numbers from 0
to 255
.
style_fore
(table)
Table of foreground colors, in “0xBBGGRR” format, for style numbers from
0
to 255
.
style_hot_spot
(table)
Table of flags indicating whether or not text within styles is clickable
for style numbers from 0
to 255
.
The default values are false
.
style_italic
(table)
Table of flags indicating whether or not text within styles has an italic
font face for style numbers from 0
to 255
.
The default values are false
.
style_size
(table)
Table of font sizes, expressed in whole number points, for style numbers
from 0
to 255
.
style_size_fractional
(table)
Table of character sizes, expressed in hundredths of a point, for style
numbers from 0
to 255
.
For example, a text size of 9.4 points is set using 940
.
style_underline
(table)
Table of flags indicating whether or not text within styles has an
underlined font face for style numbers from 0
to 255
.
The default values are false
.
style_visible
(table)
Table of flags indicating whether or not text within styles is visible for
style numbers from 0
to 255
.
The default values are true
.
style_weight
(table)
Table of character weights ranging from 1
(very light) to 999
(very
heavy) for text within styles for style numbers from 0
to 255
.
However, most fonts only support a small number of weights:
_SCINTILLA.constants.SC_WEIGHT_NORMAL
(400) Normal._SCINTILLA.constants.SC_WEIGHT_SEMIBOLD
(600) Semi-bold._SCINTILLA.constants.SC_WEIGHT_BOLD
(700) Bold.
The default values are 400
.
tab_indents
(bool)
Tabbing indents within indentation.
The default value is false
.
tab_width
(number)
The number of space characters represented by a tab character.
The default value is 8
.
tag
(table)
List of tag match values from a regular expression search.
target_end
(number)
The position of the end of the target range.
This is also set by a successful
buffer:search_in_target()
.
target_start
(number)
The position of the beginning of the target range.
This is also set by a successful
buffer:search_in_target()
.
text_length
(number, Read-only)
The number of characters in the buffer.
two_phase_draw
(bool)
Draw in two phases: first the background and then the foreground.
The default is true
.
undo_collection
(bool)
Collect undo information.
When setting to false
, call
buffer:empty_undo_buffer()
to avoid desynchronizing
the undo buffer with the buffer text.
The default value is true
.
use_tabs
(bool)
Use tabs or spaces in indentation.
The default value is true
, for using tabs.
v_scroll_bar
(bool)
Display the vertical scroll bar.
The default value is true
.
view_eol
(bool)
Display end of line characters.
The default value is false
.
view_ws
(number)
The whitespace character visibility mode.
_SCINTILLA.constants.SCWS_INVISIBLE
(0) Whitespace is invisible._SCINTILLA.constants.SCWS_VISIBLEALWAYS
(1) Display whitespace as dots and arrows._SCINTILLA.constants.SCWS_VISIBLEAFTERINDENT
(2) Display non-indentation whitespace as dots and arrows.
The default value is 0
.
virtual_space_options
(number)
The virtual space mode.
_SCINTILLA.constants.SCVS_NONE
(0) Disable virtual space._SCINTILLA.constants.SCVS_RECTANGULARSELECTION
(1) Enable virtual space only for rectangular selections._SCINTILLA.constants.SCVS_USERACCESSIBLE
(2) Enable virtual space.
The default value is 0
.
whitespace_chars
(string)
The set of characters considered to be whitespace characters when moving
or selecting text by word.
Set this only after setting buffer.word_chars
.
The default value is a string containing all non-newline characters less
than ASCII value 33.
whitespace_size
(number)
The size of the dots in pixels used to represent space characters when
whitespace is visible.
The default value is 1
.
word_chars
(string)
The set of characters considered to be word characters when moving or selecting text by word. The default value is a string containing alphanumeric characters, an underscore, and all characters greater than ASCII value 127.
wrap_indent_mode
(number)
The wrapped line indent mode.
_SCINTILLA.constants.SC_WRAP_INDENT_FIXED
(0) Indent wrapped lines bybuffer.wrap_start_indent
._SCINTILLA.constants.SC_WRAP_INDENT_SAME
(1) Indent wrapped lines the same as the first line._SCINTILLA.constants.SC_WRAP_INDENT_INDENT
(2) Indent wrapped lines one more level than the first line.
The default value is 0
.
wrap_mode
(number)
Long line wrap mode.
_SCINTILLA.constants.SC_WRAP_NONE
(0) Long lines are not wrapped._SCINTILLA.constants.SC_WRAP_WORD
(1) Wrap long lines at word boundaries._SCINTILLA.constants.SC_WRAP_CHAR
(2) Wrap long lines at character boundaries.
The default value is 0
.
wrap_start_indent
(number)
The number of spaces to indent wrapped lines by if
buffer.wrap_indent_mode
is
_SCINTILLA.constants.SC_WRAP_INDENT_FIXED
.
The default value is 0
.
wrap_visual_flags
(number)
The wrapped line visual display mode.
_SCINTILLA.constants.SC_WRAPVISUALFLAG_NONE
(0) No visual flags._SCINTILLA.constants.SC_WRAPVISUALFLAG_END
(1) Show visual flag at the end of the line._SCINTILLA.constants.SC_WRAPVISUALFLAG_START
(2) Show visual flag at the beginning of the sub-line._SCINTILLA.constants.SC_WRAPVISUALFLAG_MARGIN
(4) Show visual flag in the line number margin of the sub-line.
The default value is 0
.
wrap_visual_flags_location
(number)
The wrapped line visual flag drawing mode.
_SCINTILLA.constants.SC_WRAPVISUALFLAGLOC_DEFAULT
(0) Draw the visual flag near the right border._SCINTILLA.constants.SC_WRAPVISUALFLAGLOC_END_BY_TEXT
(1) Draw the visual flag near text at the end of the line._SCINTILLA.constants.SC_WRAPVISUALFLAGLOC_START_BY_TEXT
(2) Draw the visual flag near text at the beginning of the subline.
The default value is 0
.
x_offset
(number)
The horizontal scroll position in pixels.
A value of 0
is the normal position with the first text column visible at
the left of the view.
zoom
(number)
The number of points to add to the size of all fonts.
Negative values are allowed.
The default value is 0
.
Functions
add_selection
(buffer, caret, anchor)
Selects the change of text from anchor to caret as the main selection,
retaining all other selections as additional selections.
Even if no text is selected, the current position counts as an empty
selection. Use buffer:set_selection()
first when setting a list of
selections.
Parameters:
buffer
: The global buffer.caret
: The caret position of the range of text to select in buffer.anchor
: The anchor position of the range of text to select in buffer.
add_text
(buffer, text)
Adds string text to the buffer at the caret and moves the caret to the end of the added text, but does not scroll it into view.
Parameters:
buffer
: The global buffer.text
: The text to add.
allocate
(buffer, bytes)
Enlarges the buffer to store bytes number of bytes, but never shrinks it beyond the size of its contents.
Parameters:
buffer
: The global buffer.bytes
: The number of bytes buffer can store.
annotation_clear_all
(buffer)
Clears annotations from all lines.
Parameters:
buffer
: The global buffer.
append_text
(buffer, text)
Appends string text to the end of the buffer without changing the selected text or scrolling the text into view.
Parameters:
buffer
: The global buffer.text
: The text to append.
auto_c_active
(buffer)
Returns whether or not an autocompletion list is visible.
Parameters:
buffer
: The global buffer.
Return:
- bool
auto_c_cancel
(buffer)
Cancels the autocompletion list.
Parameters:
buffer
: The global buffer.
auto_c_complete
(buffer)
Autocompletes the selected word in the list.
Parameters:
buffer
: The global buffer.
auto_c_pos_start
(buffer)
Returns the position where autocompletion started at.
Parameters:
buffer
: The global buffer.
Return:
- number
auto_c_select
(buffer, string)
Selects the first item in the autocompletion list that starts with string,
considering case sensitiveness depending on buffer.auto_c_ignore_case
.
Parameters:
buffer
: The global buffer.string
: The item in the list to select.
auto_c_show
(buffer, len_entered, item_list)
Displays an autocompletion list from item_list, a sorted string whose items
are delimited by buffer.auto_c_separator
characters, using len_entered
number of characters behind the caret as the prefix of the word to
autocomplete.
The sorted order of item_list, buffer.auto_c_order
, must be already
defined.
Parameters:
buffer
: The global buffer.len_entered
: The number of characters before the caret used to provide the context.item_list
: The sorted string of words to show, separated bybuffer.auto_c_separator
characters (initially spaces).
auto_c_stops
(buffer, chars)
Defines chars as the set of characters that cancel autocompletion when typed. The default set is an empty string.
Parameters:
buffer
: The global buffer.chars
: The string of characters that cancel autocompletion. This string is empty by default.
back_tab
(buffer)
Dedents the selected lines.
Parameters:
buffer
: The global buffer.
begin_undo_action
(buffer)
Starts a sequence of actions to undo or redo as a single action. May be nested.
Parameters:
buffer
: The global buffer.
brace_bad_light
(buffer, pos)
Highlights the character at position pos as an unmatched brace character in
the _SCINTILLA.constants.STYLE_BRACEBAD
style.
Removes highlighting when pos is -1
.
Parameters:
buffer
: The global buffer.pos
: The position in buffer to highlight, or-1
to remove the highlight.
brace_bad_light_indicator
(buffer, use_indicator, indic_num)
Highlights unmatched brace characters with indicator number indic_num, in
the range of 0
to 31
, instead of the
_SCINTILLA.constants.STYLE_BRACEBAD
style if use_indicator is true
.
Parameters:
buffer
: The global buffer.use_indicator
: Whether or not to use an indicator.indic_num
: The indicator number to use.
brace_highlight
(buffer, pos1, pos2)
Highlights the characters at positions pos1 and pos2 as matching braces
in the _SCINTILLA.constants.STYLE_BRACELIGHT
style.
If indent guides are enabled, locate the column with buffer.column
and
set buffer.highlight_guide
in order to highlight the indent guide.
Parameters:
buffer
: The global buffer.pos1
: The first position in buffer to highlight.pos2
: The second position in buffer to highlight.
brace_highlight_indicator
(buffer, use_indicator, indic_num)
Highlights matching brace characters with indicator number indic_num, in
the range of 0
to 31
, instead of the
_SCINTILLA.constants.STYLE_BRACELIGHT
style if use_indicator is true
.
Parameters:
buffer
: The global buffer.use_indicator
: Whether or not to use an indicator.indic_num
: The indicator number to use.
brace_match
(buffer, pos)
Returns the position of the matching brace for the brace character at
position pos, taking nested braces into account, or -1
.
The brace characters recognized are ‘(’, ‘)’, ‘[’, ‘]’, ‘{’, ‘}’, ‘<’, and
‘>’ and must have the same style.
Parameters:
buffer
: The global buffer.pos
: The position of the brace in buffer to match.
Return:
- number.
call_tip_active
(buffer)
Returns whether or not a call tip is visible.
Parameters:
buffer
: The global buffer.
Return:
- bool
call_tip_cancel
(buffer)
Removes the call tip from view.
Parameters:
buffer
: The global buffer.
call_tip_pos_start
(buffer)
Returns the position where the call tip displayed at.
Parameters:
buffer
: The global buffer.
Return:
- number
call_tip_set_hlt
(buffer, start_pos, end_pos)
Highlights call tip text from start_pos, starting from zero, to end_pos
with the color buffer.call_tip_fore_hlt
.
Parameters:
buffer
: The global buffer.start_pos
: The start position in the call tip text to highlight.end_pos
: The end position in the call tip text to highlight.
call_tip_show
(buffer, pos, text)
Displays a call tip containing string text for the word behind position pos. Any “\001” or “\002” bytes in text are replaced by arrow visuals, indicating the word has more than one call tip.
Parameters:
buffer
: The global buffer.pos
: The position in buffer to show the call tip at.text
: The call tip text to show.
can_paste
(buffer)
Returns whether or not the clipboard has text to paste.
Parameters:
buffer
: The global buffer.
Return:
- bool
can_redo
(buffer)
Returns whether or not there is an action to redo.
Parameters:
buffer
: The global buffer.
Return:
- bool
can_undo
(buffer)
Returns whether or not there is an action to undo.
Parameters:
buffer
: The global buffer.
Return:
- bool
cancel
(buffer)
Cancels the active call tip, autocompletion list, user list, selection mode, etc.
Parameters:
buffer
: The global buffer.
change_lexer_state
(buffer, start_pos, end_pos)
Tells the lexer to re-process the range of text from start_pos to end_pos.
Parameters:
buffer
: The global buffer.start_pos
: The start position of the range of text in buffer to re-process.end_pos
: The end position of the range of text in buffer to re-process.
char_left
(buffer)
Moves the caret left one character.
Parameters:
buffer
: The global buffer.
char_left_extend
(buffer)
Moves the caret left one character, extending the selected text to the new position.
Parameters:
buffer
: The global buffer.
char_left_rect_extend
(buffer)
Moves the caret left one character, extending the rectangular selection to the new position.
Parameters:
buffer
: The global buffer.
char_position_from_point
(buffer, x, y)
Returns the character position closest to view coordinates x and y.
Parameters:
buffer
: The global buffer.x
: The x-coordinate in the view to use.y
: The y-coordinate in the view to use.
Return:
- number
char_position_from_point_close
(buffer, x, y)
Returns the character position closest to view coordinates x and y, or
-1
if the point is outside the window or not close to any text.
Parameters:
buffer
: The global buffer.x
: The x-coordinate in the view to use.y
: The y-coordinate in the view to use.
Return:
- number
char_right
(buffer)
Moves the caret right one character.
Parameters:
buffer
: The global buffer.
char_right_extend
(buffer)
Moves the caret right one character, extending the selected text to the new position.
Parameters:
buffer
: The global buffer.
char_right_rect_extend
(buffer)
Moves the caret right one character, extending the rectangular selection to the new position.
Parameters:
buffer
: The global buffer.
check_global
(buffer)
Ensures the buffer is the global one, _G.buffer
, throwing an error
otherwise.
This function must be called in all buffer functions because only the global
buffer can be worked with.
Parameters:
buffer
: The buffer to check.
See also:
choose_caret_x
(buffer)
Sets the preferred horizontal position of the caret when moving between lines to the current position.
Parameters:
buffer
: The global buffer.
See also:
clear
(buffer)
Deletes the selected text or the character at the caret.
Parameters:
buffer
: The global buffer.
clear_all
(buffer)
Deletes all of the text in the buffer unless the buffer is read-only.
Parameters:
buffer
: The global buffer.
clear_all_cmd_keys
(buffer)
Clears Scintilla’s internal key bindings.
Parameters:
buffer
: The global buffer.
clear_document_style
(buffer)
Clears all styling and folding information in the buffer.
Parameters:
buffer
: The global buffer.
clear_registered_images
(buffer)
Clears all images registered using buffer:register_image()
and
buffer:register_rgba_image()
.
Parameters:
buffer
: The global buffer.
clear_selections
(buffer)
Removes all selections and moves the caret to the beginning of the buffer.
Parameters:
buffer
: The global buffer.
close
(buffer)
Closes the buffer, prompting the user to continue if there are unsaved
changes, and returns true
if the buffer was closed.
Parameters:
buffer
: The global buffer.
Return:
true
if the buffer was closed;nil
otherwise.
colourise
(buffer, start_pos, end_pos)
Tells the lexer to style and fold the range of text from start_pos to
end_pos.
If end_pos is -1
, styles and folds to the end of the buffer.
Parameters:
buffer
: The global buffer.start_pos
: The start position of the range of text in buffer to process.end_pos
: The end position of the range of text in buffer to process, or-1
to process from start_pos to the end of buffer.
contracted_fold_next
(buffer, line_start)
Returns the line number of the next contracted fold header line starting at
line_start, or -1
.
Parameters:
buffer
: The global buffer.line_start
: The line number in buffer to start at.
Return:
- number
convert_eo_ls
(buffer, mode)
Converts all line endings to end of line mode mode.
Parameters:
buffer
: The global buffer.mode
: The line ending mode to convert to. Valid values are:_SCINTILLA.constants.SC_EOL_CRLF
(0)_SCINTILLA.constants.SC_EOL_CR
(1)_SCINTILLA.constants.SC_EOL_LF
(2)
copy
(buffer)
Copies the selected text to the clipboard. Multiple selections are copied in order with no delimiters. Rectangular selections are copied from top to bottom with line ending delimiters. Virtual space is not copied.
Parameters:
buffer
: The global buffer.
copy_allow_line
(buffer)
Copies the selected text or the current line to the clipboard.
Parameters:
buffer
: The global buffer.
copy_range
(buffer, start_pos, end_pos)
Copies the range of text from start_pos to end_pos to the clipboard.
Parameters:
buffer
: The global buffer.start_pos
: The start position of the range of text in buffer to copy.end_pos
: The end position of the range of text in buffer to copy.
copy_text
(buffer, text)
Copies string text to the clipboard.
Parameters:
buffer
: The global buffer.text
: The text to copy.
count_characters
(buffer, start_pos, end_pos)
Returns the number of whole characters in-between positions start_pos and end_pos.
Parameters:
buffer
: The global buffer.start_pos
: The start position of the range of text in buffer to start counting at.end_pos
: The end position of the range of text in buffer to stop counting at.
Return:
- number
cut
(buffer)
Cuts the selected text to the clipboard. Multiple selections are copied in order with no delimiters. Rectangular selections are copied from top to bottom with line ending delimiters. Virtual space is not copied.
Parameters:
buffer
: The global buffer.
del_line_left
(buffer)
Deletes text from the caret to the beginning of the line.
Parameters:
buffer
: The global buffer.
del_line_right
(buffer)
Deletes text from the caret to the end of the line.
Parameters:
buffer
: The global buffer.
del_word_left
(buffer)
Deletes the word to the left of the caret, including any leading non-word
characters.
buffer.word_chars
contains word characters.
Parameters:
buffer
: The global buffer.
del_word_right
(buffer)
Deletes the word to the right of the caret, including any trailing non-word
characters.
buffer.word_chars
contains word characters.
Parameters:
buffer
: The global buffer.
del_word_right_end
(buffer)
Deletes the word to the right of the caret, excluding any trailing non-word
characters.
buffer.word_chars
contains word characters.
Parameters:
buffer
: The global buffer.
delete
(buffer)
Deletes the buffer.
Do not call this function. Call buffer:close()
instead. Emits a
BUFFER_DELETED
event.
Parameters:
buffer
: The global buffer.
See also:
delete_back
(buffer)
Deletes the selected text or the character behind the caret.
Parameters:
buffer
: The global buffer.
delete_back_not_line
(buffer)
Deletes the selected text or the character behind the caret unless the caret is at the beginning of a line.
Parameters:
buffer
: The global buffer.
delete_range
(buffer, pos, length)
Deletes the range of text from pos to pos + length in the buffer.
Parameters:
buffer
: The global buffer.pos
: The start position of the range of text in buffer to delete.length
: The number of characters in the range of text to delete.
doc_line_from_visible
(buffer, display_line)
Returns the actual line number of displayed line number display_line,
taking hidden lines into account.
If display_line is less than or equal to zero, returns 0
. If
display_line is greater than or equal to the number of displayed lines,
returns buffer.line_count
.
Parameters:
buffer
: The global buffer.display_line
: The display line number to use.
Return:
- number
document_end
(buffer)
Moves the caret to the end of the buffer.
Parameters:
buffer
: The global buffer.
document_end_extend
(buffer)
Moves the caret to the end of the buffer, extending the selected text to the new position.
Parameters:
buffer
: The global buffer.
document_start
(buffer)
Moves the caret to the beginning of the buffer.
Parameters:
buffer
: The global buffer.
document_start_extend
(buffer)
Moves the caret to the beginning of the buffer, extending the selected text to the new position.
Parameters:
buffer
: The global buffer.
edit_toggle_overtype
(buffer)
Toggles buffer.overtype
.
Parameters:
buffer
: The global buffer.
empty_undo_buffer
(buffer)
Deletes the undo and redo history and sets buffer.modify
to false
.
Parameters:
buffer
: The global buffer.
encoded_from_utf8
(buffer, string)
Returns the result of UTF-8-encoded string string converted into the buffer’s encoding.
Parameters:
buffer
: The global buffer.string
: The UTF-8-encoded string to convert.
Return:
- number
end_undo_action
(buffer)
Ends a sequence of actions to undo or redo as a single action.
Parameters:
buffer
: The global buffer.
ensure_visible
(buffer, line)
Ensures line number line is visible by expanding any fold header lines hiding it.
Parameters:
buffer
: The global buffer.line
: The line number in buffer to ensure visible.
ensure_visible_enforce_policy
(buffer, line)
Ensures line number line is visible by expanding any fold header lines
hiding it and applies the vertical caret policy set with
buffer:set_visible_policy()
.
Parameters:
buffer
: The global buffer.line
: The line number in buffer to ensure visible.
expand_children
(buffer, line, level)
Expands the fold states of the fold header on line number line and its children with fold level level.
Parameters:
buffer
: The global buffer.line
: The line number in buffer to expand the folds for.level
: The previous fold level of line, not the current one. This is because this function is used to respond to changes in a line’s fold level or fold header status, so a new fold level has already been set.
find_column
(buffer, line, column)
Returns the position of column number column on line number line, taking tab and multi-byte characters into account, or the position at the end of line line.
Parameters:
buffer
: The global buffer.line
: The line number in buffer to use.column
: The column number to use.
fold_all
(buffer, action)
Expands, contracts, or toggles the fold states of all fold headers in the buffer, depending on action. When toggling, the state of the first fold header in the buffer determines whether to expand or contract.
Parameters:
buffer
: The global buffer.action
: The fold action to perform. Valid values are:_SCINTILLA.constants.SC_FOLDACTION_CONTRACT
(0)_SCINTILLA.constants.SC_FOLDACTION_EXPAND
(1)_SCINTILLA.constants.SC_FOLDACTION_TOGGLE
(2)
fold_children
(buffer, line, action)
Expands, contracts, or toggles the fold states of the fold header on line number line and its children, depending on action.
Parameters:
buffer
: The global buffer.line
: The line number in buffer to set the fold states for.action
: The fold action to perform. Valid values are:_SCINTILLA.constants.SC_FOLDACTION_CONTRACT
(0)_SCINTILLA.constants.SC_FOLDACTION_EXPAND
(1)_SCINTILLA.constants.SC_FOLDACTION_TOGGLE
(2)
fold_line
(buffer, line, action)
Expands, contracts, or toggles the fold state of the fold header on line number line, depending on action.
Parameters:
buffer
: The global buffer.line
: The line number in buffer to set the fold state for.action
: The fold action to perform. Valid values are:_SCINTILLA.constants.SC_FOLDACTION_CONTRACT
(0)_SCINTILLA.constants.SC_FOLDACTION_EXPAND
(1)_SCINTILLA.constants.SC_FOLDACTION_TOGGLE
(2)
form_feed
(buffer)
Inserts a Form Feed (“\f”) character at the caret.
Parameters:
buffer
: The global buffer.
get_cur_line
(buffer)
Returns the current line’s text and the index of the caret on the line, starting from zero.
Parameters:
buffer
: The global buffer.
Return:
- string, number
get_hotspot_active_back
(buffer)
Returns the numeric background color for active hotspots.
Parameters:
buffer
: The global buffer.
Return:
- number
get_hotspot_active_fore
(buffer)
Returns the numeric foreground color for active hotspots.
Parameters:
buffer
: The global buffer.
Return:
- number
get_last_child
(buffer, start_line, level)
Returns the line number of the last line after line number start_line whose
fold level is greater than level or the level of start_line if level is
-1
.
Parameters:
buffer
: The global buffer.start_line
: The line number in buffer of a header line.level
: The fold level, or-1
for the level of start_line.
get_lexer
(buffer, current)
Returns the name of the lexer used by the buffer, or the name of the lexer
under the caret in a multiple-language lexer if current is true
.
Parameters:
buffer
: The global buffer.current
: Whether or not to get the lexer at the current caret position in multi-language lexers. The default isfalse
and returns the parent lexer.
get_line
(buffer, line)
Returns the text on line number line, including end of line characters, and the length of the line.
Parameters:
buffer
: The global buffer.line
: The line number in buffer to use.
Return:
- string, number
get_line_sel_end_position
(buffer, line)
Returns the position of the end of the selected text on line number line,
or -1
.
Parameters:
buffer
: The global buffer.line
: The line number in buffer to use.
get_line_sel_start_position
(buffer, line)
Returns the position of the beginning of the selected text on line number
line, or -1
.
Parameters:
buffer
: The global buffer.line
: The line number in buffer to use.
get_sel_text
(buffer)
Returns the selected text and its length. Multiple selections are included in order with no delimiters. Rectangular selections are included from top to bottom with line ending delimiters. Virtual space is not included.
Parameters:
buffer
: The global buffer.
Return:
- string, number
get_style_name
(buffer, style_num)
Returns the name of style number style_num, in the range of 0
to 255
.
Parameters:
buffer
: The global buffer.style_num
: The style number from0
to255
to get the name of.
See also:
get_text
(buffer)
Returns all of the text in the buffer and its length.
Parameters:
buffer
: The global buffer.
goto_line
(buffer, line)
Places the caret an anchor at the beginning of line number line and scrolls them into view.
Parameters:
buffer
: The global buffer.line
: The line number in buffer to go to.
goto_pos
(buffer, pos)
Places the caret and anchor at position pos and scrolls them into view.
Parameters:
buffer
: The global buffer.pos
: The position in buffer to go to.
grab_focus
(buffer)
Sets the focus to the buffer’s view.
Parameters:
buffer
: The global buffer.
hide_lines
(buffer, start_line, end_line)
Hides the range of lines from line number start_line to end_line. This has no effect on fold levels or fold flags and the first line cannot be hidden.
Parameters:
buffer
: The global buffer.start_line
: The start line of the range of lines in buffer to hide.end_line
: The end line of the range of lines in buffer to hide.
hide_selection
(buffer, normal)
Do not highlight selected text if normal is true
.
Parameters:
buffer
: The global buffer.normal
: Whether or not to draw the normal selection.
home
(buffer)
Moves the caret to the beginning of the current line.
Parameters:
buffer
: The global buffer.
home_display
(buffer)
Moves the caret to the beginning of the current wrapped line.
Parameters:
buffer
: The global buffer.
home_display_extend
(buffer)
Moves the caret to the beginning of the current wrapped line, extending the selected text to the new position.
Parameters:
buffer
: The global buffer.
home_extend
(buffer)
Moves the caret to the beginning of the current line, extending the selected text to the new position.
Parameters:
buffer
: The global buffer.
home_rect_extend
(buffer)
Moves the caret to beginning of the current line, extending the rectangular selection to the new position.
Parameters:
buffer
: The global buffer.
home_wrap
(buffer)
Moves the caret to beginning of the current wrapped line, or if already there, to the beginning of the actual line.
Parameters:
buffer
: The global buffer.
home_wrap_extend
(buffer)
Like buffer:home_wrap()
, but extends the selected text to the new position.
Parameters:
buffer
: The global buffer.
indicator_all_on_for
(buffer, pos)
Returns a bit-mask representing which indicators are on at position pos. Bit 0 is set if indicator 0 is on, bit 1 for indicator 1, etc.
Parameters:
buffer
: The global buffer.pos
: The position in buffer to get indicators at.
Return:
- number
indicator_clear_range
(buffer, pos, clear_length)
Clears indicator buffer.indicator_current
over the range of text from pos
to pos + clear_length.
Parameters:
buffer
: The global buffer.pos
: The start position of the range of text in buffer to clear indicators over.clear_length
: The number of characters in the range of text to clear indicators over.
indicator_end
(buffer, indicator, pos)
Returns the end position of indicator number indicator, in the range of 0
to 31
, at position pos.
Parameters:
buffer
: The global buffer.indicator
: An indicator number in the range of0
to31
.pos
: The position in buffer of the indicator.
indicator_fill_range
(buffer, pos, fill_length)
Sets indicator buffer.indicator_value
or buffer.indicator_current
over
the range of text from pos to pos + fill_length.
Parameters:
buffer
: The global buffer.pos
: The start position of the range of text in buffer to set indicators over.fill_length
: The number of characters in the range of text to set indicators over.
indicator_start
(buffer, indicator, pos)
Returns the position of the beginning of indicator number indicator, in the
range of 0
to 31
, at position pos.
Parameters:
buffer
: The global buffer.indicator
: An indicator number in the range of0
to31
.pos
: The position in buffer of the indicator.
indicator_value_at
(buffer, indicator, pos)
Returns the value of indicator number indicator, in the range of 0
to
31
, at position pos.
Parameters:
buffer
: The global buffer.indicator
: The indicator number in the range of0
to31
.pos
: The position in buffer of the indicator.
Return:
- number
insert_text
(buffer, pos, text)
Inserts string text at position pos or the caret if pos is -1
.
If the caret is after the pos, it is moved appropriately, but not scrolled
into view.
Parameters:
buffer
: The global buffer.pos
: The position in buffer to insert text at, or-1
for the current position.text
: The text to insert.
line_copy
(buffer)
Copies the current line to the clipboard.
Parameters:
buffer
: The global buffer.
line_cut
(buffer)
Cuts the current line to the clipboard.
Parameters:
buffer
: The global buffer.
line_delete
(buffer)
Deletes the current line.
Parameters:
buffer
: The global buffer.
line_down
(buffer)
Moves the caret down one line.
Parameters:
buffer
: The global buffer.
line_down_extend
(buffer)
Moves the caret down one line, extending the selected text to the new position.
Parameters:
buffer
: The global buffer.
line_down_rect_extend
(buffer)
Moves the caret down one line, extending the rectangular selection to the new position.
Parameters:
buffer
: The global buffer.
line_duplicate
(buffer)
Duplicates the current line below the line.
Parameters:
buffer
: The global buffer.
line_end
(buffer)
Moves the caret to the end of the current line.
Parameters:
buffer
: The global buffer.
line_end_display
(buffer)
Moves the caret to the end of the current wrapped line.
Parameters:
buffer
: The global buffer.
line_end_display_extend
(buffer)
Moves the caret to the end of the current wrapped line, extending the selected text to the new position.
Parameters:
buffer
: The global buffer.
line_end_extend
(buffer)
Moves the caret to the end of the current line, extending the selected text to the new position.
Parameters:
buffer
: The global buffer.
line_end_rect_extend
(buffer)
Moves the caret to the end of the current line, extending the rectangular selection to the new position.
Parameters:
buffer
: The global buffer.
line_end_wrap
(buffer)
Moves the caret to the end of the current wrapped line, or if already there, to the end of the actual line.
Parameters:
buffer
: The global buffer.
line_end_wrap_extend
(buffer)
Like buffer:line_end_wrap()
, but extends the selected text to the new
position.
Parameters:
buffer
: The global buffer.
line_from_position
(buffer, pos)
Returns the line number containing position pos.
Returns 0
if pos is less than 0 or buffer.line_count
if pos is
greater than buffer.length
.
Parameters:
buffer
: The global buffer.pos
: The position in buffer to get the line number of.
Return:
- number
line_length
(buffer, line)
Returns the number of characters on line number line, including end of line
characters.
To get line length excluding end of line characters, use
buffer.line_end_position[line] - buffer:position_from_line(line)
.
Parameters:
buffer
: The global buffer.line
: The line number in buffer to get the length of.
Return:
- number
line_scroll
(buffer, columns, lines)
Scroll right columns columns and down lines lines. Negative values are allowed.
Parameters:
buffer
: The global buffer.columns
: The number of columns to scroll horizontally.lines
: The number of lines to scroll vertically.
line_scroll_down
(buffer)
Scroll the buffer down one line, keeping the caret visible.
Parameters:
buffer
: The global buffer.
line_scroll_up
(buffer)
Scroll the buffer up one line, keeping the caret visible.
Parameters:
buffer
: The global buffer.
line_transpose
(buffer)
Switch the current line with the previous one.
Parameters:
buffer
: The global buffer.
line_up
(buffer)
Moves the caret up one line.
Parameters:
buffer
: The global buffer.
line_up_extend
(buffer)
Moves the caret up one line, extending the selected text to the new position.
Parameters:
buffer
: The global buffer.
line_up_rect_extend
(buffer)
Moves the caret up one line, extending the rectangular selection to the new position.
Parameters:
buffer
: The global buffer.
lines_join
(buffer)
Joins the lines in the target range, inserting spaces in-between joined words.
Parameters:
buffer
: The global buffer.
lines_split
(buffer, pixel_width)
Splits the lines in the target range into lines of width at most
pixel_width or the width of the view if pixel_width is 0
.
Parameters:
buffer
: The global buffer.pixel_width
: The pixel width to split lines at. When0
, uses the width of the view.
lower_case
(buffer)
Converts the selected text to lower case letters.
Parameters:
buffer
: The global buffer.
margin_text_clear_all
(buffer)
Clears margin text on all lines.
Parameters:
buffer
: The global buffer.
marker_add
(buffer, line, marker_num)
Adds marker number marker_num, in the range of 0
to 31
, on line number
line, returning a marker handle which can be used in
buffer:marker_delete_handle()
and buffer:marker_line_from_handle()
, or
-1
if the marker cannot be added.
Parameters:
buffer
: The global buffer.line
: The line number to add the marker on.marker_num
: The marker number in the range of0
to31
to add.
Return:
- number
marker_add_set
(buffer, line, marker_mask)
Adds the markers specified in the marker bit-mask marker_mask to line number line. Bit 0 is set to add marker 0, bit 1 for marker 1, etc., up to marker 31.
Parameters:
buffer
: The global buffer.line
: The line number to add the markers on.marker_mask
: The mask of markers to set. Set bit 0 to set marker 0, bit 1 for marker 1 and so on.
marker_define
(buffer, marker_num, marker_symbol)
Sets the symbol marker_symbol shown in the margin for marker number
marker_num, in the range of 0
to 31
.
Parameters:
buffer
: The global buffer.marker_num
: The marker number in the range of0
to31
to set marker_symbol for.marker_symbol
: The marker symbol:_SCINTILLA.constants.SC_MARK_*
.
See also:
marker_define_pixmap
(buffer, marker_num, pixmap)
Defines XPM image pixmap for marker number marker_num, in the range of
0
to 31
.
Pixmap markers use the _SCINTILLA.constants.SC_MARK_PIXMAP
marker symbol.
Parameters:
buffer
: The global buffer.marker_num
: The marker number in the range of0
to31
to define pixmap pixmap for.pixmap
: The string pixmap data.
marker_define_rgba_image
(buffer, marker_num, pixels)
Defines RGBA image pixels for marker number marker_num, in the range of
0
to 31
.
RGBA image markers use the _SCINTILLA.constants.SC_MARK_RGBAIMAGE
marker
symbol. The dimensions for pixels, buffer.rgba_image_width
and
buffer.rgba_image_height
, must be already defined. pixels is a sequence
of 4 byte pixel values (red, blue, green, and alpha) defining the image line
by line starting at the top-left pixel.
Parameters:
buffer
: The global buffer.marker_num
: The marker number in the range of0
to31
to define RGBA data pixels for.pixels
: The string sequence of 4 byte pixel values starting with the pixels for the top line, with the leftmost pixel first, then continuing with the pixels for subsequent lines. There is no gap between lines for alignment reasons. Each pixel consists of, in order, a red byte, a green byte, a blue byte and an alpha byte. The colour bytes are not premultiplied by the alpha value. That is, a fully red pixel that is 25% opaque will be[FF, 00, 00, 3F]
.
marker_delete
(buffer, line, marker_num)
Deletes marker number marker_num, in the range of 0
to 31
or -1
for
all markers, from line number line.
Parameters:
buffer
: The global buffer.line
: The line number to delete the marker on.marker_num
: The marker number in the range of0
to31
to delete from line, or-1
to delete all markers from the line.
marker_delete_all
(buffer, marker_num)
Deletes marker number marker_num, in the range of 0
to 31
or -1
for
all markers, from all lines in the buffer.
Parameters:
buffer
: The global buffer.marker_num
: The marker number in the range of0
to31
to delete from all lines, or-1
to delete all markers from all lines.
marker_delete_handle
(buffer, handle)
Deletes the marker with handle handle returned by buffer:marker_add()
.
Parameters:
buffer
: The global buffer.handle
: The identifier of a marker returned bybuffer:marker_add()
.
marker_enable_highlight
(buffer, enabled)
Highlights the margin fold markers for the current fold block if enabled is
true
.
Parameters:
buffer
: The global buffer.enabled
: Whether or not to enable highlight.
marker_get
(buffer, line)
Returns a bit-mask representing which markers are set line number line. Bit 0 is set if marker 0 is set, bit 1 for marker 1, etc.
Parameters:
buffer
: The global buffer.line
: The line number to get markers on.
Return:
- number.
marker_line_from_handle
(buffer, handle)
Returns the line number the marker with handle handle, returned by
buffer:marker_add()
, is on, or -1
.
Parameters:
buffer
: The global buffer.handle
: The identifier of a marker returned bybuffer:marker_add()
.
Return:
- number
marker_next
(buffer, start_line, marker_mask)
Returns the first line number starting at line number start_line that has
all of the markers represented by marker bit-mask marker_mask set on, or
-1
.
Bit 0 is set if marker 0 is set, bit 1 for marker 1, etc., up to marker 31.
Parameters:
buffer
: The global buffer.start_line
: The start line to search from.marker_mask
: The mask of markers to find. Set bit 0 to find marker 0, bit 1 for marker 1 and so on.
Return:
- number
marker_previous
(buffer, start_line, marker_mask)
Returns the last line number before or on line number start_line that has
all of the markers represented by marker bit-mask marker_mask set on, or
-1
.
Bit 0 is set if marker 0 is set, bit 1 for marker 1, etc., up to marker 31.
Parameters:
buffer
: The global buffer.start_line
: The start line to search from.marker_mask
: The mask of markers to find. Set bit 0 to find marker 0, bit 1 for marker 1 and so on.
Return:
- number
marker_symbol_defined
(buffer, marker_num)
Returns the symbol defined for marker number marker_num, in the range of
0
to 31
, used in buffer:marker_define()
,
buffer:marker_define_pixmap()
, or buffer:marker_define_rgba_image()
.
Parameters:
buffer
: The global buffer.marker_num
: The marker number in the range of0
to31
to get the symbol of.
Return:
- number
move_caret_inside_view
(buffer)
Moves the caret to be visible inside the view if it is not already, removing any selections.
Parameters:
buffer
: The global buffer.
move_selected_lines_down
(buffer)
Moves the selected lines down one line.
Parameters:
buffer
: The global buffer.
move_selected_lines_up
(buffer)
Moves the selected lines up one line.
Parameters:
buffer
: The global buffer.
new
()
Creates and returns a new buffer.
Emits a BUFFER_NEW
event.
Return:
- the new buffer.
See also:
new_line
(buffer)
Inserts a new line character(s) at the caret depending on the end of line mode.
Parameters:
buffer
: The global buffer.
page_down
(buffer)
Moves the caret one page down.
Parameters:
buffer
: The global buffer.
page_down_extend
(buffer)
Moves the caret one page down, extending the selected text to the new position.
Parameters:
buffer
: The global buffer.
page_down_rect_extend
(buffer)
Moves the caret one page down, extending the rectangular selection to the new position.
Parameters:
buffer
: The global buffer.
page_up
(buffer)
Moves the caret one page up.
Parameters:
buffer
: The global buffer.
page_up_extend
(buffer)
Moves the caret one page up, extending the selected text to the new position.
Parameters:
buffer
: The global buffer.
page_up_rect_extend
(buffer)
Moves the caret one page up, extending the rectangular selection to the new position.
Parameters:
buffer
: The global buffer.
para_down
(buffer)
Moves the caret one paragraph down. Paragraphs are surrounded by one or more blank lines.
Parameters:
buffer
: The global buffer.
para_down_extend
(buffer)
Moves the caret one paragraph down, extending the selected text to the new position. Paragraphs are surrounded by one or more blank lines.
Parameters:
buffer
: The global buffer.
para_up
(buffer)
Moves the caret one paragraph up. Paragraphs are surrounded by one or more blank lines.
Parameters:
buffer
: The global buffer.
para_up_extend
(buffer)
Moves the caret one paragraph up, extending the selected text to the new position. Paragraphs are surrounded by one or more blank lines.
Parameters:
buffer
: The global buffer.
paste
(buffer)
Pastes the contents of the clipboard into the buffer, replacing the selected
text depending on buffer.multi_paste
.
Parameters:
buffer
: The global buffer.
point_x_from_position
(buffer, pos)
Returns the x-coordinate in the view of position pos.
Parameters:
buffer
: The global buffer.pos
: The position in buffer to get the x-coordinate in the view of.
Return:
- number
point_y_from_position
(buffer, pos)
Returns the y-coordinate in the view of position pos.
Parameters:
buffer
: The global buffer.pos
: The position in buffer to get the y-coordinate in the view of.
Return:
- number
position_after
(buffer, pos)
Returns the position of the next character after position pos, taking code
page into account, or buffer.length - 1
.
Parameters:
buffer
: The global buffer.pos
: The position in buffer to get the position after from.
position_before
(buffer, pos)
Returns the position of the previous character before position pos, taking
code page into account, or 0
.
Parameters:
buffer
: The global buffer.pos
: The position in buffer to get the position before from.
Return:
- number
position_from_line
(buffer, line)
Returns the position at the beginning of line number line.
Returns -1
if line is greater than buffer.line_count
.
Parameters:
buffer
: The global buffer.line
: The line number in buffer to get the beginning position for.
Return:
- number
position_from_point
(buffer, x, y)
Returns the position closest to view coordinates x and y, which may be in-between multi-byte characters.
Parameters:
buffer
: The global buffer.x
: The x-coordinate in the view to use.y
: The y-coordinate in the view to use.
Return:
- number
position_from_point_close
(buffer, x, y)
Returns the position closest to view coordinates x and y, which may be
in-between multi-byte characters, or -1
if the point is outside the window
or not close to any text.
Parameters:
buffer
: The global buffer.x
: The x-coordinate in the view to use.y
: The y-coordinate in the view to use.
Return:
- number
redo
(buffer)
Redoes the next undone action.
Parameters:
buffer
: The global buffer.
register_image
(buffer, type, xpm_data)
Registers XPM image xpm_data to type number type for use in autocompletion lists.
Parameters:
buffer
: The global buffer.type
: Integer type to register the image with.xpm_data
: The XPM data as described inbuffer:marker_define_pixmap()
.
register_rgba_image
(buffer, type, pixels)
Registers RGBA image pixels to type number type for use in autocompletion
lists.
The dimensions for pixels, buffer.rgba_image_width
and
buffer.rgba_image_height
, must be already defined. pixels is a sequence
of 4 byte pixel values (red, blue, green, and alpha) defining the image line
by line starting at the top-left pixel.
Parameters:
buffer
: The global buffer.type
: Integer type to register the image with.pixels
: The RGBA data as described inbuffer:marker_define_rgba_image()
.
reload
(buffer)
Reloads the file in the buffer.
Parameters:
buffer
: The global buffer.
replace_sel
(buffer, text)
Replaces the selected text with string text, scrolling the caret into view.
Parameters:
buffer
: The global buffer.text
: The text to replace the selected text with.
replace_target
(buffer, text)
Replaces the text in the target range with string text, returning the length of text. The recommended way to delete text in the buffer is to set the target to the text to be removed, and to call this function with an empty string.
Parameters:
buffer
: The global buffer.text
: The text to replace the target range with.
Return:
- number
replace_target_re
(buffer, text)
Replaces the text in the target range with string text after replacing any
“\d” sequences, where d
is a number in the range of 1
to 9
, with the
tag match values from the regular expression or the entire match for “\0”,
returning the length of the replacement text.
Parameters:
buffer
: The global buffer.text
: The text to replace the target range with.
Return:
- number
rotate_selection
(buffer)
Sets the next additional selection to be the main selection.
Parameters:
buffer
: The global buffer.
save
(buffer)
Saves the buffer to the file.
Emits FILE_BEFORE_SAVE
and FILE_AFTER_SAVE
events.
Parameters:
buffer
: The global buffer.
See also:
save_as
(buffer, utf8_filename)
Saves the buffer to the utf8_filename or user-specified filename.
Emits a FILE_SAVED_AS
event.
Parameters:
buffer
: The global buffer.utf8_filename
: The new filepath to save the buffer to. Must be UTF-8 encoded.
See also:
scroll_caret
(buffer)
Scrolls the caret into view based on the policies set with
buffer:set_x_caret_policy()
and buffer:set_y_caret_policy()
.
Parameters:
buffer
: The global buffer.
See also:
scroll_range
(buffer, secondary_pos, primary_pos)
Scrolls the range between primary_pos and secondary_pos into view, with
priority given to primary_pos.
Similar to buffer:scroll_caret()
, but with primary_pos instead of
buffer.current_pos
.
This is useful for scrolling search results into view.
Parameters:
buffer
: The global buffer.secondary_pos
: The secondary range position to scroll into view.primary_pos
: The primary range position to scroll into view.
scroll_to_end
(buffer)
Scrolls to the end of the buffer without moving the caret.
Parameters:
buffer
: The global buffer.
scroll_to_start
(buffer)
Scrolls to the beginning of the buffer without moving the caret.
Parameters:
buffer
: The global buffer.
search_anchor
(buffer)
Sets the current position to anchor subsequent searches with
buffer:search_next()
and buffer:search_prev()
.
Parameters:
buffer
: The global buffer.
search_in_target
(buffer, text)
Searches for the first occurrence of string text in the target range
bounded by buffer.target_start
and buffer.target_end
using search flags
buffer.search_flags
and, if found, sets the new target range to that
occurrence, returning its position or -1
otherwise.
Parameters:
buffer
: The global buffer.text
: The text to search the target range for.
Return:
- number
See also:
search_next
(buffer, flags, text)
Searches for and selects the first occurrence of string text starting at
the search anchor using search flags flags, returning the position of the
occurrence or -1
.
Selected text is not scrolled into view.
Parameters:
buffer
: The global buffer.flags
: The search flags to use. Seebuffer.search_flags
.text
: The text to search for.
Return:
- number
See also:
search_prev
(buffer, flags, text)
Searches for and selects the last occurrence of string text before the
search anchor using search flags flags, returning the position of the
occurrence or -1
.
Parameters:
buffer
: The global buffer.flags
: The search flags to use. Seebuffer.search_flags
.text
: The text to search for.
Return:
- number
See also:
select_all
(buffer)
Selects all of the text in the buffer without scrolling the view.
Parameters:
buffer
: The global buffer.
selection_duplicate
(buffer)
Duplicates the selected text or the current line.
Parameters:
buffer
: The global buffer.
set_chars_default
(buffer)
Resets the set of whitespace and word characters to their default characters.
Parameters:
buffer
: The global buffer.
See also:
set_empty_selection
(buffer, pos)
Sets the current position to position pos without scrolling the view, removing any selections.
Parameters:
buffer
: The bufferpos
: The position in buffer to move to.
set_encoding
(buffer, encoding)
Sets the encoding for the buffer to encoding, converting its contents from the old encoding to the new one.
Parameters:
buffer
: The global buffer.encoding
: The string encoding to set. Valid encodings are ones that GNU iconv accepts.
Usage:
buffer.set_encoding(buffer, 'ASCII')
set_fold_margin_colour
(buffer, use_setting, color)
Overrides the default color of the fold margin with color, in “0xBBGGRR”
format, if use_setting is true
.
Parameters:
buffer
: The global buffer.use_setting
: Whether or not to use color.color
: The color in “0xBBGGRR” format.
set_fold_margin_hi_colour
(buffer, use_setting, color)
Overrides the default highlight color of the fold margin with color, in
“0xBBGGRR” format, if use_setting is true
.
Parameters:
buffer
: The global buffer.use_setting
: Whether or not to use color.color
: The color in “0xBBGGRR” format.
set_hotspot_active_back
(buffer, use_setting, color)
Overrides the default background color of active hotspots with color, in
“0xBBGGRR” format, if use_setting is true
.
Parameters:
buffer
: The global buffer.use_setting
: Whether or not to use color.color
: The color in “0xBBGGRR” format.
set_hotspot_active_fore
(buffer, use_setting, color)
Overrides the default foreground color of active hotspots with color, in
“0xBBGGRR” format, if use_setting is true
.
Parameters:
buffer
: The global buffer.use_setting
: Whether or not to use color.color
: The color in “0xBBGGRR” format.
set_length_for_encode
(buffer, bytes)
Sets the length of string in buffer:encoded_from_utf8()
to bytes.
Parameters:
buffer
: The global buffer.bytes
: The number of bytes to encode, or-1
for measuring to first null byte.
set_lexer
(buffer, lang)
Sets the name of the lexer used by the buffer to lang or the auto-detected language and then loads the appropriate language-specific module if the module exists.
Parameters:
buffer
: The global buffer.lang
: Optional string language name to set. Ifnil
, attempts to auto-detect the buffer’s language.
Usage:
buffer.set_lexer(buffer, 'language_name')
set_save_point
(buffer)
Tells Scintilla the buffer has no unsaved changes.
Parameters:
buffer
: The global buffer.
set_sel
(buffer, start_pos, end_pos)
Selects the range of text from start_pos to end_pos in the buffer, scrolling the selected text into view.
Parameters:
buffer
: The global buffer.start_pos
: The start position of the range of text in buffer to select. If negative, it means the end of the buffer.end_pos
: The end position of the range of text in buffer to select. If negative, it means remove any selection (i.e. set theanchor
to the same position ascurrent_pos
).
set_sel_back
(buffer, use_setting, color)
Overrides the default background color of all selected text with color, in
“0xBBGGRR” format, if use_setting is true
.
Parameters:
buffer
: The global buffer.use_setting
: Whether or not to use color.color
: The color in “0xBBGGRR” format.
set_sel_fore
(buffer, use_setting, color)
Overrides the default foreground color of all selected text with color, in
“0xBBGGRR” format, if use_setting is true
.
Parameters:
buffer
: The global buffer.use_setting
: Whether or not to use color.color
: The color in “0xBBGGRR” format.
set_selection
(buffer, caret, anchor)
Selects the range of text from anchor to caret in the buffer, removing all other selections.
Parameters:
buffer
: The global buffer.caret
: The caret position of the range of text to select in buffer.anchor
: The anchor position of the range of text to select in buffer.
set_styling
(buffer, length, style)
Sets the style of the next length characters, from the current styling
position, to style number style, in the range from 0
to 255
, and
increments the styling position by length.
Parameters:
buffer
: The global buffer.length
: The number of characters to style.style
: The style number to set.
set_text
(buffer, text)
Replaces all of the text in the buffer with string text.
Parameters:
buffer
: The global buffer.text
: The text to set.
set_visible_policy
(buffer, visible_policy, visible_slop)
Sets the visible policy bit-mask visible_policy for displaying lines using
buffer:ensure_visible_enforce_policy()
to visible_slop number of lines
from the bottom of the view.
It is similar in operation to buffer:set_y_caret_policy()
.
Parameters:
buffer
: The global buffer.visible_policy
: The combination of_SCINTILLA.constants.VISIBLE_SLOP
(0x01) and_SCINTILLA.constants.VISIBLE_STRICT
(0x04) policy flags to set.visible_slop
: The slop value to use.
set_whitespace_back
(buffer, use_setting, color)
Overrides the background color of whitespace with color, in “0xBBGGRR”
format, if use_setting is true
.
Parameters:
buffer
: The global buffer.use_setting
: Whether or not to use color.color
: The color in “0xBBGGRR” format.
set_whitespace_fore
(buffer, use_setting, color)
Overrides the foreground color of whitespace with color, in “0xBBGGRR”
format, if use_setting is true
.
Parameters:
buffer
:use_setting
: Whether or not to use color.color
: The color in “0xBBGGRR” format.
set_x_caret_policy
(buffer, caret_policy, caret_slop)
Set the way the caret is kept visible when going sideways. The exclusion zone is given in pixels.
Parameters:
buffer
: The global buffer.caret_policy
: The combination of_SCINTILLA.constants.CARET_SLOP
(0x01),_SCINTILLA.constants.CARET_STRICT
(0x04),_SCINTILLA.constants.CARET_EVEN
(0x08), and_SCINTILLA.constants.CARET_JUMPS
(0x10) policy flags to set.caret_slop
: The slop value to use.
set_y_caret_policy
(buffer, caret_policy, caret_slop)
Set the way the line the caret is on is kept visible.
Parameters:
buffer
: The global buffer.caret_policy
: The combination of_SCINTILLA.constants.CARET_SLOP
(0x01),_SCINTILLA.constants.CARET_STRICT
(0x04),_SCINTILLA.constants.CARET_EVEN
(0x08), and_SCINTILLA.constants.CARET_JUMPS
(0x10) policy flags to set.caret_slop
: The slop value to use.
show_lines
(buffer, start_line, end_line)
Shows the range of lines from line number start_line to end_line. This has no effect on fold levels or fold flags and the first line cannot be hidden.
Parameters:
buffer
: The global buffer.start_line
: The start line of the range of lines in buffer to show.end_line
: The end line of the range of lines in buffer to show.
start_styling
(buffer, position, mask)
Begin styling at position position with the 8-bit styling bit-mask mask
that determines which style bits can be set with buffer:set_styling()
.
Parameters:
buffer
: The global buffer.position
: The position in buffer to start styling at.mask
: The bit mask of style bits that can be set when styling.
Usage:
buffer:start_styling(0, 0xFF)
stuttered_page_down
(buffer)
Moves the caret to the bottom of the page, or if already there, one page down.
Parameters:
buffer
: The global buffer.
stuttered_page_down_extend
(buffer)
Like buffer:stuttered_page_down()
, but extends the selected text to the new
position.
Parameters:
buffer
: The global buffer.
stuttered_page_up
(buffer)
Moves the caret to the top of the page, or if already there, one page up.
Parameters:
buffer
: The global buffer.
stuttered_page_up_extend
(buffer)
Like buffer:stuttered_page_up()
, but extends the selected text to the new
position.
Parameters:
buffer
: The global buffer.
style_clear_all
(buffer)
Sets all styles to have the same properties as
_SCINTILLA.constants.STYLE_DEFAULT
.
Parameters:
buffer
: The global buffer.
style_reset_default
(buffer)
Resets _SCINTILLA.constants.STYLE_DEFAULT
to its initial state.
Parameters:
buffer
: The global buffer.
swap_main_anchor_caret
(buffer)
Swaps the anchor and caret positions of the main selection.
Parameters:
buffer
: The global buffer.
tab
(buffer)
Indents the selected lines, replaces the selected text on a line with a Tab character (“\t”), or inserts a Tab character at the caret.
Parameters:
buffer
: The global buffer.
target_as_utf8
(buffer)
Returns the result of the text in the target range converted from the buffer’s code page into UTF-8.
Parameters:
buffer
: The global buffer.
target_from_selection
(buffer)
Sets the beginning and end positions of the target range to be the beginning and end positions of the main selection.
Parameters:
buffer
: The global buffer.
text_height
(buffer, line)
Returns the height in pixels of line number line.
Parameters:
buffer
: The global buffer.line
: The line number in buffer to get the pixel height of.
Return:
- number
text_range
(buffer, start_pos, end_pos)
Returns the range of text from start_pos to end_pos in the buffer.
Parameters:
buffer
: The global buffer.start_pos
: The start position of the range of text to get in buffer.end_pos
: The end position of the range of text to get in buffer.
text_width
(buffer, style_num, text)
Returns the width in pixels of string text styled with style number
style_num, in the range of 0
to 255
.
Parameters:
buffer
: The global buffer.style_num
: The style number between0
and255
to use.text
: The text to measure the width of.
Return:
- number
toggle_caret_sticky
(buffer)
Cycles between caret sticky option settings
_SCINTILLA.constants.SC_CARETSTICKY_ON
,
_SCINTILLA.constants.SC_CARETSTICKY_WHITESPACE
, and
_SCINTILLA.constants.SC_CARETSTICKY_OFF
.
Parameters:
buffer
: The global buffer.
See also:
toggle_fold
(buffer, line)
Toggles the fold state of a fold header line between expanded, where all of its child lines are displayed, and contracted, where all of its child lines are hidden.
Parameters:
buffer
: The global buffer.line
: The line number in buffer to toggle the fold on.
undo
(buffer)
Undoes the most recent action.
Parameters:
buffer
: The global buffer.
upper_case
(buffer)
Converts the selected text to upper case letters.
Parameters:
buffer
: The global buffer.
user_list_show
(buffer, list_type, item_list)
Displays a list from item_list, a sorted string whose items are delimited
by buffer.auto_c_separator
characters, using the list identifier number
list_type which is greater than zero and sent in a USER_LIST_SELECTION
event after selecting an item.
Parameters:
buffer
: The global buffer.list_type
: The list identifier number greater than zero to use.item_list
: The sorted string of words to show, separated bybuffer.auto_c_separator
characters (initially spaces).
See also:
vc_home
(buffer)
Moves the caret to the first visible character on the current line, or if already there, to the beginning of the current line.
Parameters:
buffer
: The global buffer.
vc_home_display
(buffer)
Moves the caret to the first visible character on the current wrapped line, or if already there, to the beginning of the current wrapped line.
Parameters:
buffer
: The global buffer.
vc_home_display_extend
(buffer)
Like buffer:vc_home_display()
, but extends the selected text to the new
position.
Parameters:
buffer
: The global buffer.
vc_home_extend
(buffer)
Like buffer:vc_home()
, but extends the selected text to the new position.
Parameters:
buffer
: The global buffer.
vc_home_rect_extend
(buffer)
Like buffer:vc_home()
, but extends the rectangular selection to the new
position.
Parameters:
buffer
: The global buffer.
vc_home_wrap
(buffer)
Moves the caret to the first visible character on the wrapped line, or if already there, to the beginning of the actual line.
Parameters:
buffer
: The global buffer.
vc_home_wrap_extend
(buffer)
Like buffer:vc_home_wrap()
, but extends the selected text to the new
position.
Parameters:
buffer
: The global buffer.
vertical_centre_caret
(buffer)
Centers current line in the view.
Parameters:
buffer
: The global buffer.
visible_from_doc_line
(buffer, line)
Returns the displayed line number of actual line number line, taking hidden
lines into account, or -1
if line is outside the range of lines in the
buffer.
Lines can occupy more than one display line if they wrap.
Parameters:
buffer
: The global buffer.line
: The line number in buffer to use.
Return:
- number
word_end_position
(buffer, pos, only_word_chars)
Returns the position of the end of the word at position pos.
buffer.word_chars
contains word characters. If pos has a non-word
character to its right and only_word_chars is false
, returns the position
of the first word character.
Parameters:
buffer
: The global buffer.pos
: The position in buffer of the word.only_word_chars
: Iftrue
, stops searching at the first non-word character in the search direction. Otherwise, the first character in the search direction sets the type of the search as word or non-word and the search stops at the first non-matching character. Searches are also terminated by the start or end of the buffer.
word_left
(buffer)
Moves the caret left one word.
buffer.word_chars
contains word characters.
Parameters:
buffer
: The global buffer.
word_left_end
(buffer)
Moves the caret left one word, positioning the caret at the end of the
previous word.
buffer.word_chars
contains word characters.
Parameters:
buffer
: The global buffer.
word_left_end_extend
(buffer)
Like buffer:word_left_end()
, but extends the selected text to the new
position.
Parameters:
buffer
: The global buffer.
word_left_extend
(buffer)
Moves the caret left one word, extending the selected text to the new
position.
buffer.word_chars
contains word characters.
Parameters:
buffer
: The global buffer.
word_part_left
(buffer)
Moves to the previous underscore or change in capitalization within the
current word.
buffer.word_chars
contains word characters.
Parameters:
buffer
: The global buffer.
word_part_left_extend
(buffer)
Moves to the previous underscore or change in capitalization within the
current word, extending the selected text to the new position.
buffer.word_chars
contains word characters.
Parameters:
buffer
: The global buffer.
word_part_right
(buffer)
Moves to the next underscore or change in capitalization within the current
word.
buffer.word_chars
contains word characters.
Parameters:
buffer
: The global buffer.
word_part_right_extend
(buffer)
Moves to the next underscore or change in capitalization within the current
word, extending the selected text to the new position.
buffer.word_chars
contains word characters.
Parameters:
buffer
: The global buffer.
word_right
(buffer)
Moves the caret right one word.
buffer.word_chars
contains word characters.
Parameters:
buffer
: The global buffer.
word_right_end
(buffer)
Moves the caret right one word, positioning the cursor at the end of the
current word.
buffer.word_chars
contains word characters.
Parameters:
buffer
: The global buffer.
word_right_end_extend
(buffer)
Like buffer:word_right_end()
, but extends the selected text to the new
position.
Parameters:
buffer
: The global buffer.
word_right_extend
(buffer)
Moves the caret right one word, extending the selected text to the new
position.
buffer.word_chars
contains word characters.
Parameters:
buffer
: The global buffer.
word_start_position
(buffer, pos, only_word_chars)
Returns the position of the beginning of the word at position pos.
buffer.word_chars
contains word characters. If pos has a non-word
character to its left and only_word_chars is false
, returns the position
of the last word character.
Parameters:
buffer
: The global buffer.pos
: The position in buffer of the word.only_word_chars
: Iftrue
, stops searching at the first non-word character in the search direction. Otherwise, the first character in the search direction sets the type of the search as word or non-word and the search stops at the first non-matching character. Searches are also terminated by the start or end of the buffer.
wrap_count
(buffer, line)
Returns the number of wrapped lines needed to display line number line.
Parameters:
buffer
: The global buffer.line
: The line number in buffer to use.
Return:
- number
zoom_in
(buffer)
Increases the size of all fonts by one point, up to 20.
Parameters:
buffer
: The global buffer.
zoom_out
(buffer)
Decreases the size of all fonts by one point, down to -10.
Parameters:
buffer
: The global buffer.