Platforms to show: All Mac Windows Linux Cross-Platform
NSLayoutManagerMBS.addTextContainer(container as NSTextContainerMBS)
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.4, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Appends the given text container to the series of text containers where the receiver arranges text.
Notes:
container: The text container to append.
Invalidates glyphs and layout as needed, but doesn't perform glyph generation or layout.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.4, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Appends the given text container to the series of text containers where the receiver arranges text.
Notes:
container: The text container to append.
Invalidates glyphs and layout as needed, but doesn't perform glyph generation or layout.
NSLayoutManagerMBS.allowsNonContiguousLayout as boolean
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Whether noncontiguous layout is enabled.
Notes:
Setting to true allows but does not require the layout manager to use noncontiguous layout, and the layout manager may in fact not do so, depending on its configuration.
(Read and Write computed property)
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Whether noncontiguous layout is enabled.
Notes:
Setting to true allows but does not require the layout manager to use noncontiguous layout, and the layout manager may in fact not do so, depending on its configuration.
(Read and Write computed property)
NSLayoutManagerMBS.attributedString as NSAttributedStringMBS
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the text storage object from which the NSGlyphGenerator object procures characters for glyph generation.
Notes:
This method is part of the NSGlyphStorage protocol, for use by the glyph generator. For NSLayoutManager the attributed string is equivalent to the text storage.
Available in Mac OS X v10.5 and later.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the text storage object from which the NSGlyphGenerator object procures characters for glyph generation.
Notes:
This method is part of the NSGlyphStorage protocol, for use by the glyph generator. For NSLayoutManager the attributed string is equivalent to the text storage.
Available in Mac OS X v10.5 and later.
NSLayoutManagerMBS.backgroundLayoutEnabled as boolean
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Whether the receiver generates glyphs and lays them out when the application's run loop is idle.
Notes:
If true, background layout is enabled; if false, the receiver performs glyph generation and layout only when necessary.
(Read and Write computed property)
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Whether the receiver generates glyphs and lays them out when the application's run loop is idle.
Notes:
If true, background layout is enabled; if false, the receiver performs glyph generation and layout only when necessary.
(Read and Write computed property)
NSLayoutManagerMBS.characterIndexForPoint(point as NSPointMBS, container as NSTextContainerMBS, byref partialFraction as double) as integer
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the index of the character falling under the given point, expressed in the given container's coordinate system.
Notes:
point: The point to test.
container: The text container within which the point is tested.
partialFraction: A fraction of the distance from the insertion point, logically before the given character to the next one.
Returns the index of the character falling under point.
Analogous to glyphIndexForPoint:inTextContainer, but expressed in character index terms. The method returns the index of the character falling under point, expressed in coordinate system of container; if no character is under the point, the nearest character is returned, where nearest is defined according to the requirements of selection by mouse. However, this is not simply equivalent to taking the result of the corresponding glyph index method and converting it to a character index, because in some cases a single glyph represents more than one selectable character, for example an fi ligature glyph. In that case, there is an insertion point within the glyph, and this method returns one character or the other, depending on whether the specified point lies to the left or the right of that insertion point.
In general, this method returns only character indexes for which there is an insertion point. The partialFraction is a fraction of the distance from the insertion point, logically before the given character to the next one, which may be either to the right or to the left depending on directionality.
Available in OS X v10.6 and later.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the index of the character falling under the given point, expressed in the given container's coordinate system.
Notes:
point: The point to test.
container: The text container within which the point is tested.
partialFraction: A fraction of the distance from the insertion point, logically before the given character to the next one.
Returns the index of the character falling under point.
Analogous to glyphIndexForPoint:inTextContainer, but expressed in character index terms. The method returns the index of the character falling under point, expressed in coordinate system of container; if no character is under the point, the nearest character is returned, where nearest is defined according to the requirements of selection by mouse. However, this is not simply equivalent to taking the result of the corresponding glyph index method and converting it to a character index, because in some cases a single glyph represents more than one selectable character, for example an fi ligature glyph. In that case, there is an insertion point within the glyph, and this method returns one character or the other, depending on whether the specified point lies to the left or the right of that insertion point.
In general, this method returns only character indexes for which there is an insertion point. The partialFraction is a fraction of the distance from the insertion point, logically before the given character to the next one, which may be either to the right or to the left depending on directionality.
Available in OS X v10.6 and later.
NSLayoutManagerMBS.Constructor
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Creates new NSLayoutManager object.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Creates new NSLayoutManager object.
NSLayoutManagerMBS.font as NSFontMBS
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.5, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: The font for the invisible character drawing.
Notes:
Use nil font for using the font of the current text.
This method is only available if the NSLayoutManagerMBS object has been created with new NSLayoutManagerMBS, so the plugin can use the special NSLayoutManager subclass with support for invisible character drawing.
(Read and Write computed property)
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.5, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: The font for the invisible character drawing.
Notes:
Use nil font for using the font of the current text.
This method is only available if the NSLayoutManagerMBS object has been created with new NSLayoutManagerMBS, so the plugin can use the special NSLayoutManager subclass with support for invisible character drawing.
(Read and Write computed property)
NSLayoutManagerMBS.glyphIndexForPoint(point as NSPointMBS, container as NSTextContainerMBS) as integer
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: This method is a primitive for glyphIndexForPoint. You should always call the main method, not the primitives.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: This method is a primitive for glyphIndexForPoint. You should always call the main method, not the primitives.
See also:
NSLayoutManagerMBS.glyphIndexForPoint(point as NSPointMBS, container as NSTextContainerMBS, byref partialFraction as double) as integer
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the index of the glyph falling under the given point, expressed in the given container's coordinate system.
Notes:
point: The point for which to return the glyph, in coordinates of container.
container: The container in which the returned glyph is laid out.
partialFraction: On output, the fraction of the distance between the location of the glyph returned and the location of the next glyph.
Returns the index of the glyph falling under the given point, expressed in the given container's coordinate system.
If no glyph is under point, the nearest glyph is returned, where nearest is defined according to the requirements of selection by mouse. Clients who wish to determine whether the the point actually lies within the bounds of the glyph returned should follow this with a call to boundingRectForGlyphRange and test whether the point falls in the rectangle returned by that method. If partialFraction is non-NULL, it returns by reference the fraction of the distance between the location of the glyph returned and the location of the next glyph.
For purposes such as dragging out a selection or placing the insertion point, a partial percentage less than or equal to 0.5 indicates that point should be considered as falling before the glyph index returned; a partial percentage greater than 0.5 indicates that it should be considered as falling after the glyph index returned. If the nearest glyph doesn’t lie under point at all (for example, if point is beyond the beginning or end of a line), this ratio is 0 or 1.
If the glyph stream contains the glyphs "A” and "b”, with the width of "A” being 13 points, and the user clicks at a location 8 points into "A”, partialFraction is 8/13, or 0.615. In this case, the point given should be considered as falling between "A” and "b” for purposes such as dragging out a selection or placing the insertion point.
Performs glyph generation and layout if needed.
As part of its implementation, this method calls fractionOfDistanceThroughGlyphForPoint and glyphIndexForPoint. To change this method’s behavior, override those two methods instead of this one.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the index of the glyph falling under the given point, expressed in the given container's coordinate system.
Notes:
point: The point for which to return the glyph, in coordinates of container.
container: The container in which the returned glyph is laid out.
partialFraction: On output, the fraction of the distance between the location of the glyph returned and the location of the next glyph.
Returns the index of the glyph falling under the given point, expressed in the given container's coordinate system.
If no glyph is under point, the nearest glyph is returned, where nearest is defined according to the requirements of selection by mouse. Clients who wish to determine whether the the point actually lies within the bounds of the glyph returned should follow this with a call to boundingRectForGlyphRange and test whether the point falls in the rectangle returned by that method. If partialFraction is non-NULL, it returns by reference the fraction of the distance between the location of the glyph returned and the location of the next glyph.
For purposes such as dragging out a selection or placing the insertion point, a partial percentage less than or equal to 0.5 indicates that point should be considered as falling before the glyph index returned; a partial percentage greater than 0.5 indicates that it should be considered as falling after the glyph index returned. If the nearest glyph doesn’t lie under point at all (for example, if point is beyond the beginning or end of a line), this ratio is 0 or 1.
If the glyph stream contains the glyphs "A” and "b”, with the width of "A” being 13 points, and the user clicks at a location 8 points into "A”, partialFraction is 8/13, or 0.615. In this case, the point given should be considered as falling between "A” and "b” for purposes such as dragging out a selection or placing the insertion point.
Performs glyph generation and layout if needed.
As part of its implementation, this method calls fractionOfDistanceThroughGlyphForPoint and glyphIndexForPoint. To change this method’s behavior, override those two methods instead of this one.
See also:
NSLayoutManagerMBS.glyphRangeForTextContainer(container as NSTextContainerMBS) as NSRangeMBS
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the range of glyphs laid out within the given text container.
Notes:
This is a less efficient method than the similar textContainerForGlyphAtIndex.
Performs glyph generation and layout if needed.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the range of glyphs laid out within the given text container.
Notes:
This is a less efficient method than the similar textContainerForGlyphAtIndex.
Performs glyph generation and layout if needed.
NSLayoutManagerMBS.hasNonContiguousLayout as boolean
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Whether the layout manager currently has any areas of noncontiguous layout.
Notes: There may be times at which there is no noncontiguous layout, such as when layout is complete; this method enables the layout manager to report that to clients.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Whether the layout manager currently has any areas of noncontiguous layout.
Notes: There may be times at which there is no noncontiguous layout, such as when layout is complete; this method enables the layout manager to report that to clients.
NSLayoutManagerMBS.hyphenationFactor as double
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: The threshold controlling when hyphenation is done.
Notes:
factor: The hyphenation factor, ranging from 0.0 to 1.0. By default, the value is 0.0, meaning hyphenation is off. A factor of 1.0 causes hyphenation to be attempted always.
Whenever (width of the real contents of the line) / (the line fragment width) is below factor, hyphenation is attempted when laying out the line. Hyphenation slows down text layout and increases memory usage, so it should be used sparingly.
May be overridden on a per-paragraph basis by the NSParagraphStyle method hyphenationFactor.
(Read and Write computed property)
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: The threshold controlling when hyphenation is done.
Notes:
factor: The hyphenation factor, ranging from 0.0 to 1.0. By default, the value is 0.0, meaning hyphenation is off. A factor of 1.0 causes hyphenation to be attempted always.
Whenever (width of the real contents of the line) / (the line fragment width) is below factor, hyphenation is attempted when laying out the line. Hyphenation slows down text layout and increases memory usage, so it should be used sparingly.
May be overridden on a per-paragraph basis by the NSParagraphStyle method hyphenationFactor.
(Read and Write computed property)
NSLayoutManagerMBS.InvisibleCharMapping(character as integer) as string
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.5, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Sets/gets character mapping for invisible character.
Example:
Notes:
By default characters are set for endofline, tab and spaces.
Set showInvisibleCharacters to true and put here all the characters you need.
(Read and Write computed property)
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.5, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Sets/gets character mapping for invisible character.
Example:
dim l as new NSLayoutManagerMBS
// ...
// set tab to map to plus sign
l.InvisibleCharMapping(9) = "+"
// set space to map to star sign
l.InvisibleCharMapping(asc(" ")) = "*"
By default characters are set for endofline, tab and spaces.
Set showInvisibleCharacters to true and put here all the characters you need.
(Read and Write computed property)
NSLayoutManagerMBS.lineFragmentRectForGlyphAtIndex(glyphIndex as integer, byref effectiveRange as NSRangeMBS) as NSRectMBS
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the rectangle for the line fragment in which the given glyph is laid out and (optionally), by reference, the whole range of glyphs that are in that fragment.
Notes:
glyphIndex: The glyph for which to return the line fragment rectangle.
effectiveGlyphRange: On output, the range for all glyphs in the line fragment.
Retuns the line fragment in which the given glyph is laid out.
This method causes glyph generation and layout for the line fragment containing the specified glyph, or if noncontiguous layout is not enabled, for all of the text up to and including that line fragment.
Line fragment rectangles are always in container coordinates.
Overriding this method is not recommended. If the the line fragment rectangle needs to be modified, that should be done at the typesetter level or by calling setLineFragmentRect:forGlyphRange.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the rectangle for the line fragment in which the given glyph is laid out and (optionally), by reference, the whole range of glyphs that are in that fragment.
Notes:
glyphIndex: The glyph for which to return the line fragment rectangle.
effectiveGlyphRange: On output, the range for all glyphs in the line fragment.
Retuns the line fragment in which the given glyph is laid out.
This method causes glyph generation and layout for the line fragment containing the specified glyph, or if noncontiguous layout is not enabled, for all of the text up to and including that line fragment.
Line fragment rectangles are always in container coordinates.
Overriding this method is not recommended. If the the line fragment rectangle needs to be modified, that should be done at the typesetter level or by calling setLineFragmentRect:forGlyphRange.
See also:
NSLayoutManagerMBS.lineFragmentRectForGlyphAtIndex(glyphIndex as integer, byref effectiveRange as NSRangeMBS, withoutAdditionalLayout as boolean) as NSRectMBS
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the line fragment rectangle containing the glyph at the given glyph index.
Notes:
glyphIndex: The glyph for which to return the line fragment rectangle.
effectiveGlyphRange: On output, the range for all glyphs in the line fragment.
withoutAdditionalLayout: If true, glyph generation and layout are not performed, so this option should not be used unless layout is known to be complete for the range in question, or unless noncontiguous layout is enabled; if false, both are performed as needed.
Returns the line fragment in which the given glyph is laid out.
This method is primarily for use from within NSTypesetter, after layout is complete for the range in question, but before the layout manager's call to NSTypesetter has returned. In that case glyph and layout holes have not yet been recalculated, so the layout manager does not yet know that layout is complete for that range, and this variant must be used.
Overriding this method is not recommended. If the the line fragment rectangle needs to be modified, that should be done at the typesetter level or by calling setLineFragmentRect.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the line fragment rectangle containing the glyph at the given glyph index.
Notes:
glyphIndex: The glyph for which to return the line fragment rectangle.
effectiveGlyphRange: On output, the range for all glyphs in the line fragment.
withoutAdditionalLayout: If true, glyph generation and layout are not performed, so this option should not be used unless layout is known to be complete for the range in question, or unless noncontiguous layout is enabled; if false, both are performed as needed.
Returns the line fragment in which the given glyph is laid out.
This method is primarily for use from within NSTypesetter, after layout is complete for the range in question, but before the layout manager's call to NSTypesetter has returned. In that case glyph and layout holes have not yet been recalculated, so the layout manager does not yet know that layout is complete for that range, and this variant must be used.
Overriding this method is not recommended. If the the line fragment rectangle needs to be modified, that should be done at the typesetter level or by calling setLineFragmentRect.
See also:
NSLayoutManagerMBS.lineFragmentUsedRectForGlyphAtIndex(glyphIndex as integer, byref effectiveRange as NSRangeMBS) as NSRectMBS
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the usage rectangle for the line fragment in which the given glyph is laid and (optionally) by reference the whole range of glyphs that are in that fragment.
Notes:
glyphIndex: The glyph for which to return the line fragment used rectangle.
effectiveGlyphRange: On output, the range for all glyphs in the line fragment.
Returns the used rectangle for the line fragment in which the given glyph is laid out.
This method causes glyph generation and layout for the line fragment containing the specified glyph, or if noncontiguous layout is not enabled, up to and including that line fragment.
Line fragment used rectangles are always in container coordinates.
Overriding this method is not recommended. If the the line fragment used rectangle needs to be modified, that should be done at the typesetter level or by calling setLineFragmentRect.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the usage rectangle for the line fragment in which the given glyph is laid and (optionally) by reference the whole range of glyphs that are in that fragment.
Notes:
glyphIndex: The glyph for which to return the line fragment used rectangle.
effectiveGlyphRange: On output, the range for all glyphs in the line fragment.
Returns the used rectangle for the line fragment in which the given glyph is laid out.
This method causes glyph generation and layout for the line fragment containing the specified glyph, or if noncontiguous layout is not enabled, up to and including that line fragment.
Line fragment used rectangles are always in container coordinates.
Overriding this method is not recommended. If the the line fragment used rectangle needs to be modified, that should be done at the typesetter level or by calling setLineFragmentRect.
See also:
NSLayoutManagerMBS.lineFragmentUsedRectForGlyphAtIndex(glyphIndex as integer, byref effectiveRange as NSRangeMBS, withoutAdditionalLayout as boolean) as NSRectMBS
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the usage rectangle for the line fragment in which the given glyph is laid and (optionally) by reference the whole range of glyphs that are in that fragment.
Notes:
glyphIndex: The glyph for which to return the line fragment used rectangle.
effectiveGlyphRange: On output, the range for all glyphs in the line fragment.
withoutAdditionalLayout: If true, glyph generation and layout are not performed, so this option should not be used unless layout is known to be complete for the range in question, or unless noncontiguous layout is enabled; if false, both are performed as needed.
Returns the used rectangle for the line fragment in which the given glyph is laid out.
This method causes glyph generation and layout for the line fragment containing the specified glyph, or if noncontiguous layout is not enabled, up to and including that line fragment.
Line fragment used rectangles are always in container coordinates.
Overriding this method is not recommended. If the the line fragment used rectangle needs to be modified, that should be done at the typesetter level or by calling setLineFragmentRect.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the usage rectangle for the line fragment in which the given glyph is laid and (optionally) by reference the whole range of glyphs that are in that fragment.
Notes:
glyphIndex: The glyph for which to return the line fragment used rectangle.
effectiveGlyphRange: On output, the range for all glyphs in the line fragment.
withoutAdditionalLayout: If true, glyph generation and layout are not performed, so this option should not be used unless layout is known to be complete for the range in question, or unless noncontiguous layout is enabled; if false, both are performed as needed.
Returns the used rectangle for the line fragment in which the given glyph is laid out.
This method causes glyph generation and layout for the line fragment containing the specified glyph, or if noncontiguous layout is not enabled, up to and including that line fragment.
Line fragment used rectangles are always in container coordinates.
Overriding this method is not recommended. If the the line fragment used rectangle needs to be modified, that should be done at the typesetter level or by calling setLineFragmentRect.
See also:
NSLayoutManagerMBS.locationForGlyphAtIndex(glyphIndex as integer) as NSPointMBS
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the location for the given glyph within its line fragment.
Notes:
glyphIndex: The glyph whose location is returned.
Returns the location of the given glyph.
If the given glyph does not have an explicit location set for it (for example, if it is part of (but not first in) a sequence of nominally spaced characters), the location is calculated by glyph advancements from the location of the most recent preceding glyph with a location set.
Glyph locations are relative to their line fragment rectangle's origin. The line fragment rectangle in turn is defined in the coordinate system of the text container where it resides.
This method causes glyph generation and layout for the line fragment containing the specified glyph, or if noncontiguous layout is not enabled, up to and including that line fragment.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the location for the given glyph within its line fragment.
Notes:
glyphIndex: The glyph whose location is returned.
Returns the location of the given glyph.
If the given glyph does not have an explicit location set for it (for example, if it is part of (but not first in) a sequence of nominally spaced characters), the location is calculated by glyph advancements from the location of the most recent preceding glyph with a location set.
Glyph locations are relative to their line fragment rectangle's origin. The line fragment rectangle in turn is defined in the coordinate system of the text container where it resides.
This method causes glyph generation and layout for the line fragment containing the specified glyph, or if noncontiguous layout is not enabled, up to and including that line fragment.
NSLayoutManagerMBS.rangeOfNominallySpacedGlyphsContainingIndex(glyphIndex as integer) as NSRangeMBS
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the range for the glyphs around the given glyph that can be displayed using only their advancements from the font, without pairwise kerning or other adjustments to spacing.
Notes:
glyphIndex: Index of the glyph to test.
Returns the range of nominally spaced glyphs.
The range returned begins with the first glyph, counting back from glyphIndex, that has a location set, and it continues up to, but does not include, the next glyph that has a location set.
Performs glyph generation and layout if needed.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns the range for the glyphs around the given glyph that can be displayed using only their advancements from the font, without pairwise kerning or other adjustments to spacing.
Notes:
glyphIndex: Index of the glyph to test.
Returns the range of nominally spaced glyphs.
The range returned begins with the first glyph, counting back from glyphIndex, that has a location set, and it continues up to, but does not include, the next glyph that has a location set.
Performs glyph generation and layout if needed.
NSLayoutManagerMBS.rectArrayForCharacterRange(charRange as NSRangeMBS, selCharRange as NSRangeMBS, container as NSTextContainerMBS, byref rectCount as integer) as NSRectMBS()
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns an array of rectangles and, by reference, the number of such rectangles, that define the region in the given container enclosing the given character range.
Notes:
charRange: The character range for which to return rectangles.
selCharRange: Selected characters within charRange, which can affect the size of the rectangles; it must be equal to or contain charRange. If the caller is interested in this more from an enclosing point of view rather than a selection point of view, pass {NSNotFound, 0} as the selected range.
container: The text container in which the text is laid out.
rectCount: The number of rectangles returned.
Returns the array of rectangles enclosing the given range.
These rectangles can be used to draw the text background or highlight for the given range of characters. If a selected range is given in selCharRange, the rectangles returned are correct for drawing the selection. Selection rectangles are generally more complicated than enclosing rectangles and supplying a selected range is the clue this method uses to determine whether to go to the trouble of doing this special work.
The number of rectangles returned isn’t necessarily the number of lines enclosing the specified range. Contiguous lines can share an enclosing rectangle, and lines broken into several fragments have a separate enclosing rectangle for each fragment.
These rectangles don’t necessarily enclose glyphs that draw outside their line fragment rectangles; use boundingRectForGlyphRange to determine the area that contains all drawing performed for a range of glyphs.
Performs glyph generation and layout if needed.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns an array of rectangles and, by reference, the number of such rectangles, that define the region in the given container enclosing the given character range.
Notes:
charRange: The character range for which to return rectangles.
selCharRange: Selected characters within charRange, which can affect the size of the rectangles; it must be equal to or contain charRange. If the caller is interested in this more from an enclosing point of view rather than a selection point of view, pass {NSNotFound, 0} as the selected range.
container: The text container in which the text is laid out.
rectCount: The number of rectangles returned.
Returns the array of rectangles enclosing the given range.
These rectangles can be used to draw the text background or highlight for the given range of characters. If a selected range is given in selCharRange, the rectangles returned are correct for drawing the selection. Selection rectangles are generally more complicated than enclosing rectangles and supplying a selected range is the clue this method uses to determine whether to go to the trouble of doing this special work.
The number of rectangles returned isn’t necessarily the number of lines enclosing the specified range. Contiguous lines can share an enclosing rectangle, and lines broken into several fragments have a separate enclosing rectangle for each fragment.
These rectangles don’t necessarily enclose glyphs that draw outside their line fragment rectangles; use boundingRectForGlyphRange to determine the area that contains all drawing performed for a range of glyphs.
Performs glyph generation and layout if needed.
NSLayoutManagerMBS.rectArrayForGlyphRange(glyphRange as NSRangeMBS, selGlyphRange as NSRangeMBS, container as NSTextContainerMBS, byref rectCount as integer) as NSRectMBS()
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns an array of rectangles and, by reference, the number of such rectangles, that define the region in the given container enclosing the given glyph range.
Notes:
glyphRange: The glyph range for which to return rectangles.
selGlyphRange: Selected glyphs within glyphRange, which can affect the size of the rectangles; it must be equal to or contain glyphRange. If the caller is interested in this more from an enclosing point of view rather than a selection point of view, pass {NSNotFound, 0} as the selected range.
container: The text container in which the text is laid out.
rectCount: The number of rectangles returned.
Returns the array of rectangles enclosing the given range.
These rectangles can be used to draw the text background or highlight for the given range of characters. If a selected range is given in selGlyphRange, the rectangles returned are correct for drawing the selection. Selection rectangles are generally more complicated than enclosing rectangles and supplying a selected range is the clue this method uses to determine whether to go to the trouble of doing this special work.
The number of rectangles returned isn’t necessarily the number of lines enclosing the specified range. Contiguous lines can share an enclosing rectangle, and lines broken into several fragments have a separate enclosing rectangle for each fragment.
The purpose of this method is to calculate line rectangles for drawing the text background and highlighting. These rectangles don’t necessarily enclose glyphs that draw outside their line fragment rectangles; use boundingRectForGlyphRange to determine the area that contains all drawing performed for a range of glyphs.
Performs glyph generation and layout if needed.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 13.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Returns an array of rectangles and, by reference, the number of such rectangles, that define the region in the given container enclosing the given glyph range.
Notes:
glyphRange: The glyph range for which to return rectangles.
selGlyphRange: Selected glyphs within glyphRange, which can affect the size of the rectangles; it must be equal to or contain glyphRange. If the caller is interested in this more from an enclosing point of view rather than a selection point of view, pass {NSNotFound, 0} as the selected range.
container: The text container in which the text is laid out.
rectCount: The number of rectangles returned.
Returns the array of rectangles enclosing the given range.
These rectangles can be used to draw the text background or highlight for the given range of characters. If a selected range is given in selGlyphRange, the rectangles returned are correct for drawing the selection. Selection rectangles are generally more complicated than enclosing rectangles and supplying a selected range is the clue this method uses to determine whether to go to the trouble of doing this special work.
The number of rectangles returned isn’t necessarily the number of lines enclosing the specified range. Contiguous lines can share an enclosing rectangle, and lines broken into several fragments have a separate enclosing rectangle for each fragment.
The purpose of this method is to calculate line rectangles for drawing the text background and highlighting. These rectangles don’t necessarily enclose glyphs that draw outside their line fragment rectangles; use boundingRectForGlyphRange to determine the area that contains all drawing performed for a range of glyphs.
Performs glyph generation and layout if needed.
NSLayoutManagerMBS.removeTextContainerAtIndex(index as integer)
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.4, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Removes the text container at the given index and invalidates the layout as needed.
Notes:
index: The index of the text container to remove.
This method invalidates glyph information as needed.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.4, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Removes the text container at the given index and invalidates the layout as needed.
Notes:
index: The index of the text container to remove.
This method invalidates glyph information as needed.
NSLayoutManagerMBS.replaceGlyphAtIndex(glyphIndex as integer, newGlyph as integer)
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.4, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Replaces the glyph at the given index with a new glyph.
Notes:
glyphIndex: Index of the glyph to replace.
newGlyph: The new glyph.
Doesn't alter the glyph-to-character mapping or invalidate layout information. The character index of the glyph is assumed to remain the same (although it can, of course, be set explicitly if needed).
This method is for use by the glyph-generation mechanism and doesn't perform any invalidation or generation of the glyphs or layout. This method should be invoked only during glyph generation and typesetting, in almost all cases only by the glyph generator or typesetter. For example, a custom glyph generator or typesetter might invoke it.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.4, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Replaces the glyph at the given index with a new glyph.
Notes:
glyphIndex: Index of the glyph to replace.
newGlyph: The new glyph.
Doesn't alter the glyph-to-character mapping or invalidate layout information. The character index of the glyph is assumed to remain the same (although it can, of course, be set explicitly if needed).
This method is for use by the glyph-generation mechanism and doesn't perform any invalidation or generation of the glyphs or layout. This method should be invoked only during glyph generation and typesetting, in almost all cases only by the glyph generator or typesetter. For example, a custom glyph generator or typesetter might invoke it.
NSLayoutManagerMBS.replaceTextStorage(newTextStorage as NSTextStorageMBS)
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Replaces the NSTextStorage object for the group of text-system objects containing the receiver with the given text storage object.
Notes: All NSLayoutManager objects sharing the original NSTextStorage object then share the new one. This method makes all the adjustments necessary to keep these relationships intact, unlike setting textStorage property.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Replaces the NSTextStorage object for the group of text-system objects containing the receiver with the given text storage object.
Notes: All NSLayoutManager objects sharing the original NSTextStorage object then share the new one. This method makes all the adjustments necessary to keep these relationships intact, unlike setting textStorage property.
NSLayoutManagerMBS.setCharacterIndex(charIndex as integer, glyphIndex as integer)
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.4, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Sets the index of the character corresponding to the glyph at the given glyph index.
Notes:
charIndex: The index to set.
glyphIndex: The glyph corresponding to the character whose index is set. The glyph must already be present.
This method is for use by the glyph-generation mechanism and doesn't perform any invalidation or generation of the glyphs or layout. This method should be invoked only during glyph generation and typesetting, in almost all cases only by the glyph generator or typesetter. For example, a custom glyph generator or typesetter might invoke it.
method, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.4, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Sets the index of the character corresponding to the glyph at the given glyph index.
Notes:
charIndex: The index to set.
glyphIndex: The glyph corresponding to the character whose index is set. The glyph must already be present.
This method is for use by the glyph-generation mechanism and doesn't perform any invalidation or generation of the glyphs or layout. This method should be invoked only during glyph generation and typesetting, in almost all cases only by the glyph generator or typesetter. For example, a custom glyph generator or typesetter might invoke it.
NSLayoutManagerMBS.showInvisibleCharacters as boolean
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.4, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Whether to show invisible characters.
Notes:
This method is only available if the NSLayoutManagerMBS object has been created with new NSLayoutManagerMBS, so the plugin can use the special NSLayoutManager subclass with support for invisible character drawing.
(Read and Write computed property)
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.4, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Whether to show invisible characters.
Notes:
This method is only available if the NSLayoutManagerMBS object has been created with new NSLayoutManagerMBS, so the plugin can use the special NSLayoutManager subclass with support for invisible character drawing.
(Read and Write computed property)
NSLayoutManagerMBS.showsControlCharacters as boolean
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Whether to substitute visible glyphs for control characters in layout.
Example:
Notes:
If true, the receiver substitutes visible glyphs for control characters if the font and script support it; if false, it doesn't. The default is false.
(Read and Write computed property)
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Whether to substitute visible glyphs for control characters in layout.
Example:
if TargetCocoa then
dim t as NSTextViewMBS = TextArea1.NSTextViewMBS
dim l as NSLayoutManagerMBS = t.layoutManager
l.showsControlCharacters = true
else
// not supported
break
end if
If true, the receiver substitutes visible glyphs for control characters if the font and script support it; if false, it doesn't. The default is false.
(Read and Write computed property)
NSLayoutManagerMBS.showsInvisibleCharacters as boolean
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Whether to substitute visible glyphs for whitespace and other typically invisible characters in layout.
Example:
Notes:
If true, the receiver substitutes visible glyphs for invisible characters if the font and script support it; if false, it doesn't. The default is false.
(Read and Write computed property)
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Whether to substitute visible glyphs for whitespace and other typically invisible characters in layout.
Example:
if TargetCocoa then
dim t as NSTextViewMBS = TextArea1.NSTextViewMBS
dim l as NSLayoutManagerMBS = t.layoutManager
l.showsInvisibleCharacters = true
else
// not supported
break
end if
If true, the receiver substitutes visible glyphs for invisible characters if the font and script support it; if false, it doesn't. The default is false.
(Read and Write computed property)
NSLayoutManagerMBS.textColor as NSColorMBS
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.4, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: The text color for drawing invisible characters.
Notes:
This method is only available if the NSLayoutManagerMBS object has been created with new NSLayoutManagerMBS, so the plugin can use the special NSLayoutManager subclass with support for invisible character drawing.
(Read and Write computed property)
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.4, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: The text color for drawing invisible characters.
Notes:
This method is only available if the NSLayoutManagerMBS object has been created with new NSLayoutManagerMBS, so the plugin can use the special NSLayoutManager subclass with support for invisible character drawing.
(Read and Write computed property)
NSLayoutManagerMBS.textStorage as NSTextStorageMBS
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: The text storage.
Notes: (Read and Write computed property)
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: The text storage.
Notes: (Read and Write computed property)
NSLayoutManagerMBS.usesScreenFonts as boolean
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Whether screen fonts to calculate layout and display text.
Notes:
If true, the receiver uses screen fonts; if false, it doesn't.
(Read and Write computed property)
property, Cocoa, MBS Real Studio Cocoa Plugin (NSText), class NSLayoutManagerMBS,
Plugin version: 12.1, Mac: Yes, Win: No, Linux: No, Console & Web: Yes, Feedback.
Function: Whether screen fonts to calculate layout and display text.
Notes:
If true, the receiver uses screen fonts; if false, it doesn't.
(Read and Write computed property)
The items on this page are in the following plugins: MBS Real Studio Cocoa Plugin.
Links
MBS Xojo Chart Plugins