Returns the styles for the given text range.
<p>
Returns an empty array if a LineStyleListener has been set.
Should not be called if a LineStyleListener has been set since the
listener maintains the styles.
</p><p>
Note: When <code>includeRanges</code> is true, the start and length
fields of each StyleRange will be valid, however the StyleRange
objects may need to be cloned. When <code>includeRanges</code> is
false, <code>getRanges(int, int)</code> can be used to get the
associated ranges.
</p>
@param start the start offset of the style ranges to return
@param length the number of style ranges to return
@param includeRanges whether the start and length field of the StyleRanges should be set.
@return the styles or an empty array if a LineStyleListener has
been set. The returned styles will reflect the given range. The first
returned <code>StyleRange</code> will have a starting offset >= start
and the last returned <code>StyleRange</code> will have an ending
offset <= start + length - 1
@exception SWTException <ul>
<li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
<li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
</ul>
@exception IllegalArgumentException <ul>
<li>ERROR_INVALID_RANGE when start and/or end are outside the widget content</li>
</ul>
Returns the styles for the given text range. <p> Returns an empty array if a LineStyleListener has been set. Should not be called if a LineStyleListener has been set since the listener maintains the styles. </p><p> Note: When <code>includeRanges</code> is true, the start and length fields of each StyleRange will be valid, however the StyleRange objects may need to be cloned. When <code>includeRanges</code> is false, <code>getRanges(int, int)</code> can be used to get the associated ranges. </p>
@param start the start offset of the style ranges to return @param length the number of style ranges to return @param includeRanges whether the start and length field of the StyleRanges should be set.
@return the styles or an empty array if a LineStyleListener has been set. The returned styles will reflect the given range. The first returned <code>StyleRange</code> will have a starting offset >= start and the last returned <code>StyleRange</code> will have an ending offset <= start + length - 1
@exception SWTException <ul> <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> </ul> @exception IllegalArgumentException <ul> <li>ERROR_INVALID_RANGE when start and/or end are outside the widget content</li> </ul>
@since 3.2
@see #getRanges(int, int) @see #setStyleRanges(int[], StyleRange[])