iup-ffi 0.13.0-x86_64-linux

data/lib/wrapped/scintilla.rb

@@ -0,0 +1,1112 @@
+module Iup
+
+  # A powerful text element.
+  # The API documentation can only hint at the use of this control. For more
+  # information see Tecgraf's documentation on 
+  # {IupScintilla}[https://www.tecgraf.puc-rio.br/iup/en/ctrl/iup_scintilla.html]
+  # and the {Scintilla}[http://www.scintilla.org/] website.
+  #
+  # === Example
+  #
+  # The following example sets up a Scintilla text widget handling some cpp
+  # code. Notice the setup of the keywords and styling settings.
+  # Also, the text widget must be placed into a dialog and mapped before 
+  # its other attributes are set and the dialog shown.
+  #
+  #   text = Iup::Scintilla.new 
+  # 
+  #   dlg = Iup::Dialog.new(text) do |d|
+  #     d.title = 'Scintilla example'
+  #     d.size = '300x200'
+  #   end.map
+  # 
+  #   text.expand = 'YES'
+  #   text.lexerlanguage = 'cpp'
+  #   text.keywords(0, "void struct union enum char short int long double float
+  #     signed unsigned const static extern auto register volatile bool class
+  #     private protected public friend inline template virtual asm explicit
+  #     typename mutable if else switch case default break goto return for while
+  #     do continue typedef sizeof NULL new delete throw try catch namespace
+  #     operator this const_cast static_cast dynamic_cast reinterpret_cast true
+  #     false using typeid and and_eq bitand bitor compl not not_eq or or_eq xor
+  #     xor_eq")
+  #   text.stylefont(32, 'Consolas')
+  #   text.stylefontsize(32, 11)
+  #   text.styleclearall = 'Yes'
+  #   text.stylefgcolor(1, '0 128 0') # 1 - C Comment
+  #   text.stylefgcolor(2, '0 128 0') # 2 - C++ Comment line
+  #   text.stylefgcolor(4, '128 0 0') # 4 - Number
+  #   text.stylefgcolor(5, '0 0 255') # 5 - Keyword
+  #   text.stylefgcolor(6, '160 20 20') # 6 - String
+  #   text.stylefgcolor(7, '128 0 0') # 7 - Character
+  #   text.stylefgcolor(9, '0 0 255') # 9 - Preprocessor block
+  #   text.stylefgcolor(10, '255 0 255') # 10 - Operator
+  #   text.stylebold(10, 'YES')
+  #   text.stylehotspot(6, 'YES')
+  #   text.marginwidth(0, 50)
+  #   text.property('fold', 1)
+  #   text.property('fold.compact', 0)
+  #   text.property('fold.comment', 1)
+  #   text.property('fold.preprocessor', 1)
+  #   text.marginwidth(1, 20)
+  #   text.margintype(1, 'SYMBOL')
+  #   text.marginmaskfolders(1, 'Yes')
+  # 
+  #   text.markerdefine('folder', 'plus')
+  #   text.markerdefine('folderopen', 'minus')
+  #   text.markerdefine('folderend', 'empty')
+  #   text.markerdefine('foldermidtail', 'empty')
+  #   text.markerdefine('folderopenmid', 'empty')
+  #   text.markerdefine('foldersub', 'empty')
+  #   text.markerdefine('foldertail', 'empty')
+  # 
+  #   text.foldflags = 'lineafter_contracted'
+  # 
+  #   text.marginsensitive(1, 'YES')
+  # 
+  #   dlg.show
+  #--
+  # TODO: This class's actions are incomplete
+  #
+  class Scintilla < Iup::Widget
+    @@opened = false
+
+    # Creates a new instance.
+    # If a block is given, the new instance is yielded to it.
+    def initialize
+      unless @@opened
+        # make sure the scintilla library is opened on first use
+        ScintillaLib.IupScintillaOpen
+        @@opened = true
+      end
+      @handle = ScintillaLib.IupScintilla
+
+      yield self if block_given?
+    end
+
+    # :section: General attributes
+
+    ##
+    # :attr: border
+    # Sets border around widget, values 'yes' / 'no'.
+    define_attribute :border
+
+    ##
+    # :attr: canfocus
+    # If set, the control can gain focus, values 'yes' / 'no'.
+    define_attribute :canfocus
+
+    ##
+    # :attr: clipboard
+    # 'clear' / 'copy' / 'cut' / 'paste', access the clipboard with the current selection.
+    define_attribute :clipboard
+
+    ##
+    # :attr: cursor
+    # Defines the mouse shape / cursor for the canvas.
+    # Available cursors are shown in the
+    # {Tecgraf documentation}[http://www.tecgraf.puc-rio.br/iup/en/attrib/iup_cursor.html].
+    define_attribute :cursor
+
+    ##
+    # :attr: overwrite
+    # 'off' / 'on', when enabled, new characters replace the one to the right
+    # of the text caret.
+    define_attribute :overwrite
+
+    ##
+    # :attr: readonly
+    # 'no' / 'yes' setting to restrict editing of text.
+    define_attribute :readonly
+
+    ##
+    # :attr: size
+    # Size of the container, in character units, value as "widthxheight".
+    define_attribute :size
+
+    ##
+    # :attr: usepopup
+    # 'yes' / 'no' controls visibility of right-click popup menu available to
+    # user.
+    define_attribute :usepopup
+
+    ##
+    # :attr: visiblecolumns
+    # Accesses the number of visible columns for the control's natural size.
+    define_attribute :visiblecolumns
+
+    ##
+    # :attr: visiblelines
+    # Accesses the number of visible lines for the control's natural size.
+    define_attribute :visiblelines
+
+    ##
+    # :attr_reader: visiblelinescount
+    # Returns the number of lines which are visible.
+    define_reader :visiblelinescount
+
+    ##
+    # :attr: wordwrap
+    # Values 'yes' / 'no'.
+    define_attribute :wordwrap
+
+    ##
+    # :attr: wordwrapvisualflags
+    # Controls the drawing of visual flags to show word-wrap has occurred.
+    # Values 'yes' / 'no'.
+    define_attribute :wordwrapvisualflags
+
+    # :section: Text retrieval and modification attributes
+
+    ##
+    # :attr_writer: add
+    # Inserts a string at the current position.
+    define_writer :add
+
+    ##
+    # :attr_writer: append
+    # Inserts a string at the end of the text.
+    define_writer :append
+
+    ##
+    # :method: char
+    # :call-seq:
+    #   text.char(id)
+    #
+    # * +id+ - position in the text.
+    # Returns the character at a given position.
+    define_id_reader :char
+
+    ##
+    # :attr_writer: clearall
+    # Deletes all text, unless the control is readonly.
+    define_writer :clearall
+
+    ##
+    # :attr_reader: count
+    # Returns the number of characters in the text.
+    define_reader :count
+
+    ##
+    # Deletes a range of text:
+    # * +pos+ - position of start of range in text
+    # * +len+ - number of characters to delete
+    def deleterange(pos, len)
+      IupLib.IupSetAttribute(@handle, "DELETERANGE", "#{pos},#{len}")
+    end
+
+    ##
+    # :method: insert
+    # :call-seq:
+    #   text.insert(id, str)
+    #
+    # * +id+ - position in the text
+    # * +str+ - text string
+    # Inserts a text string at position "id".
+    define_id_writer :insert
+
+    ##
+    # :method: line
+    # :call-seq:
+    #   text.line(id)
+    #
+    # * +id+ - position in the text.
+    # Returns the text of the line referenced by given "id".
+    define_id_reader :line
+
+    ##
+    # :attr_reader: linecount
+    # Returns the number of lines in the text.
+    define_reader :linecount
+
+    ##
+    # :attr_reader: linevalue
+    # Returns the text of the line where the caret is.
+    define_reader :linevalue
+
+    ##
+    # :attr_writer: prepend
+    # Inserts a string at the beginning of the text.
+    define_writer :prepend
+
+    ##
+    # :attr: value
+    # \Text entered by the user.
+    define_attribute :value
+
+    # :section: Annotation attributes
+
+    ##
+    # :method: annotationtext 
+    # :call-seq:
+    #   text.annotationtext(id)
+    #   text.annotationtext(id, val)
+    #
+    # For the "id" line number, accesses its annotation.
+    define_id_attribute :annotationtext
+
+    ##
+    # :method: annotationstyle
+    # :call-seq:
+    #   text.annotationstyle(id)
+    #   text.annotationstyle(id, val)
+    #
+    # For the "id" line number, accesses its style.
+    define_id_attribute :annotationstyle
+
+    ##
+    # :attr: annotationstyleoffset
+    # A style offset separates the annotation and text.
+    define_attribute :annotationstyleoffset
+
+    ##
+    # :attr: annotationvisible
+    # Setting to enable or display annotations.
+    # Values 'hidden' / 'standard' / 'boxed'.
+    define_attribute :annotationvisible
+
+    ##
+    # :attr: annotationclearall
+    # Deletes all annotations.
+    define_attribute :annotationclearall
+
+    # :section: Auto-completion attributes
+
+    ##
+    # :method: autocshow
+    # :call-seq:
+    #   text.autocshow(id, val)
+    #
+    # Shows a list of words with "id" being the 
+    # number of characters entered by user.
+    define_id_writer :autocshow
+
+    ##
+    # :attr_writer: autoccancel
+    # Removes any displayed auto-completion list.
+    define_writer :autoccancel
+
+    ##
+    # :attr_reader: autocactive
+    # Returns "YES" if there is an auto-completion list showing.
+    define_reader :autocactive
+
+    ##
+    # :attr_reader: autocposstart
+    # Returns current start position of auto-completion list.
+    define_reader :autocposstart
+
+    ##
+    # :attr_writer: autoccomplete
+    # Starts the auto-completion.
+    define_writer :autoccomplete
+
+    ##
+    # :attr_writer: autocselect
+    # Select an item from auto-completion list.
+    define_writer :autocselect
+
+    ##
+    # :attr_reader: autocselectedindex
+    # Returns index of currently selected item.
+    define_reader :autocselectedindex
+
+    ##
+    # :attr: autocdroprestofword
+    # Controls if remaining characters are deleted once an item is 
+    # selected.
+    # Values 'yes' / 'no'.
+    define_attribute :autocdroprestofword
+
+    ##
+    # :attr: autocmaxheight
+    # Controls number of rows visible in auto-completion list.
+    define_attribute :autocmaxheight
+
+    ##
+    # :attr: autocmaxwidth
+    # Controls width of auto-completion list, in characters.
+    define_attribute :autocmaxwidth
+
+    # :section: Brace highlighting attributes
+
+    ##
+    # :attr_writer: bracehighlight
+    # Using format "pos1:pos2", highlights the brace.
+    define_writer :bracehighlight
+
+    ##
+    # :attr_writer: bracebadlight
+    # Using format "pos1:pos2", highlights a mis-matching brace.
+    define_writer :bracebadlight
+
+    ##
+    # :method: bracematch
+    # :call-seq:
+    #   text.bracematch(id)
+    #
+    # Finds a match for the brace at character position "id".
+    define_id_reader :bracematch
+
+    # :section: Caret and selection attributes
+
+    ##
+    # :attr: caret
+    # Position of the insertion point, in "lin,col" format.
+    define_attribute :caret
+
+    ##
+    # :attr: caretpos
+    # Position of the insertion point, as a 0-based character position.
+    define_attribute :caretpos
+
+    ##
+    # :attr_writer: carettoview
+    # Ensures caret is on a visible line.
+    define_writer :carettoview
+
+    ##
+    # :attr: selectedtext
+    # Accesses the currently selected text.
+    define_attribute :selectedtext
+
+    ##
+    # :attr: selection
+    # Identifies selection in format "lin1,col1:lin2,col2" / 'all' / 'none'.
+    define_attribute :selection
+
+    ##
+    # :attr: selectionpos
+    # Identifies selection in 0-based character position format "pos1:pos2" /
+    # 'all' / 'none'.
+    define_attribute :selectionpos
+
+    # :section: Folding attributes
+
+    ##
+    # :attr_writer: foldflags
+    # Style of drawn fold lines, one of:
+    # 'LINEBEFORE_EXPANDED' / 'LINEBEFORE_CONTRACTED' / 'LINEAFTER_EXPANDED' /
+    # 'LINEAFTER_CONTRACTED'
+    define_writer :foldflags
+
+    ##
+    # :method: foldlevel
+    # :call-seq:
+    #   text.foldlevel(id)
+    #   text.foldlevel(id, val)
+    #
+    # The fold level of line "id".
+    define_id_attribute :foldlevel
+
+    ##
+    # :attr_writer: foldtoggle
+    # Expands or closes fold point, based on line number
+    define_writer :foldtoggle
+
+    # :section: Lexer attributes
+
+    ##
+    # :method: keywords
+    # :call-seq:
+    #   text.keywords(id, val)
+    #
+    # Creates a keyword list with an id in range 0 to 8.
+    define_id_writer :keywords
+
+    ##
+    # :attr_reader: keywordsets
+    # Returns description of all keyword lists.
+    define_reader :keywordsets
+
+    ##
+    # :attr: lexerlanguage
+    # Any name supported by Scintilla, e.g. 'ruby' / 'bash' / 'tex'.
+    define_attribute :lexerlanguage
+
+    ##
+    # :attr_writer: loadlexerlibrary
+    # Loads a lexer from a given filename.
+    define_writer :loadlexerlibrary
+
+    ##
+    # :method: property
+    # :call-seq:
+    #   text.property(name)
+    #   text.property(name, value)
+    #
+    # Access lexer properties.
+    define_property_attribute :property
+
+    ##
+    # :attr_reader: propertynames
+    # Returns a list of property names.
+    define_reader :propertynames
+
+    # :section: Margin attributes
+
+    ##
+    # :method: marginmaskfolders
+    # :call-seq:
+    #   text.marginmaskfolders(id)
+    #   text.marginmaskfolders(id, val)
+    #
+    # Define if margin "id" is folding or non-folding, 
+    # values 'yes' / 'no'.
+    define_id_attribute :marginmaskfolders
+
+    ##
+    # :method: marginsensitive
+    # :call-seq:
+    #   text.marginsensitive(id)
+    #   text.marginsensitive(id, val)
+    #
+    # Define if margin "id" is sensitive or not,
+    # values 'yes' / 'no'.
+    define_id_attribute :marginsensitive
+
+    ##
+    # :method: margintype
+    # Define and set type of margin "id".
+    # Values 'symbol' / 'number' / 'text' / 'rtext' / 'background' /
+    # 'foreground'
+    define_id_attribute :margintype
+
+    ##
+    # :method: marginwidth
+    # :call-seq:
+    #   text.marginwidth(id)
+    #   text.marginwidth(id, val)
+    #
+    # Defines width of a margin "id" in pixels.
+    define_id_attribute :marginwidth
+
+    ##
+    # :method: marginleft
+    # :call-seq:
+    #   text.marginleft(id)
+    #   text.marginleft(id, val)
+    #
+    # Defines size of blank margin on the left size.
+    define_id_attribute :marginleft
+
+    ##
+    # :method: marginright
+    # :call-seq:
+    #   text.marginright(id)
+    #   text.marginright(id, val)
+    #
+    # Defines size of blank margin on the right size.
+    define_id_attribute :marginright
+
+    ##
+    # :method: margintext
+    # :call-seq:
+    #   text.margintext(id)
+    #   text.margintext(id, val)
+    #
+    # * +id+ - the line number
+    # Controls text of each line.
+    define_id_attribute :margintext
+
+    ##
+    # :method: margintextstyle
+    # :call-seq:
+    #   text.margintextstyle(id)
+    #   text.margintextstyle(id, val)
+    #
+    # * +id+ - the line number
+    # Controls style of text of each line.
+    define_id_attribute :margintextstyle
+
+    ##
+    # :method: margintextclearall
+    # :call-seq:
+    #   text.margintextclearall(id)
+    #
+    # Clears text and styles of given margin "id".
+    define_id_writer :margintextclearall
+
+    ##
+    # :method: margincursor
+    # :call-seq:
+    #   text.margincursor(id)
+    #   text.margincursor(id, val)
+    #
+    # Accesses the cursor for margin, 
+    # values 'reversearrow' / 'arrow'.
+    define_id_attribute :margincursor
+
+    # :section: Marker attributes
+
+    ##
+    # :method: markerdefine
+    # :call-seq:
+    #   text.markerdefine(number, marker)
+    #
+    # Sets marker for given number.
+    define_property_writer :markerdefine
+
+    ##
+    # :method: markersymbol
+    # :call-seq:
+    #   text.marginsymbol(id)
+    #   text.marginsymbol(id, val)
+    #
+    # Associates marker number with symbol.
+    define_id_attribute :markersymbol
+
+    ##
+    # :method: markerfgcolor
+    # :call-seq:
+    #   text.markerfgcolor(id, val)
+    #
+    # Defines foreground color of given marker number.
+    # Values as 'r g b'.
+    define_id_writer :markerfgcolor
+
+    ##
+    # :method: bgcolor
+    # :call-seq:
+    #   text.markerbgcolor(id, val)
+    #
+    # Defines background color of given marker number.
+    # Values as 'r g b'.
+    define_id_writer :bgcolor
+
+    ##
+    # :method: markerbgcolorsel
+    # :call-seq:
+    #   text.markerbgcolorsel(id, val)
+    #
+    # Defines highlight background color of given marker number.
+    # Values as 'r g b'.
+    define_id_writer :markerbgcolorsel
+
+    ##
+    # :method: markeralpha
+    # :call-seq:
+    #   text.markeralpha(id, val)
+    #
+    # Defines alpha value of given marker number.
+    define_id_writer :markeralpha
+
+    ##
+    # :method: markerrgbaimage
+    # :call-seq:
+    #   text.markerrgbaimage(id, val)
+    #
+    # Defines image to be used on a marker number: 
+    # must be an Iup::ImageRGBA.
+    define_id_writer :markerrgbaimage
+
+    ##
+    # :method: markerrgbaimagescale
+    # :call-seq:
+    #   text.markerrgbaimagescale(id, val)
+    #
+    # Defines image scale factor, as a percent (1-100).
+    define_id_writer :markerrgbaimagescale
+
+    ##
+    # :attr: markerhighlight
+    # Accesses highlight of folding block when selected.
+    # Values 'yes' / 'no'.
+    define_attribute :markerhighlight
+
+    ##
+    # :method: markeradd
+    # :call-seq:
+    #   text.markeradd(id, val)
+    #
+    # Adds marker number to given line "id".
+    define_id_writer :markeradd
+
+    ##
+    # :method: markerdelete
+    # :call-seq:
+    #   text.markerdelete(id, val)
+    #
+    # Deletes marker number to given line "id".
+    define_id_writer :markerdelete
+
+    ##
+    # :call-seq:
+    #   text.markerdeleteall(val)
+    #
+    # Removes given marker from all lines.
+    def markerdeleteall(val)
+      IupLib.IupSetAttribute(@handle, "MARKERDELETEALL", val.to_s)
+    end
+
+    ##
+    # :method: markerget
+    # :call-seq:
+    #   text.markerget(id)
+    #
+    # Returns marker mask with markers for given line "id".
+    define_id_reader :markerget
+
+    ##
+    # :method: markernext
+    # :call-seq:
+    #   text.markernext(id, mask)
+    #
+    # Searches for a given marker mask, starting from line "id"
+    # and moving forwards.
+    define_id_writer :markernext
+
+    ##
+    # :method: markerprevious
+    # :call-seq:
+    #   text.markerprevious(id, mask)
+    #
+    # Searches for a given marker mask, starting from line "id"
+    # and moving backwards.
+    define_id_writer :markerprevious
+
+    ##
+    # :method: markerlinefromhandle
+    # :call-seq:
+    #   text.markerlinefromhandle(id)
+    #
+    # Searches for a marker given its handle "id".
+    define_id_reader :markerlinefromhandle
+
+    ##
+    # :attr_writer: markerdeletehandle
+    # Searches for a marker given its handle "id" and deletes it, if found.
+    define_writer :markerdeletehandle
+
+    ##
+    # :attr_reader: lastmarkeraddhandle
+    # Returns the last handle created by #markeradd.
+    define_reader :lastmarkeraddhandle
+
+    ##
+    # :attr_reader: lastmarkerfound
+    # Returns last line number with marker found by #markernext.
+    define_reader :lastmarkerfound
+
+    # :section: Scrolling attributes
+
+    ##
+    # :attr: scrollbar
+    # Adds a scrollbar to the widget.
+    # Values 'horizontal' / 'vertical' / 'yes' / 'no'.
+    define_attribute :scrollbar
+
+    ##
+    # :attr_writer: scrolltocaret
+    # Make given caret position visible.
+    define_writer :scrolltocaret
+
+    ##
+    # :attr: scrollwidth
+    # Controls document width in pixels, default: 2000.
+    define_attribute :scrollwidth
+
+    # :section: Search and replace attributes
+
+    ##
+    # :attr_writer: searchintarget
+    # Searches for text string within #targetstart #targetend bounds.
+    define_writer :searchintarget
+
+    ##
+    # :attr: searchflags
+    # Accesses flags - possible values are 'MATCHCASE' / 'WHOLEWORD' /
+    # 'WORDSTART' / 'REGEXP' / 'POSIX'. Combine flags using '|', and
+    # clear with +nil+.
+    define_attribute :searchflags
+
+    ##
+    # :attr: targetstart
+    # Character position of start of target.
+    define_attribute :targetstart
+
+    ##
+    # :attr: targetend
+    # Character position of end of target.
+    define_attribute :targetend
+
+    ##
+    # :attr_writer: targetfromselection
+    # Sets target start and end based on current selection.
+    define_writer :targetfromselection
+
+    ##
+    # :attr_writer: targetwholedocument
+    # Sets target start and end to the whole document.
+    define_writer :targetwholedocument
+
+    ##
+    # :attr: replacetarget
+    # Replaces the target text.
+    define_writer :replacetarget
+
+    # :section: Style definition attributes
+
+    ##
+    # :method: stylebgcolor
+    # :call-seq:
+    #   text.stylebgcolor(id)
+    #   text.stylebgcolor(id, val)
+    #
+    # Background color for a style, as 'r g b'.
+    define_id_attribute :stylebgcolor
+
+    ##
+    # :method: stylebold
+    # :call-seq:
+    #   text.stylebold(id)
+    #   text.stylebold(id, val)
+    #
+    # Bold setting for a style.
+    define_id_attribute :stylebold
+
+    ##
+    # :method: stylecase
+    # :call-seq:
+    #   text.stylecase(id)
+    #   text.stylecase(id, val)
+    #
+    # \Text characteristics for a style.
+    define_id_attribute :stylecase
+
+    ##
+    # :method: stylecharset
+    # :call-seq:
+    #   text.stylecharset(id)
+    #   text.stylecharset(id, val)
+    #
+    # Alter charset for a style, values include 'ANSI' / 'EASTEUROPE' /
+    # 'RUSSIAN' / 'GB2312' / 'HANGUL' / 'SHIFTJIS'.
+    define_id_attribute :stylecharset
+
+    ##
+    # :attr: styleclearall
+    # Returns all styles to attributes of the default style.
+    define_attribute :styleclearall
+
+    ##
+    # :method: styleeolfilled
+    # :call-seq:
+    #   text.styleeolfilled(id)
+    #   text.styleeolfilled(id, val)
+    #
+    # Whether to set a line to same color set as last character on line, 
+    # values 'yes' / 'no'.
+    define_id_attribute :styleeolfilled
+
+    ##
+    # :method: stylefgcolor
+    # :call-seq:
+    #   text.stylefgcolor(id)
+    #   text.stylefgcolor(id, val)
+    #
+    # Foreground color for a style, as 'r g b'.
+    define_id_attribute :stylefgcolor
+
+    ##
+    # :method: stylefont
+    # :call-seq:
+    #   text.stylefont(id)
+    #   text.stylefont(id, val)
+    #
+    # Font name for a style.
+    define_id_attribute :stylefont
+
+    ##
+    # :method: stylefontsize
+    # :call-seq:
+    #   text.stylefontsize(id)
+    #   text.stylefontsize(id, val)
+    #
+    # Font size for a style.
+    define_id_attribute :stylefontsize
+
+    ##
+    # :method: stylefontsizefrac
+    # :call-seq:
+    #   text.stylefontsizefrac(id)
+    #   text.stylefontsizefrac(id, val)
+    #
+    # Font size as a fractional point size for a style.
+    define_id_attribute :stylefontsizefrac
+
+    ##
+    # :method: stylehotspot
+    # :call-seq:
+    #   text.stylehotspot(id)
+    #   text.stylehotspot(id, val)
+    #
+    # Marks ranges to respond to mouse clicks.
+    define_id_attribute :stylehotspot
+
+    ##
+    # :method: styleitalic
+    # :call-seq:
+    #   text.styleitalic(id)
+    #   text.styleitalic(id, val)
+    #
+    # Italic setting for a style.
+    define_id_attribute :styleitalic
+
+    ##
+    # :method: stylereset
+    # :call-seq:
+    #   text.stylereset(id)
+    #   text.stylereset(id, val)
+    #
+    # Resets style to default.
+    define_id_attribute :stylereset
+
+    ##
+    # :method: styleunderline
+    # :call-seq:
+    #   text.styleunderline(id)
+    #   text.styleunderline(id, val)
+    #
+    # Underline setting for a style.
+    define_id_attribute :styleunderline
+
+    ##
+    # :method: stylevisible
+    # :call-seq:
+    #   text.stylevisible(id)
+    #   text.stylevisible(id, val)
+    #
+    # Values 'yes' / 'no', for visible text.
+    define_id_attribute :stylevisible
+
+    ##
+    # :method: styleweight
+    # :call-seq:
+    #   text.styleweight(id)
+    #   text.styleweight(id, val)
+    #
+    # Font weight for a style.
+    define_id_attribute :styleweight
+
+    # :section: Styling attributes
+
+    ##
+    # :attr_writer: cleardocumentstyle
+    # Resets and clears styling and folding.
+    define_writer :cleardocumentstyle
+
+    ##
+    # :attr_writer: startstyling
+    # Prepares for styling, setting the start position.
+    define_writer :startstyling
+
+    ##
+    # :method: styling
+    # :call-seq:
+    #   text.styling(id, length)
+    #
+    # Sets style of given length characters using style "id".
+    define_id_writer :styling
+
+    # :section: Tabs and indentation attributes
+
+    ##
+    # :attr: tabsize
+    # Number of characters for a tab. Default is 8.
+    define_attribute :tabsize
+
+    ##
+    # :attr: indentationguides
+    # Controls dotted vertical lines to show indentation white space, 
+    # values 'none' / 'real' / 'lookforward' / 'lookboth'.
+    define_attribute :indentationguides
+
+    ##
+    # :attr: highlightguide
+    # Highlights indentation guide of a given column.
+    define_attribute :highlightguide
+
+    ##
+    # :attr: usetabs
+    # Use tabs for indentation or only spaces, 
+    # values 'yes' / 'no'.
+    define_attribute :usetabs
+
+    # :section: Undo and redo attributes
+
+    ##
+    # :attr: redo
+    # Redo the last operation if set to 'yes', or all operations if 
+    # set to 'all'.
+    define_attribute :redo
+
+    ##
+    # :attr: undo
+    # Undo the last operation if set to 'yes', or all operations if 
+    # set to 'all'.
+    define_attribute :undo
+
+    ##
+    # :attr: undocollect
+    # Controls collection of undo information, value 'yes' / 'no'.
+    define_attribute :undocollect
+
+    # :section: White space attributes
+
+    ##
+    # :attr: extraascent
+    # Controls extra space between lines, beyond maximum ascent.
+    define_attribute :extraascent
+
+    ##
+    # :attr: extradescent
+    # Controls extra space between lines, beyond maximum descent.
+    define_attribute :extradescent
+
+    ##
+    # :attr: whitespaceview
+    # Controls the display of white space, values 'invisible' / 'visiblealways'
+    # / 'visibleafterindent'.
+    define_attribute :whitespaceview
+
+    ##
+    # :attr: whitespacesize
+    # Size of dots when separating space characters, default is 3.
+    define_attribute :whitespacesize
+
+    ##
+    # :attr_writer: whitespacefgcolor
+    # Defines foreground color of visible white space, in 'r g b' format.
+    define_writer :whitespacefgcolor
+
+    ##
+    # :attr_writer: whitespacebgcolor
+    # Defines background color of visible white space, in 'r g b' format.
+    define_writer :whitespacebgcolor
+
+    # :section: Zooming attributes
+
+    ##
+    # :attr_writer: zoomin
+    # Increase zoom factor by one point.
+    define_writer :zoomin
+
+    ##
+    # :attr_writer: zoomout
+    # Decrease zoom factor by one point.
+    define_writer :zoomout
+
+    ##
+    # :attr: zoom
+    # Accesses the zoom factor, range -10 to 20.
+    define_attribute :zoom
+
+    # :section: Standard attributes
+
+    ##
+    # :attr: expand
+    # Allows control to fill available space in indicated direction.
+    # Values 'no' / 'horizontal' / 'vertical' / 'yes'.
+    define_attribute :expand
+
+    ##
+    # :attr_reader: position
+    # Returns position in pixels within client window as "x,y".
+    define_reader :position
+
+    ##
+    # :attr: rastersize
+    # Size of the button, in pixels, value as "widthxheight".
+    define_attribute :rastersize
+
+    ##
+    # :attr_reader: screenposition
+    # Returns position in pixels on screen as "x,y".
+    define_reader :screenposition
+
+    ##
+    # :attr: tip
+    # Tooltip string.
+    define_attribute :tip
+
+    # :section: Callbacks
+
+    ##
+    # :attr_writer: action
+    # Callback called when the text is edited, but before its value is actually changed.
+    # Callback must respond to +call+ and takes a 4-argument callback: (insert, position, length, text)
+    # * +insert+ - "1" for inserted text, "0" for deleted text
+    # * +position+ - 0-base character position when change started
+    # * +length+ - size of the cahange
+    # * +text+ - the inserted text value, "" if text deleted
+
+    # --
+    def action= callback
+      unless callback.arity == 4
+        raise ArgumentError, 'action callback must take 4 arguments: (insert, position, length, text)'
+      end
+      cb = Proc.new do |ih, insert, pos, length, text|
+        callback.call insert, pos, length, text
+      end
+      define_callback cb, 'ACTION', :iiis_i
+    end
+
+    include ButtonCallback
+
+    ##
+    # :attr_writer: caret_cb
+    # Callback called when the caret/cursor position is changed.
+    # Callback must respond to +call+ and takes a callback which accepts 3 arguments: (line, column, position)
+    # * +line+ - line number of caret
+    # * +column+ - column number of caret
+    # * +position+ - 0-based character position
+
+    # --
+    def caret_cb= callback
+      unless callback.arity == 3
+        raise ArgumentError, 'caret_cb callback must take 3 arguments: (line, column, position)'
+      end
+      cb = Proc.new do |ih, lin, col, pos|
+        callback.call lin, col, pos
+      end
+      define_callback cb, 'CARET_CB', :iii_i
+    end
+
+    ##
+    # :attr_writer: motion_cb
+    # Callback called when the mouse is moved.
+    # Callback must respond to +call+ and takes 3 arguments: (x, y, state)
+    # * +x+ - x position of mouse
+    # * +y+ - y position of mouse
+    # * +state+ -status of mouse buttons and certain keyboard keys at the moment the event was generated.
+
+    #--
+    def motion_cb= callback
+      unless callback.arity == 3
+        raise ArgumentError, 'motion_cb callback must take 3 arguments: (x, y, state)'
+      end
+      cb = Proc.new do |ih, x, y, state|
+        callback.call x, y, state
+      end
+      define_callback cb, 'MOTION_CB', :iis_i
+    end
+
+    ##
+    # :attr_writer: valuechanged_cb
+    # Called after the value was interactively changed by the user. Called when 
+    # the selection is changed or when the text is edited.
+    # Callback must respond to +call+ and takes no arguments.
+
+    # --
+    def valuechanged_cb= callback
+      unless callback.arity.zero?
+        raise ArgumentError, 'valuechanged_cb callback must take 0 arguments'
+      end
+      cb = Proc.new do |ih|
+        callback.call
+      end
+      define_callback cb, 'VALUECHANGED_CB', :plain
+    end
+  end
+end