NSMutableAttributedStringMBS.addAttribute(name as string, value as Variant, range as NSRangeMBS)

// create Hello World in red
dim a as NSAttributedStringMBS = NSAttributedStringMBS.attributedStringWithString("Hello World")
dim m as NSMutableAttributedStringMBS = a.mutableCopy

m.addAttribute(a.NSForegroundColorAttributeName, NSColorMBS.redColor, new NSRangeMBS(0, m.length))

// put it in a textarea
TextArea1.NSTextViewMBS.textStorage.setAttributedString m

name: A string specifying the attribute name. Attribute keys can be supplied by another framework or can be custom ones you define. For information about where to find the system-supplied attribute keys, see the overview section in NSAttributedString Class Reference.
value: The attribute value associated with name.
Range: The range of characters to which the specified attribute/value pair applies.

You may assign any name/value pair you wish to a range of characters, in addition to the standard attributes described in the "Constants" section of NSAttributedString Additions. Raises an NSInvalidArgumentException if name or value is nil and an NSRangeException if any part of range lies beyond the end of the receiver's characters.

Plugin version 16.0 or newer ignores calls here with value = nil or empty name to avoid exceptions.

Some examples using this method:

• /MacCG/CoreText/CoreText Dynamic Text Height
• /MacCG/CoreText/CoreText Test
• /MacCocoa/Font PopupMenu in Cocoa
• /MacCocoa/Print RTF via NSGraphics
• /MacCocoa/Text List
• /MacControls/HUDPopupMenu
• /MacControls/Label with Color
• /MacControls/PopupMenu in Cocoa
• /MacControls/TextArea with Link

NSMutableAttributedStringMBS.addAttributes(attrs as Dictionary, range as NSRangeMBS)

TextArea1.Text = "Hello"

Dim tv As NSTextViewMBS = TextArea1.NSTextViewMBS
Dim ts As NSTextStorageMBS = tv.TextStorage

Dim value As Color = &cFF0000

Dim offset As Integer = 0
Dim length As Integer = 5

Dim range As NSRangeMBS = NSMakeRangeMBS( offset, length )
ts.AddAttribute( NSAttributedStringMBS.NSForegroundColorAttributeName, value, range )

attributes: A dictionary containing the attributes to add. Attribute keys can be supplied by another framework or can be custom ones you define. For information about where to find the system-supplied attribute keys, see the overview section in NSAttributedString Class Reference.
Range: The range of characters to which the specified attributes apply.

You may assign any name/value pair you wish to a range of characters, in addition to the standard attributes described in the "Constants" section of NSAttributedString Additions. Raises an NSInvalidArgumentException if attributes is nil and an NSRangeException if any part of range lies beyond the end of the receiver's characters.

NSMutableAttributedStringMBS.appendAttributedString(attrString as NSAttributedStringMBS)

const NSWritingDirectionNatural       = -1   // Determines direction using the Unicode Bidi Algorithm rules P2 and P3
const NSWritingDirectionLeftToRight   = 0    // Left to right writing direction
const NSWritingDirectionRightToLeft   = 1    // Right to left writing direction

const NSTextWritingDirectionEmbedding = 0
const NSTextWritingDirectionOverride = 2

dim t as NSTextStorageMBS = TextArea1.NSTextViewMBS.textStorage

// get hello in arabic
dim a as NSAttributedStringMBS = NSAttributedStringMBS.attributedStringWithString("مرحبا")
dim m as NSMutableAttributedStringMBS = a.mutableCopy

// now set attributes for right to left
m.addAttribute t.NSWritingDirectionAttributeName, array(NSWritingDirectionRightToLeft+NSTextWritingDirectionOverride), new NSRangeMBS(0,m.Length)

// and add to textarea
t.appendAttributedString m

attributedString: The string whose characters and attributes are added.

Some examples using this method:

• /MacCocoa/Text List

NSMutableAttributedStringMBS.appendString(attrString as String)

NSMutableAttributedStringMBS.applyFontTraits(FontTraitMask as Integer, offset as Integer, length as Integer)

See the NSFontManager class specification for a description of the font traits available. Raises an NSRangeException if any part of aRange lies beyond the end of the receiver’s characters.

NSMutableAttributedStringMBS.AsCFMutableAttributedString as Variant

// make NS version
dim n as new NSAttributedStringMBS

if n.initWithString("Hello World") then
  
  dim m as NSMutableAttributedStringMBS = n.mutableCopy
  
  // convert
  dim c as CFMutableAttributedStringMBS = m.AsCFMutableAttributedString
  
  // and check content
  MsgBox c.String
end if

For passing to functions which need a CFMutableAttributedStringMBS.

NSMutableAttributedStringMBS.beginEditing

You can nest pairs of beginEditing and endEditing messages.

NSMutableAttributedStringMBS.Constructor

NSMutableAttributedStringMBS.containsAttachmentsInRange(offset as Integer, length as Integer) as Boolean

NSMutableAttributedStringMBS.deleteCharactersInRange(range as NSRangeMBS)

Raises an NSRangeException if any part of aRange lies beyond the end of the receiver's characters.

NSMutableAttributedStringMBS.endEditing

The NSMutableAttributedString implementation does nothing. NSTextStorage, for example, overrides this method to invoke fixAttributesInRange and to inform its NSLayoutManager objects that they need to re-lay the text.

NSMutableAttributedStringMBS.fixAttachmentAttributeInRange(offset as Integer, length as Integer)

Raises an NSRangeException if any part of aRange lies beyond the end of the receiver’s characters.

NSMutableAttributedStringMBS.fixAttributesInRange(offset as Integer, length as Integer)

Raises an NSRangeException if any part of aRange lies beyond the end of the receiver’s characters.

NSTextStorage subclasses that return YES from the fixesAttributesLazily method should avoid directly calling fixAttributesInRange: or else bracket such calls with beginEditing and endEditing messages.

NSMutableAttributedStringMBS.fixFontAttributeInRange(offset as Integer, length as Integer)

For example, Kanji characters assigned a Latin font are reassigned an appropriate Kanji font. Raises an NSRangeException if any part of aRange lies beyond the end of the receiver’s characters.

NSMutableAttributedStringMBS.fixParagraphStyleAttributeInRange(offset as Integer, length as Integer)

This method extends the range as needed to cover the last paragraph partially contained. A paragraph is delimited by any of these characters, the longest possible sequence being preferred to any shorter:

• U+000D (\r or CR)
• U+000A (\n or LF)
• U+2029 (Unicode paragraph separator) \r\n, in that order (also known as CRLF)

NSMutableAttributedStringMBS.fontAttributesInRange(offset as Integer, length as Integer) as Dictionary

NSMutableAttributedStringMBS.insertAttributedString(attrString as NSAttributedStringMBS, location as UInt64)

attributedString: The string whose characters and attributes are inserted.
index: The index at which the characters and attributes are inserted.

The new characters and attributes begin at the given index and the existing characters and attributes from the index to the end of the receiver are shifted by the length of the attributed string. Raises an NSRangeException if index lies beyond the end of the receiver's characters.

NSMutableAttributedStringMBS.insertString(attrString as String, location as UInt64)

NSMutableAttributedStringMBS.removeAttribute(name as string, range as NSRangeMBS)

name: A string specifying the attribute name to remove. Attribute keys can be supplied by another framework or can be custom ones you define. For information about where to find the system-supplied attribute keys, see the overview section in NSAttributedString Class Reference.
Range: The range of characters from which the specified attribute is removed.

Raises an NSRangeException if any part of range lies beyond the end of the receiver's characters.

NSMutableAttributedStringMBS.replaceCharacters(search as String, text as String, Options as Integer = 1)

// make some mutable string
Dim s As New NSMutableAttributedStringMBS
s.setString "Hello World!"

// now do the replace
s.replaceCharacters("world", "everyone")

// and show result
MessageBox s.Text

Default options is for case insensitive search, but you can pass other options.
(see search flags in PDFDocumentMBS class)

NSMutableAttributedStringMBS.replaceCharactersInRange(range as NSRangeMBS, attrString as NSAttributedStringMBS)

Range: The range of characters and attributes replaced.
attributedString: The attributed string whose characters and attributes replace those in the specified range.

Raises an NSRangeException if any part of range lies beyond the end of the receiver's characters.

See also:

• replaceCharactersInRange(range as NSRangeMBS, text as string)

NSMutableAttributedStringMBS.replaceCharactersInRange(range as NSRangeMBS, text as string)

Range: A range specifying the characters to replace.
text: A string specifying the characters to replace those in range.

The new characters inherit the attributes of the first replaced character from range. Where the length of range is 0, the new characters inherit the attributes of the character preceding range if it has any, otherwise of the character following range.

Raises an NSRangeException if any part of range lies beyond the end of the receiver's characters.

See also:

• replaceCharactersInRange(range as NSRangeMBS, attrString as NSAttributedStringMBS)

NSMutableAttributedStringMBS.rulerAttributesInRange(offset as Integer, length as Integer) as Dictionary

NSMutableAttributedStringMBS.setAlignment(alignment as Integer, offset as Integer, length as Integer)

When attribute fixing takes place, this change will affect only paragraphs whose first character was included in aRange. Raises an NSRangeException if any part of a range lies beyond the end of the receiver’s characters.

NSMutableAttributedStringMBS.setAttributedString(attrString as NSAttributedStringMBS)

// create Hello World in red
dim a as NSAttributedStringMBS = NSAttributedStringMBS.attributedStringWithString("Hello World")
dim m as NSMutableAttributedStringMBS = a.mutableCopy

m.addAttribute(a.NSForegroundColorAttributeName, NSColorMBS.redColor, new NSRangeMBS(0, m.length))

// put it in a textarea
TextArea1.NSTextViewMBS.textStorage.setAttributedString m

attributedString: The attributed string whose characters and attributes replace those in the receiver.

NSMutableAttributedStringMBS.setAttributes(attrs as Dictionary, range as NSRangeMBS)

attributes: A dictionary containing the attributes to set. Attribute keys can be supplied by another framework or can be custom ones you define. For information about where to find the system-supplied attribute keys, see the overview section in NSAttributedString Class Reference.
Range: The range of characters whose attributes are set.

These new attributes replace any attributes previously associated with the characters in range. Raises an NSRangeException if any part of range lies beyond the end of the receiver's characters.

To set attributes for a zero-length NSMutableAttributedString displayed in a text view, use the NSTextView method setTypingAttributes.

NSMutableAttributedStringMBS.setBaseWritingDirection(writingDirection as Integer, offset as Integer, length as Integer)

NSMutableAttributedStringMBS.setString(attrString as String)

NSMutableAttributedStringMBS.subscriptRange(offset as Integer, length as Integer)

TextArea1.Text = "Hello World"

dim n as NSTextViewMBS = TextArea1.NSTextViewMBS
dim s as NSTextStorageMBS = n.textStorage

s.subscriptRange(6,5)

NSMutableAttributedStringMBS.superscriptRange(offset as Integer, length as Integer)

NSMutableAttributedStringMBS.unscriptRange(offset as Integer, length as Integer)

NSMutableAttributedStringMBS.updateAttachmentsFromPath(file as folderitem)

See also:

• updateAttachmentsFromPath(path as string)

NSMutableAttributedStringMBS.updateAttachmentsFromPath(path as string)

See also:

• updateAttachmentsFromPath(file as folderitem)