Mercurial > projects > dwt-addons
comparison dwtx/jface/text/ILineTracker.d @ 139:93a6ec48fd28
Regexp throws removal in interfaces
author | Frank Benoit <benoit@tionex.de> |
---|---|
date | Sun, 24 Aug 2008 02:31:41 +0200 |
parents | c4fb132a086c |
children |
comparison
equal
deleted
inserted
replaced
138:b6bad70d540a | 139:93a6ec48fd28 |
---|---|
194 * | 194 * |
195 * @param line the line whose line delimiter is queried | 195 * @param line the line whose line delimiter is queried |
196 * @return the line's delimiter or <code>null</code> if line does not have a delimiter | 196 * @return the line's delimiter or <code>null</code> if line does not have a delimiter |
197 * @exception BadLocationException if the line number is invalid in this tracker's line structure | 197 * @exception BadLocationException if the line number is invalid in this tracker's line structure |
198 */ | 198 */ |
199 String getLineDelimiter(int line) throws BadLocationException; | 199 String getLineDelimiter(int line) ; |
200 | 200 |
201 /** | 201 /** |
202 * Computes the number of lines in the given text. | 202 * Computes the number of lines in the given text. |
203 * | 203 * |
204 * @param text the text whose number of lines should be computed | 204 * @param text the text whose number of lines should be computed |
219 * @param offset the offset of the specified text range | 219 * @param offset the offset of the specified text range |
220 * @param length the length of the specified text range | 220 * @param length the length of the specified text range |
221 * @return the number of lines occupied by the specified range | 221 * @return the number of lines occupied by the specified range |
222 * @exception BadLocationException if specified range is unknown to this tracker | 222 * @exception BadLocationException if specified range is unknown to this tracker |
223 */ | 223 */ |
224 int getNumberOfLines(int offset, int length) throws BadLocationException; | 224 int getNumberOfLines(int offset, int length) ; |
225 | 225 |
226 /** | 226 /** |
227 * Returns the position of the first character of the specified line. | 227 * Returns the position of the first character of the specified line. |
228 * | 228 * |
229 * @param line the line of interest | 229 * @param line the line of interest |
230 * @return offset of the first character of the line | 230 * @return offset of the first character of the line |
231 * @exception BadLocationException if the line is unknown to this tracker | 231 * @exception BadLocationException if the line is unknown to this tracker |
232 */ | 232 */ |
233 int getLineOffset(int line) throws BadLocationException; | 233 int getLineOffset(int line) ; |
234 | 234 |
235 /** | 235 /** |
236 * Returns length of the specified line including the line's delimiter. | 236 * Returns length of the specified line including the line's delimiter. |
237 * | 237 * |
238 * @param line the line of interest | 238 * @param line the line of interest |
239 * @return the length of the line | 239 * @return the length of the line |
240 * @exception BadLocationException if line is unknown to this tracker | 240 * @exception BadLocationException if line is unknown to this tracker |
241 */ | 241 */ |
242 int getLineLength(int line) throws BadLocationException; | 242 int getLineLength(int line) ; |
243 | 243 |
244 /** | 244 /** |
245 * Returns the line number the character at the given offset belongs to. | 245 * Returns the line number the character at the given offset belongs to. |
246 * | 246 * |
247 * @param offset the offset whose line number to be determined | 247 * @param offset the offset whose line number to be determined |
248 * @return the number of the line the offset is on | 248 * @return the number of the line the offset is on |
249 * @exception BadLocationException if the offset is invalid in this tracker | 249 * @exception BadLocationException if the offset is invalid in this tracker |
250 */ | 250 */ |
251 int getLineNumberOfOffset(int offset) throws BadLocationException; | 251 int getLineNumberOfOffset(int offset) ; |
252 | 252 |
253 /** | 253 /** |
254 * Returns a line description of the line at the given offset. | 254 * Returns a line description of the line at the given offset. |
255 * The description contains the start offset and the length of the line | 255 * The description contains the start offset and the length of the line |
256 * excluding the line's delimiter. | 256 * excluding the line's delimiter. |
257 * | 257 * |
258 * @param offset the offset whose line should be described | 258 * @param offset the offset whose line should be described |
259 * @return a region describing the line | 259 * @return a region describing the line |
260 * @exception BadLocationException if offset is invalid in this tracker | 260 * @exception BadLocationException if offset is invalid in this tracker |
261 */ | 261 */ |
262 IRegion getLineInformationOfOffset(int offset) throws BadLocationException; | 262 IRegion getLineInformationOfOffset(int offset) ; |
263 | 263 |
264 /** | 264 /** |
265 * Returns a line description of the given line. The description | 265 * Returns a line description of the given line. The description |
266 * contains the start offset and the length of the line excluding the line's | 266 * contains the start offset and the length of the line excluding the line's |
267 * delimiter. | 267 * delimiter. |
268 * | 268 * |
269 * @param line the line that should be described | 269 * @param line the line that should be described |
270 * @return a region describing the line | 270 * @return a region describing the line |
271 * @exception BadLocationException if line is unknown to this tracker | 271 * @exception BadLocationException if line is unknown to this tracker |
272 */ | 272 */ |
273 IRegion getLineInformation(int line) throws BadLocationException; | 273 IRegion getLineInformation(int line) ; |
274 | 274 |
275 /** | 275 /** |
276 * Informs the line tracker about the specified change in the tracked text. | 276 * Informs the line tracker about the specified change in the tracked text. |
277 * | 277 * |
278 * @param offset the offset of the replaced text | 278 * @param offset the offset of the replaced text |
279 * @param length the length of the replaced text | 279 * @param length the length of the replaced text |
280 * @param text the substitution text | 280 * @param text the substitution text |
281 * @exception BadLocationException if specified range is unknown to this tracker | 281 * @exception BadLocationException if specified range is unknown to this tracker |
282 */ | 282 */ |
283 void replace(int offset, int length, String text) throws BadLocationException; | 283 void replace(int offset, int length, String text) ; |
284 | 284 |
285 /** | 285 /** |
286 * Sets the tracked text to the specified text. | 286 * Sets the tracked text to the specified text. |
287 * | 287 * |
288 * @param text the new tracked text | 288 * @param text the new tracked text |