1 | <HTML> |
---|
2 | <HEAD> |
---|
3 | <TITLE>Fl_Text_Buffer</TITLE> |
---|
4 | </HEAD> |
---|
5 | <BODY> |
---|
6 | |
---|
7 | <!-- NEW PAGE --> |
---|
8 | |
---|
9 | <H2><A name="Fl_Text_Buffer">class Fl_Text_Buffer</A></H2> |
---|
10 | |
---|
11 | <HR> |
---|
12 | |
---|
13 | <H3>Class Hierarchy</H3> |
---|
14 | |
---|
15 | <UL><PRE> |
---|
16 | <B>Fl_Text_Buffer</B> |
---|
17 | </PRE></UL> |
---|
18 | |
---|
19 | <H3>Include Files</H3> |
---|
20 | |
---|
21 | <UL><PRE> |
---|
22 | #include <FL/Fl_Text_Buffer.H> |
---|
23 | </PRE></UL> |
---|
24 | |
---|
25 | <H3>Description</H3> |
---|
26 | |
---|
27 | <P>The <TT>Fl_Text_Buffer</TT> class is used by the |
---|
28 | <tt><A href="Fl_Text_Display.html">Fl_Text_Display</A></tt> |
---|
29 | and |
---|
30 | <tt><A href="Fl_Text_Editor.html">Fl_Text_Editor</A></tt> |
---|
31 | to manage complex text data and is based upon the |
---|
32 | excellent NEdit text editor engine - see |
---|
33 | <A HREF="http://www.nedit.org/">http://www.nedit.org/</A>.</P> |
---|
34 | |
---|
35 | <H3>Methods</H3> |
---|
36 | |
---|
37 | <TABLE CELLPADDING="10"> |
---|
38 | <TR VALIGN="TOP"><TD><UL> |
---|
39 | |
---|
40 | <LI><A HREF="#Fl_Text_Buffer.Fl_Text_Buffer">Fl_Text_Buffer</A></LI> |
---|
41 | <LI><A HREF="#Fl_Text_Buffer.~Fl_Text_Buffer">~Fl_Text_Buffer</A></LI> |
---|
42 | <LI><A HREF="#Fl_Text_Buffer.add_modify_callback">add_modify_callback</A></LI> |
---|
43 | <LI><A HREF="#Fl_Text_Buffer.append">append</A></LI> |
---|
44 | <LI><A HREF="#Fl_Text_Buffer.appendfile">appendfile</A></LI> |
---|
45 | <LI><A HREF="#Fl_Text_Buffer.call_modify_callbacks">call_modify_callbacks</A></LI> |
---|
46 | <LI><A HREF="#Fl_Text_Buffer.character">character</A></LI> |
---|
47 | <LI><A HREF="#Fl_Text_Buffer.character_width">character_width</A></LI> |
---|
48 | <LI><A HREF="#Fl_Text_Buffer.clear_rectangular">clear_rectangular</A></LI> |
---|
49 | <LI><A HREF="#Fl_Text_Buffer.copy">copy</A></LI> |
---|
50 | <LI><A HREF="#Fl_Text_Buffer.count_displayed_characters">count_displayed_characters</A></LI> |
---|
51 | <LI><A HREF="#Fl_Text_Buffer.count_lines">count_lines</A></LI> |
---|
52 | <LI><A HREF="#Fl_Text_Buffer.expand_character">expand_character</A></LI> |
---|
53 | <LI><A HREF="#Fl_Text_Buffer.findchar_backward">findchar_backward</A></LI> |
---|
54 | <LI><A HREF="#Fl_Text_Buffer.findchar_forward">findchar_forward</A></LI> |
---|
55 | <LI><A HREF="#Fl_Text_Buffer.findchars_backward">findchars_backward</A></LI> |
---|
56 | <LI><A HREF="#Fl_Text_Buffer.findchars_forward">findchars_forward</A></LI> |
---|
57 | <LI><A HREF="#Fl_Text_Buffer.highlight">highlight</A></LI> |
---|
58 | <LI><A HREF="#Fl_Text_Buffer.highlight_position">highlight_position</A></LI> |
---|
59 | <LI><A HREF="#Fl_Text_Buffer.highlight_rectangular">highlight_rectangular</A></LI> |
---|
60 | <LI><A HREF="#Fl_Text_Buffer.highlight_selection">highlight_selection</A></LI> |
---|
61 | <LI><A HREF="#Fl_Text_Buffer.highlight_text">highlight_text</A></LI> |
---|
62 | <LI><A HREF="#Fl_Text_Buffer.insert_column">insert_column</A></LI> |
---|
63 | <LI><A HREF="#Fl_Text_Buffer.insertfile">insertfile</A></LI> |
---|
64 | |
---|
65 | </UL></TD><TD><UL> |
---|
66 | |
---|
67 | <LI><A HREF="#Fl_Text_Buffer.insert">insert</A></LI> |
---|
68 | <LI><A HREF="#Fl_Text_Buffer.length">length</A></LI> |
---|
69 | <LI><A HREF="#Fl_Text_Buffer.line_end">line_end</A></LI> |
---|
70 | <LI><A HREF="#Fl_Text_Buffer.line_start">line_start</A></LI> |
---|
71 | <LI><A HREF="#Fl_Text_Buffer.line_text">line_text</A></LI> |
---|
72 | <LI><A HREF="#Fl_Text_Buffer.loadfile">loadfile</A></LI> |
---|
73 | <LI><A HREF="#Fl_Text_Buffer.null_substitution_character">null_substitution_character</A></LI> |
---|
74 | <LI><A HREF="#Fl_Text_Buffer.outputfile">outputfile</A></LI> |
---|
75 | <LI><A HREF="#Fl_Text_Buffer.overlay_rectangular">overlay_rectangular</A></LI> |
---|
76 | <LI><A HREF="#Fl_Text_Buffer.primary_selection">primary_selection</A></LI> |
---|
77 | <LI><A HREF="#Fl_Text_Buffer.remove_modify_callback">remove_modify_callback</A></LI> |
---|
78 | <LI><A HREF="#Fl_Text_Buffer.remove_rectangular">remove_rectangular</A></LI> |
---|
79 | <LI><A HREF="#Fl_Text_Buffer.remove">remove</A></LI> |
---|
80 | <LI><A HREF="#Fl_Text_Buffer.remove_secondary_selection">remove_secondary_selection</A></LI> |
---|
81 | <LI><A HREF="#Fl_Text_Buffer.remove_selection">remove_selection</A></LI> |
---|
82 | <LI><A HREF="#Fl_Text_Buffer.replace_rectangular">replace_rectangular</A></LI> |
---|
83 | <LI><A HREF="#Fl_Text_Buffer.replace">replace</A></LI> |
---|
84 | <LI><A HREF="#Fl_Text_Buffer.replace_secondary_selection">replace_secondary_selection</A></LI> |
---|
85 | <LI><A HREF="#Fl_Text_Buffer.replace_selection">replace_selection</A></LI> |
---|
86 | <LI><A HREF="#Fl_Text_Buffer.rewind_lines">rewind_lines</A></LI> |
---|
87 | <LI><A HREF="#Fl_Text_Buffer.savefile">savefile</A></LI> |
---|
88 | <LI><A HREF="#Fl_Text_Buffer.search_backward">search_backward</A></LI> |
---|
89 | <LI><A HREF="#Fl_Text_Buffer.search_forward">search_forward</A></LI> |
---|
90 | |
---|
91 | </UL></TD><TD><UL> |
---|
92 | |
---|
93 | <LI><A HREF="#Fl_Text_Buffer.secondary_selection_position">secondary_selection_position</A></LI> |
---|
94 | <LI><A HREF="#Fl_Text_Buffer.secondary_selection">secondary_selection</A></LI> |
---|
95 | <LI><A HREF="#Fl_Text_Buffer.secondary_selection_text">secondary_selection_text</A></LI> |
---|
96 | <LI><A HREF="#Fl_Text_Buffer.secondary_select_rectangular">secondary_select_rectangular</A></LI> |
---|
97 | <LI><A HREF="#Fl_Text_Buffer.secondary_select">secondary_select</A></LI> |
---|
98 | <LI><A HREF="#Fl_Text_Buffer.secondary_unselect">secondary_unselect</A></LI> |
---|
99 | <LI><A HREF="#Fl_Text_Buffer.selected">selected</A></LI> |
---|
100 | <LI><A HREF="#Fl_Text_Buffer.selection_position">selection_position</A></LI> |
---|
101 | <LI><A HREF="#Fl_Text_Buffer.selection_text">selection_text</A></LI> |
---|
102 | <LI><A HREF="#Fl_Text_Buffer.select_rectangular">select_rectangular</A></LI> |
---|
103 | <LI><A HREF="#Fl_Text_Buffer.select">select</A></LI> |
---|
104 | <LI><A HREF="#Fl_Text_Buffer.skip_displayed_characters">skip_displayed_characters</A></LI> |
---|
105 | <LI><A HREF="#Fl_Text_Buffer.skip_lines">skip_lines</A></LI> |
---|
106 | <LI><A HREF="#Fl_Text_Buffer.substitute_null_characters">substitute_null_characters</A></LI> |
---|
107 | <LI><A HREF="#Fl_Text_Buffer.tab_distance">tab_distance</A></LI> |
---|
108 | <LI><A HREF="#Fl_Text_Buffer.text_in_rectangle">text_in_rectangle</A></LI> |
---|
109 | <LI><A HREF="#Fl_Text_Buffer.text_range">text_range</A></LI> |
---|
110 | <LI><A HREF="#Fl_Text_Buffer.text">text</A></LI> |
---|
111 | <LI><A HREF="#Fl_Text_Buffer.unhighlight">unhighlight</A></LI> |
---|
112 | <LI><A HREF="#Fl_Text_Buffer.unselect">unselect</A></LI> |
---|
113 | <LI><A HREF="#Fl_Text_Buffer.unsubstitute_null_characters">unsubstitute_null_characters</A></LI> |
---|
114 | <LI><A HREF="#Fl_Text_Buffer.word_end">word_end</A></LI> |
---|
115 | <LI><A HREF="#Fl_Text_Buffer.word_start">word_start</A></LI> |
---|
116 | |
---|
117 | </UL></TD></TR> |
---|
118 | </TABLE> |
---|
119 | |
---|
120 | <H4><A NAME="Fl_Text_Buffer.Fl_Text_Buffer">Fl_Text_Buffer(int requestedSize = 0);</A></H4> |
---|
121 | |
---|
122 | <P>Creates a new text buffer of the specified initial size. |
---|
123 | |
---|
124 | <H4><A NAME="Fl_Text_Buffer.~Fl_Text_Buffer">~Fl_Text_Buffer();</A></H4> |
---|
125 | |
---|
126 | <P>Destroys a text buffer. |
---|
127 | |
---|
128 | <H4><A NAME="Fl_Text_Buffer.add_modify_callback">void add_modify_callback(Fl_Text_Modify_Cb bufModifiedCB, void* cbArg);</A></H4> |
---|
129 | |
---|
130 | <P>Adds a callback function that is called whenever the text buffer is |
---|
131 | modified. The callback function is declared as follows: |
---|
132 | |
---|
133 | <UL><PRE> |
---|
134 | typedef void (*Fl_Text_Modify_Cb)(int pos, int nInserted, int nDeleted, |
---|
135 | int nRestyled, const char* deletedText, |
---|
136 | void* cbArg); |
---|
137 | </PRE></UL> |
---|
138 | |
---|
139 | <H4><A NAME="Fl_Text_Buffer.append">void append(const char* text);</A></H4> |
---|
140 | |
---|
141 | <P>Appends the text string to the end of the buffer. |
---|
142 | |
---|
143 | <H4><A NAME="Fl_Text_Buffer.appendfile">int appendfile(const char *file, int buflen = 128*1024);</A></H4> |
---|
144 | |
---|
145 | <P>Appends the named file to the end of the buffer. Returns 0 on |
---|
146 | success, non-zero on error (strerror() contains reason). 1 indicates |
---|
147 | open for read failed (no data loaded). 2 indicates error occurred |
---|
148 | while reading data (data was partially loaded). |
---|
149 | |
---|
150 | <H4><A NAME="Fl_Text_Buffer.call_modify_callbacks">void call_modify_callbacks();</A></H4> |
---|
151 | |
---|
152 | <P>Calls all modify callbacks that have been registered using |
---|
153 | the <A |
---|
154 | HREF="#Fl_Text_Buffer.add_modify_callback"><TT>add_modify_callback()</TT></A> |
---|
155 | method. |
---|
156 | |
---|
157 | <H4><A NAME="Fl_Text_Buffer.character">char character(int pos);</A></H4> |
---|
158 | |
---|
159 | <P>Returns the character at the specified position in the buffer. |
---|
160 | |
---|
161 | <H4><A NAME="Fl_Text_Buffer.character_width">static int character_width(char c, int indent, int tabDist, char nullSubsChar);</A></H4> |
---|
162 | |
---|
163 | <P>Returns the column width of the specified character. The |
---|
164 | <TT>indent</TT> argument specifies the current column position, |
---|
165 | and <TT>tabDist</TT> specifies the number of columns to use for |
---|
166 | each tab. |
---|
167 | |
---|
168 | <P>The <TT>nullSubsChar</TT> argument specifies the current |
---|
169 | <TT>nul</TT> character. |
---|
170 | |
---|
171 | <H4><A NAME="Fl_Text_Buffer.clear_rectangular">void clear_rectangular(int start, int end, int rectStart, int rectEnd);</A></H4> |
---|
172 | |
---|
173 | <P>Clears text in the specified area. |
---|
174 | |
---|
175 | <H4><A NAME="Fl_Text_Buffer.copy">void copy(Fl_Text_Buffer* fromBuf, int fromStart, int fromEnd, int toPos);</A></H4> |
---|
176 | |
---|
177 | <P>Copies text from one buffer to this one; <TT>fromBuf</TT> may |
---|
178 | be the same as <TT>this</TT>. |
---|
179 | |
---|
180 | <H4><A NAME="Fl_Text_Buffer.count_displayed_characters">int count_displayed_characters(int lineStartPos, int targetPos);</A></H4> |
---|
181 | |
---|
182 | <P>Determines the number of characters that will be displayed |
---|
183 | between <TT>lineStartPos</TT> and <TT>targetPos</TT>. |
---|
184 | |
---|
185 | <H4><A NAME="Fl_Text_Buffer.count_lines">int count_lines(int startPos, int endPos);</A></H4> |
---|
186 | |
---|
187 | <P>Determines the number of lines between <TT>startPos</TT> and |
---|
188 | <TT>endPos</TT>. |
---|
189 | |
---|
190 | <H4><A NAME="Fl_Text_Buffer.expand_character">int expand_character(int pos, int indent, char *outStr);<BR> |
---|
191 | static int expand_character(char c, int indent, char* outStr, int tabDist, |
---|
192 | char nullSubsChar);</A></H4> |
---|
193 | |
---|
194 | <P>Expands the given character to a displayable format. Tabs and |
---|
195 | other control characters are given special treatment. |
---|
196 | |
---|
197 | <H4><A NAME="Fl_Text_Buffer.findchar_backward">int findchar_backward(int startPos, char searchChar, int* foundPos);</A></H4> |
---|
198 | |
---|
199 | <P>Finds the previous occurrence of the specified character. |
---|
200 | |
---|
201 | <H4><A NAME="Fl_Text_Buffer.findchar_forward">int findchar_forward(int startPos, char searchChar, int* foundPos);</A></H4> |
---|
202 | |
---|
203 | <P>Finds the next occurrence of the specified character. |
---|
204 | |
---|
205 | <H4><A NAME="Fl_Text_Buffer.findchars_backward">int findchars_backward(int startPos, const char* searchChars, int* foundPos);</A></H4> |
---|
206 | |
---|
207 | <P>Finds the previous occurrence of the specified characters. |
---|
208 | |
---|
209 | <H4><A NAME="Fl_Text_Buffer.findchars_forward">int findchars_forward(int startPos, const char* searchChars, int* foundPos);</A></H4> |
---|
210 | |
---|
211 | <P>Finds the next occurrence of the specified characters. |
---|
212 | Search forwards in buffer for characters in <i>searchChars</i>, starting |
---|
213 | with the character <i>startPos</i>, and returning the result in <i>foundPos</i> |
---|
214 | returns 1 if found, 0 if not. |
---|
215 | |
---|
216 | <H4><A NAME="Fl_Text_Buffer.highlight">void highlight(int start, int end);</A></H4> |
---|
217 | |
---|
218 | <P>Highlights the specified text within the buffer. |
---|
219 | |
---|
220 | <H4><A NAME="Fl_Text_Buffer.highlight_position">int highlight_position(int* start, int* end, int* isRect, int* rectStart, |
---|
221 | int* rectEnd);</A></H4> |
---|
222 | |
---|
223 | <P>Returns the current highlight positions. |
---|
224 | |
---|
225 | <H4><A NAME="Fl_Text_Buffer.highlight_rectangular">void highlight_rectangular(int start, int end, int rectStart, int rectEnd);</A></H4> |
---|
226 | |
---|
227 | <P>Highlights the specified rectangle of text within the buffer. |
---|
228 | |
---|
229 | <H4><A NAME="Fl_Text_Buffer.highlight_selection">Fl_Text_Selection* highlight_selection();</A></H4> |
---|
230 | |
---|
231 | <P>Returns the current highlight selection. |
---|
232 | |
---|
233 | <H4><A NAME="Fl_Text_Buffer.highlight_text">const char* highlight_text();</A></H4> |
---|
234 | |
---|
235 | <P>Returns the highlighted text. When you are done with the |
---|
236 | text, free it using the <tt>free()</tt> function. |
---|
237 | |
---|
238 | <H4><A NAME="Fl_Text_Buffer.insert_column">void insert_column(int column, int startPos, const char* text, |
---|
239 | int* charsInserted, int* charsDeleted);</A></H4> |
---|
240 | |
---|
241 | <P>Inserts a column of text without calling the modify callbacks. |
---|
242 | |
---|
243 | <H4><A NAME="Fl_Text_Buffer.insertfile">int insertfile(const char *file, int pos, int buflen = 128*1024);</A></H4> |
---|
244 | |
---|
245 | <P>Inserts a file at the specified position. Returns 0 on success, |
---|
246 | non-zero on error (strerror() contains reason). 1 indicates open |
---|
247 | for read failed (no data loaded). 2 indicates error occurred |
---|
248 | while reading data (data was partially loaded). |
---|
249 | |
---|
250 | <H4><A NAME="Fl_Text_Buffer.insert">void insert(int pos, const char* text);</A></H4> |
---|
251 | |
---|
252 | <P>Inserts text at the specified position. |
---|
253 | |
---|
254 | <H4><A NAME="Fl_Text_Buffer.length">int length();</A></H4> |
---|
255 | |
---|
256 | <P>Returns the number of characters in the buffer. |
---|
257 | |
---|
258 | <H4><A NAME="Fl_Text_Buffer.line_end">int line_end(int pos);</A></H4> |
---|
259 | |
---|
260 | <P>Returns the end position of the line. |
---|
261 | |
---|
262 | <H4><A NAME="Fl_Text_Buffer.line_start">int line_start(int pos);</A></H4> |
---|
263 | |
---|
264 | <P>Returns the start position of the line. |
---|
265 | |
---|
266 | <H4><A NAME="Fl_Text_Buffer.line_text">const char* line_text(int pos);</A></H4> |
---|
267 | |
---|
268 | <P>Returns the text for the line containing the specified |
---|
269 | character position. When you are done with the text, free it |
---|
270 | using the <tt>free()</tt> function. |
---|
271 | |
---|
272 | <H4><A NAME="Fl_Text_Buffer.loadfile">int loadfile(const char *file, int buflen = 128*1024);</A></H4> |
---|
273 | |
---|
274 | <P>Replaces the current buffer with the contents of a file. Returns 0 |
---|
275 | on success, non-zero on error (strerror() contains reason). 1 indicates |
---|
276 | open for read failed (no data loaded). 2 indicates error occurred |
---|
277 | while reading data (data was partially loaded). |
---|
278 | |
---|
279 | <H4><A NAME="Fl_Text_Buffer.null_substitution_character">char null_substitution_character();</A></H4> |
---|
280 | |
---|
281 | <P>Returns the current <TT>nul</TT> substitution character. |
---|
282 | |
---|
283 | <H4><A NAME="Fl_Text_Buffer.outputfile">int outputfile(const char *file, int start, int end, int buflen = 128*1024);</A></H4> |
---|
284 | |
---|
285 | <P>Writes the specified portions of the file to a file. Returns 0 on success, non-zero |
---|
286 | on error (strerror() contains reason). 1 indicates open for write failed |
---|
287 | (no data saved). 2 indicates error occurred while writing data |
---|
288 | (data was partially saved). |
---|
289 | |
---|
290 | <H4><A NAME="Fl_Text_Buffer.overlay_rectangular">void overlay_rectangular(int startPos, int rectStart, int rectEnd, |
---|
291 | const char* text, int* charsInserted, int* charsDeleted);</A></H4> |
---|
292 | |
---|
293 | <P>Replaces a rectangular region of text with the given text. |
---|
294 | |
---|
295 | <H4><A NAME="Fl_Text_Buffer.primary_selection">Fl_Text_Selection* primary_selection();</A></H4> |
---|
296 | |
---|
297 | <P>Returns the primary selection. |
---|
298 | |
---|
299 | <H4><A NAME="Fl_Text_Buffer.remove_modify_callback">void remove_modify_callback(Fl_Text_Modify_Cb bufModifiedCB, void* cbArg);</A></H4> |
---|
300 | |
---|
301 | <P>Removes a modify callback. |
---|
302 | |
---|
303 | <H4><A NAME="Fl_Text_Buffer.remove_rectangular">void remove_rectangular(int start, int end, int rectStart, int rectEnd);</A></H4> |
---|
304 | |
---|
305 | <P>Deletes a rectangular area of text in the buffer. |
---|
306 | |
---|
307 | <H4><A NAME="Fl_Text_Buffer.remove">void remove(int start, int end);</A></H4> |
---|
308 | |
---|
309 | <P>Deletes a range of characters in the buffer. |
---|
310 | |
---|
311 | <H4><A NAME="Fl_Text_Buffer.remove_secondary_selection">void remove_secondary_selection();</A></H4> |
---|
312 | |
---|
313 | <P>Removes the text in the secondary selection. |
---|
314 | |
---|
315 | <H4><A NAME="Fl_Text_Buffer.remove_selection">void remove_selection();</A></H4> |
---|
316 | |
---|
317 | <P>Removes the text in the primary selection. |
---|
318 | |
---|
319 | <H4><A NAME="Fl_Text_Buffer.replace_rectangular">void replace_rectangular(int start, int end, int rectStart, int rectEnd, |
---|
320 | const char* text);</A></H4> |
---|
321 | |
---|
322 | <P>Replaces the text in a rectangular area. |
---|
323 | |
---|
324 | <H4><A NAME="Fl_Text_Buffer.replace">void replace(int start, int end, const char *text);</A></H4> |
---|
325 | |
---|
326 | <P>Replaces the text in the specified range of characters in the buffer. |
---|
327 | |
---|
328 | <H4><A NAME="Fl_Text_Buffer.replace_secondary_selection">void replace_secondary_selection(const char* text);</A></H4> |
---|
329 | |
---|
330 | <P>Replaces the text in the secondary selection. |
---|
331 | |
---|
332 | <H4><A NAME="Fl_Text_Buffer.replace_selection">void replace_selection(const char* text);</A></H4> |
---|
333 | |
---|
334 | <P>Replaces the text in the primary selection. |
---|
335 | |
---|
336 | <H4><A NAME="Fl_Text_Buffer.rewind_lines">int rewind_lines(int startPos, int nLines);</A></H4> |
---|
337 | |
---|
338 | <P>Returns the buffer position for the Nth previous line. |
---|
339 | |
---|
340 | <H4><A NAME="Fl_Text_Buffer.savefile">int savefile(const char *file, int buflen = 128*1024);</A></H4> |
---|
341 | |
---|
342 | <P>Saves the entire buffer to a file. Returns 0 on success, non-zero |
---|
343 | on error (strerror() contains reason). 1 indicates open for write failed |
---|
344 | (no data saved). 2 indicates error occurred while writing data |
---|
345 | (data was partially saved). |
---|
346 | |
---|
347 | <H4><A NAME="Fl_Text_Buffer.search_backward">int search_backward(int startPos, const char* searchString, int* foundPos, |
---|
348 | int matchCase = 0);</A></H4> |
---|
349 | |
---|
350 | <P>Searches backwards for the specified string. |
---|
351 | |
---|
352 | <H4><A NAME="Fl_Text_Buffer.search_forward">int search_forward(int startPos, const char* searchString, int* foundPos, |
---|
353 | int matchCase = 0);</A></H4> |
---|
354 | |
---|
355 | <P>Searches forwards for the specified string. |
---|
356 | |
---|
357 | <H4><A NAME="Fl_Text_Buffer.secondary_selection_position">int secondary_selection_position(int* start, int* end, int* isRect, |
---|
358 | int* rectStart, int* rectEnd);</A></H4> |
---|
359 | |
---|
360 | <H4><A NAME="Fl_Text_Buffer.secondary_selection">Fl_Text_Selection* secondary_selection();</A></H4> |
---|
361 | |
---|
362 | <P>Returns the secondary selection. |
---|
363 | |
---|
364 | <H4><A NAME="Fl_Text_Buffer.secondary_selection_text">const char* secondary_selection_text();</A></H4> |
---|
365 | |
---|
366 | <P>Returns the text in the secondary selection. When you are |
---|
367 | done with the text, free it using the <tt>free()</tt> function. |
---|
368 | |
---|
369 | <H4><A NAME="Fl_Text_Buffer.secondary_select_rectangular">void secondary_select_rectangular(int start, int end, int rectStart, |
---|
370 | int rectEnd);</A></H4> |
---|
371 | |
---|
372 | <P>Selects a rectangle of characters in the secondary selection. |
---|
373 | |
---|
374 | <H4><A NAME="Fl_Text_Buffer.secondary_select">void secondary_select(int start, int end);</A></H4> |
---|
375 | |
---|
376 | <P>Selects a range of characters in the secondary selection. |
---|
377 | |
---|
378 | <H4><A NAME="Fl_Text_Buffer.secondary_unselect">void secondary_unselect();</A></H4> |
---|
379 | |
---|
380 | <P>Turns the secondary selection off. |
---|
381 | |
---|
382 | <H4><A NAME="Fl_Text_Buffer.selected">int selected();</A></H4> |
---|
383 | |
---|
384 | <P>Returns a non-zero number if any text has been selected, or 0 |
---|
385 | if no text is selected. |
---|
386 | |
---|
387 | <H4><A NAME="Fl_Text_Buffer.selection_position">int selection_position(int* start, int* end);<BR> |
---|
388 | int selection_position(int* start, int* end, int* isRect, int* rectStart, int* rectEnd);</A></H4> |
---|
389 | |
---|
390 | <P>Returns the current selection. |
---|
391 | |
---|
392 | <H4><A NAME="Fl_Text_Buffer.selection_text">const char* selection_text();</A></H4> |
---|
393 | |
---|
394 | <P>Returns the currently selected text. When you are done with |
---|
395 | the text, free it using the <tt>free()</tt> function. |
---|
396 | |
---|
397 | <H4><A NAME="Fl_Text_Buffer.select_rectangular">void select_rectangular(int start, int end, int rectStart, int rectEnd);</A></H4> |
---|
398 | |
---|
399 | <P>Selects a rectangle of characters in the buffer. |
---|
400 | |
---|
401 | <H4><A NAME="Fl_Text_Buffer.select">void select(int start, int end);</A></H4> |
---|
402 | |
---|
403 | <P>Selects a range of characters in the buffer. |
---|
404 | |
---|
405 | <H4><A NAME="Fl_Text_Buffer.skip_displayed_characters">int skip_displayed_characters(int lineStartPos, int nChars);</A></H4> |
---|
406 | |
---|
407 | <P>Skips forward the indicated number of characters in the |
---|
408 | buffer from the start position. |
---|
409 | |
---|
410 | <H4><A NAME="Fl_Text_Buffer.skip_lines">int skip_lines(int startPos, int nLines);</A></H4> |
---|
411 | |
---|
412 | <P>Returns the buffer position for the Nth line after the start |
---|
413 | position. |
---|
414 | |
---|
415 | <H4><A NAME="Fl_Text_Buffer.substitute_null_characters">int substitute_null_characters(char* string, int length);</A></H4> |
---|
416 | |
---|
417 | <P>Replaces <TT>nul</TT> characters in the given string with the |
---|
418 | <TT>nul</TT> substitution character. |
---|
419 | |
---|
420 | <H4><A NAME="Fl_Text_Buffer.tab_distance">int tab_distance();<BR> |
---|
421 | void tab_distance(int tabDist);</A></H4> |
---|
422 | |
---|
423 | <P>Gets or sets the tab width. |
---|
424 | |
---|
425 | <H4><A NAME="Fl_Text_Buffer.text_in_rectangle">const char* text_in_rectangle(int start, int end, int rectStart, int rectEnd);</A></H4> |
---|
426 | |
---|
427 | <P>Returns the text from the given rectangle. When you are done |
---|
428 | with the text, free it using the <tt>free()</tt> function. |
---|
429 | |
---|
430 | <H4><A NAME="Fl_Text_Buffer.text_range">const char* text_range(int start, int end);</A></H4> |
---|
431 | |
---|
432 | <P>Returns the text from the range of characters. When you are |
---|
433 | done with the text, free it using the <tt>free()</tt> function. |
---|
434 | |
---|
435 | <H4><A NAME="Fl_Text_Buffer.text">const char* text();<BR> |
---|
436 | void text(const char* text);</A></H4> |
---|
437 | |
---|
438 | <P>Gets or sets the text in the buffer. The first form |
---|
439 | returns a copy of the text in the buffer which you must |
---|
440 | later <tt>free()</tt> when done using it. The second form sets the text in |
---|
441 | the buffer, making an internal copy of the string that is automatically managed. |
---|
442 | |
---|
443 | <H4><A NAME="Fl_Text_Buffer.unhighlight">void unhighlight();</A></H4> |
---|
444 | |
---|
445 | <P>Unhighlights text in the buffer. |
---|
446 | |
---|
447 | <H4><A NAME="Fl_Text_Buffer.unselect">void unselect();</A></H4> |
---|
448 | |
---|
449 | <P>Unselects text in the buffer. |
---|
450 | |
---|
451 | <H4><A NAME="Fl_Text_Buffer.unsubstitute_null_characters">void unsubstitute_null_characters(char* string);</A></H4> |
---|
452 | |
---|
453 | <P>Replaces the <TT>nul</TT> substitution characters in the |
---|
454 | provided string with the <TT>nul</TT> character. |
---|
455 | |
---|
456 | <H4><A NAME="Fl_Text_Buffer.word_end">int word_end(int pos);</A></H4> |
---|
457 | |
---|
458 | <P>Returns the position for the end of the word. |
---|
459 | |
---|
460 | <H4><A NAME="Fl_Text_Buffer.word_start">int word_start(int pos);</A></H4> |
---|
461 | |
---|
462 | <P>Returns the position for the start of the word. |
---|
463 | |
---|
464 | </BODY> |
---|
465 | </HTML> |
---|