wxPython/contrib/stc/_stc_docstrings.i

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        _stc_docstrings.i
   3 // Purpose:     Docstrings for the wxStyledTextCtrl.  The ones in this file
   4 //              are maintained by hand for those methods that are not
   5 //              auto-generated by gen_iface.py
   6 //
   7 // Author:      Robin Dunn
   8 //
   9 // Created:     16-April-2005
  10 // RCS-ID:      $Id$
  11 // Copyright:   (c) 2005 by Total Control Software
  12 // Licence:     wxWindows license
  13 /////////////////////////////////////////////////////////////////////////////
  14
  15
  16 // First include the autogenerated docstrings so if any of them need
  17 // tweaked they can be overridden below
  18 %include _stc_gendocs.i
  19
  20
  21 // TODO:  Class docstring
  22 DocStr(wxStyledTextCtrl,
  23 "", "");
  24
  25 // TODO:  Main constructor
  26 DocStr(wxStyledTextCtrl::wxStyledTextCtrl,
  27 "", "");
  28
  29 // TODO:  "Pre" constructor
  30 DocStr(wxStyledTextCtrl::wxStyledTextCtrl(),
  31 "", "");
  32
  33
  34
  35 DocStr(wxStyledTextCtrl::GetCurrentLine,
  36 "Returns the line number of the line with the caret.", "");
  37
  38 DocStr(wxStyledTextCtrl::StyleSetSpec,
  39 "Extract style settings from a spec-string which is composed of one or
  40 more of the following comma separated elements::
  41
  42      bold                    turns on bold
  43      italic                  turns on italics
  44      fore:[name or #RRGGBB]  sets the foreground colour
  45      back:[name or #RRGGBB]  sets the background colour
  46      face:[facename]         sets the font face name to use
  47      size:[num]              sets the font size in points
  48      eol                     turns on eol filling
  49      underline               turns on underlining
  50 ", "");
  51
  52 DocStr(wxStyledTextCtrl::StyleSetFont,
  53 "Set style size, face, bold, italic, and underline attributes from the
  54 attributes of a `wx.Font`.", "");
  55
  56 DocStr(wxStyledTextCtrl::StyleSetFontAttr,
  57 "Set all font style attributes at once.", "");
  58
  59 DocStr(wxStyledTextCtrl::CmdKeyExecute,
  60 "Perform one of the operations defined by the wx.stc.STC_CMD_* constants.", "");
  61
  62 DocStr(wxStyledTextCtrl::SetMargins,
  63 "Set the left and right margin in the edit area, measured in pixels.", "");
  64
  65 DocAStr(wxStyledTextCtrl::GetSelection,
  66 "GetSelection(self) -> (startPos, endPos)",
  67 "Retrieve the start and end positions of the current selection.", "");
  68
  69 DocStr(wxStyledTextCtrl::PointFromPosition,
  70 "Retrieve the point in the window where a position is displayed.", "");
  71
  72 DocStr(wxStyledTextCtrl::ScrollToLine,
  73 "Scroll enough to make the given line visible.", "");
  74
  75 DocStr(wxStyledTextCtrl::ScrollToColumn,
  76 "Scroll enough to make the given column visible", "");
  77
  78 DocStr(wxStyledTextCtrl::SendMsg,
  79 "Send a message to Scintilla.", "");
  80
  81 DocStr(wxStyledTextCtrl::SetVScrollBar,
  82 "Set the vertical scrollbar to use instead of the one that's built-in.", "");
  83
  84 DocStr(wxStyledTextCtrl::SetHScrollBar,
  85 "Set the horizontal scrollbar to use instead of the ont that's built-in.", "");
  86
  87 DocStr(wxStyledTextCtrl::SaveFile,
  88 "Write the contents of the editor to filename", "");
  89
  90 DocStr(wxStyledTextCtrl::LoadFile,
  91 "Load the contents of filename into the editor", "");
  92
  93 DocStr(wxStyledTextCtrl::DoDragOver,
  94 "Allow for simulating a DnD DragOver.", "");
  95
  96 DocStr(wxStyledTextCtrl::DoDropText,
  97 "Allow for simulating a DnD DropText.", "");
  98
  99 DocStr(wxStyledTextCtrl::SetUseAntiAliasing,
 100 "Specify whether anti-aliased fonts should be used.  Will have no
 101 effect on some platforms, but on some (wxMac for example) can greatly
 102 improve performance.", "");
 103
 104 DocStr(wxStyledTextCtrl::GetUseAntiAliasing,
 105 "Returns the current UseAntiAliasing setting.", "");
 106
 107
 108
 109 DocStr(wxStyledTextCtrl::AddTextRaw,
 110 "Add text to the document at current position.  The text should be
 111 utf-8 encoded on unicode builds of wxPython, or can be any 8-bit text
 112 in ansi builds.", "");
 113
 114 DocStr(wxStyledTextCtrl::InsertTextRaw,
 115 "Insert string at a position.  The text should be utf-8 encoded on
 116 unicode builds of wxPython, or can be any 8-bit text in ansi builds.", "");
 117
 118 DocAStr(wxStyledTextCtrl::GetCurLineRaw,
 119         "GetCurLineRaw() -> (text, index)",
 120 "Retrieve the text of the line containing the caret, and also the index
 121 of the caret on the line.  The returned value is a utf-8 encoded
 122 string in unicode builds of wxPython, or raw 8-bit text otherwise.", "");
 123
 124 DocStr(wxStyledTextCtrl::GetLineRaw,
 125 "Retrieve the contents of a line.  The returned value is a utf-8
 126 encoded string in unicode builds of wxPython, or raw 8-bit text
 127 otherwise.", "");
 128
 129 DocStr(wxStyledTextCtrl::GetSelectedTextRaw,
 130 "Retrieve the selected text.  The returned value is a utf-8 encoded
 131 string in unicode builds of wxPython, or raw 8-bit text otherwise.", "");
 132
 133 DocStr(wxStyledTextCtrl::GetTextRangeRaw,
 134 "Retrieve a range of text.    The returned value is a utf-8 encoded
 135 string in unicode builds of wxPython, or raw 8-bit text otherwise.", "");
 136
 137 DocStr(wxStyledTextCtrl::SetTextRaw,
 138 "Replace the contents of the document with the argument text.  The text
 139 should be utf-8 encoded on unicode builds of wxPython, or can be any
 140 8-bit text in ansi builds.", "");
 141
 142 DocStr(wxStyledTextCtrl::GetTextRaw,
 143 "Retrieve all the text in the document.  The returned value is a utf-8
 144 encoded string in unicode builds of wxPython, or raw 8-bit text
 145 otherwise.", "");
 146
 147 DocStr(wxStyledTextCtrl::AppendTextRaw,
 148 "Append a string to the end of the document without changing the
 149 selection.  The text should be utf-8 encoded on unicode builds of
 150 wxPython, or can be any 8-bit text in ansi builds.", "");
 151
 152
 153
 154
 155 // Overrides for some of the generated docstrings
 156
 157 DocAStr(wxStyledTextCtrl::GetCurLine,
 158         "GetCurLine(self) -> (text, pos)",
 159 "Retrieve the text of the line containing the caret, and also theindex
 160 of the caret on the line.", "");
 161