A model.

Hierarchy

  • ITextModel

Index

Events

onDidChangeContent

onDidChangeDecorations

  • onDidChangeDecorations(listener: function): IDisposable

onDidChangeLanguage

onDidChangeLanguageConfiguration

  • onDidChangeLanguageConfiguration(listener: function): IDisposable

onDidChangeOptions

onWillDispose

  • An event emitted right before disposing the model.

    Parameters

    • listener: function
        • (): void
        • Returns void

    Returns IDisposable

Properties

id

id: string

A unique identifier associated with this model.

uri

uri: Uri

Gets the resource associated with this editor model.

Methods

applyEdits

  • applyEdits(operations: IIdentifiedSingleEditOperation[]): IIdentifiedSingleEditOperation[]
  • Edit the model without adding the edits to the undo stack. This can have dire consequences on the undo stack! See @pushEditOperations for the preferred way.

    Parameters

    • operations: IIdentifiedSingleEditOperation[]

      The edit operations.

    Returns IIdentifiedSingleEditOperation[]

    The inverse edit operations, that, when applied, will bring the model back to the previous state.

deltaDecorations

  • deltaDecorations(oldDecorations: string[], newDecorations: IModelDeltaDecoration[], ownerId?: number): string[]
  • Perform a minimum ammount of operations, in order to transform the decorations identified by oldDecorations to the decorations described by newDecorations and returns the new identifiers associated with the resulting decorations.

    Parameters

    • oldDecorations: string[]

      Array containing previous decorations identifiers.

    • newDecorations: IModelDeltaDecoration[]

      Array describing what decorations should result after the call.

    • Optional ownerId: number

      Identifies the editor id in which these decorations should appear. If no ownerId is provided, the decorations will appear in all editors that attach this model.

    Returns string[]

    An array containing the new decorations identifiers.

detectIndentation

  • detectIndentation(defaultInsertSpaces: boolean, defaultTabSize: number): void
  • Detect the indentation options for this model from its content.

    Parameters

    • defaultInsertSpaces: boolean
    • defaultTabSize: number

    Returns void

dispose

  • dispose(): void
  • Destroy this model. This will unbind the model from the mode and make all necessary clean-up to release this object to the GC.

    Returns void

findMatches

  • findMatches(searchString: string, searchOnlyEditableRange: boolean, isRegex: boolean, matchCase: boolean, wordSeparators: string | null, captureMatches: boolean, limitResultCount?: number): FindMatch[]
  • findMatches(searchString: string, searchScope: IRange, isRegex: boolean, matchCase: boolean, wordSeparators: string | null, captureMatches: boolean, limitResultCount?: number): FindMatch[]
  • Search the model.

    Parameters

    • searchString: string

      The string used to search. If it is a regular expression, set isRegex to true.

    • searchOnlyEditableRange: boolean

      Limit the searching to only search inside the editable range of the model.

    • isRegex: boolean

      Used to indicate that searchString is a regular expression.

    • matchCase: boolean

      Force the matching to match lower/upper case exactly.

    • wordSeparators: string | null

      Force the matching to match entire words only. Pass null otherwise.

    • captureMatches: boolean

      The result will contain the captured groups.

    • Optional limitResultCount: number

      Limit the number of results

    Returns FindMatch[]

    The ranges where the matches are. It is empty if not matches have been found.

  • Search the model.

    Parameters

    • searchString: string

      The string used to search. If it is a regular expression, set isRegex to true.

    • searchScope: IRange

      Limit the searching to only search inside this range.

    • isRegex: boolean

      Used to indicate that searchString is a regular expression.

    • matchCase: boolean

      Force the matching to match lower/upper case exactly.

    • wordSeparators: string | null

      Force the matching to match entire words only. Pass null otherwise.

    • captureMatches: boolean

      The result will contain the captured groups.

    • Optional limitResultCount: number

      Limit the number of results

    Returns FindMatch[]

    The ranges where the matches are. It is empty if no matches have been found.

findNextMatch

  • findNextMatch(searchString: string, searchStart: IPosition, isRegex: boolean, matchCase: boolean, wordSeparators: string | null, captureMatches: boolean): FindMatch
  • Search the model for the next match. Loops to the beginning of the model if needed.

    Parameters

    • searchString: string

      The string used to search. If it is a regular expression, set isRegex to true.

    • searchStart: IPosition

      Start the searching at the specified position.

    • isRegex: boolean

      Used to indicate that searchString is a regular expression.

    • matchCase: boolean

      Force the matching to match lower/upper case exactly.

    • wordSeparators: string | null

      Force the matching to match entire words only. Pass null otherwise.

    • captureMatches: boolean

      The result will contain the captured groups.

    Returns FindMatch

    The range where the next match is. It is null if no next match has been found.

findPreviousMatch

  • findPreviousMatch(searchString: string, searchStart: IPosition, isRegex: boolean, matchCase: boolean, wordSeparators: string | null, captureMatches: boolean): FindMatch
  • Search the model for the previous match. Loops to the end of the model if needed.

    Parameters

    • searchString: string

      The string used to search. If it is a regular expression, set isRegex to true.

    • searchStart: IPosition

      Start the searching at the specified position.

    • isRegex: boolean

      Used to indicate that searchString is a regular expression.

    • matchCase: boolean

      Force the matching to match lower/upper case exactly.

    • wordSeparators: string | null

      Force the matching to match entire words only. Pass null otherwise.

    • captureMatches: boolean

      The result will contain the captured groups.

    Returns FindMatch

    The range where the previous match is. It is null if no previous match has been found.

getAllDecorations

  • getAllDecorations(ownerId?: number, filterOutValidation?: boolean): IModelDecoration[]
  • Gets all the decorations as an array.

    Parameters

    • Optional ownerId: number

      If set, it will ignore decorations belonging to other owners.

    • Optional filterOutValidation: boolean

      If set, it will ignore decorations specific to validation (i.e. warnings, errors).

    Returns IModelDecoration[]

getAlternativeVersionId

  • getAlternativeVersionId(): number
  • Get the alternative version id of the model. This alternative version id is not always incremented, it will return the same values in the case of undo-redo.

    Returns number

getDecorationOptions

  • Get the options associated with a decoration.

    Parameters

    • id: string

      The decoration id.

    Returns IModelDecorationOptions

    The decoration options or null if the decoration was not found.

getDecorationRange

  • getDecorationRange(id: string): Range
  • Get the range associated with a decoration.

    Parameters

    • id: string

      The decoration id.

    Returns Range

    The decoration range or null if the decoration was not found.

getDecorationsInRange

  • getDecorationsInRange(range: IRange, ownerId?: number, filterOutValidation?: boolean): IModelDecoration[]
  • Gets all the deocorations in a range as an array. Only startLineNumber and endLineNumber from range are used for filtering. So for now it returns all the decorations on the same line as range.

    Parameters

    • range: IRange

      The range to search in

    • Optional ownerId: number

      If set, it will ignore decorations belonging to other owners.

    • Optional filterOutValidation: boolean

      If set, it will ignore decorations specific to validation (i.e. warnings, errors).

    Returns IModelDecoration[]

    An array with the decorations

getEOL

  • getEOL(): string
  • Get the end of line sequence predominantly used in the text buffer.

    Returns string

    EOL char sequence (e.g.: '\n' or '\r\n').

getFullModelRange

  • getFullModelRange(): Range

getLineContent

  • getLineContent(lineNumber: number): string
  • Get the text for a certain line.

    Parameters

    • lineNumber: number

    Returns string

getLineCount

  • getLineCount(): number
  • Get the number of lines in the model.

    Returns number

getLineDecorations

  • getLineDecorations(lineNumber: number, ownerId?: number, filterOutValidation?: boolean): IModelDecoration[]
  • Gets all the decorations for the line lineNumber as an array.

    Parameters

    • lineNumber: number

      The line number

    • Optional ownerId: number

      If set, it will ignore decorations belonging to other owners.

    • Optional filterOutValidation: boolean

      If set, it will ignore decorations specific to validation (i.e. warnings, errors).

    Returns IModelDecoration[]

    An array with the decorations

getLineFirstNonWhitespaceColumn

  • getLineFirstNonWhitespaceColumn(lineNumber: number): number
  • Returns the column before the first non whitespace character for line at lineNumber. Returns 0 if line is empty or contains only whitespace.

    Parameters

    • lineNumber: number

    Returns number

getLineLastNonWhitespaceColumn

  • getLineLastNonWhitespaceColumn(lineNumber: number): number
  • Returns the column after the last non whitespace character for line at lineNumber. Returns 0 if line is empty or contains only whitespace.

    Parameters

    • lineNumber: number

    Returns number

getLineLength

  • getLineLength(lineNumber: number): number
  • Get the text length for a certain line.

    Parameters

    • lineNumber: number

    Returns number

getLineMaxColumn

  • getLineMaxColumn(lineNumber: number): number
  • Get the maximum legal column for line at lineNumber

    Parameters

    • lineNumber: number

    Returns number

getLineMinColumn

  • getLineMinColumn(lineNumber: number): number
  • Get the minimum legal column for line at lineNumber

    Parameters

    • lineNumber: number

    Returns number

getLinesContent

  • getLinesContent(): string[]

getLinesDecorations

  • getLinesDecorations(startLineNumber: number, endLineNumber: number, ownerId?: number, filterOutValidation?: boolean): IModelDecoration[]
  • Gets all the decorations for the lines between startLineNumber and endLineNumber as an array.

    Parameters

    • startLineNumber: number

      The start line number

    • endLineNumber: number

      The end line number

    • Optional ownerId: number

      If set, it will ignore decorations belonging to other owners.

    • Optional filterOutValidation: boolean

      If set, it will ignore decorations specific to validation (i.e. warnings, errors).

    Returns IModelDecoration[]

    An array with the decorations

getModeId

  • getModeId(): string
  • getModeId(): string
  • Get the language associated with this model.

    Returns string

  • Get the language associated with this model.

    Returns string

getOffsetAt

  • Converts the position to a zero-based offset.

    The position will be adjusted.

    Parameters

    Returns number

    A valid zero-based offset.

getOneIndent

  • getOneIndent(): string
  • Get what is considered to be one indent (e.g. a tab character or 4 spaces, etc.).

    Returns string

getOptions

getOverviewRulerDecorations

  • getOverviewRulerDecorations(ownerId?: number, filterOutValidation?: boolean): IModelDecoration[]
  • Gets all the decorations that should be rendered in the overview ruler as an array.

    Parameters

    • Optional ownerId: number

      If set, it will ignore decorations belonging to other owners.

    • Optional filterOutValidation: boolean

      If set, it will ignore decorations specific to validation (i.e. warnings, errors).

    Returns IModelDecoration[]

getPositionAt

  • getPositionAt(offset: number): Position

getValue

  • Get the text stored in this model.

    Parameters

    • Optional eol: EndOfLinePreference

      The end of line character preference. Defaults to EndOfLinePreference.TextDefined.

    • Optional preserveBOM: boolean

    Returns string

    The text.

getValueInRange

  • Get the text in a certain range.

    Parameters

    • range: IRange

      The range describing what text to get.

    • Optional eol: EndOfLinePreference

      The end of line character preference. This will only be used for multiline ranges. Defaults to EndOfLinePreference.TextDefined.

    Returns string

    The text.

getValueLength

getValueLengthInRange

  • getValueLengthInRange(range: IRange): number
  • Get the length of text in a certain range.

    Parameters

    • range: IRange

      The range describing what text length to get.

    Returns number

    The text length.

getVersionId

  • getVersionId(): number
  • Get the current version id of the model. Anytime a change happens to the model (even undo/redo), the version id is incremented.

    Returns number

getWordAtPosition

  • Get the word under or besides position.

    Parameters

    • position: IPosition

      The position to look for a word.

    Returns IWordAtPosition

    The word under or besides position. Might be null.

  • Get the word under or besides position.

    Parameters

    • position: IPosition

      The position to look for a word.

    Returns IWordAtPosition

    The word under or besides position. Might be null.

getWordUntilPosition

  • Get the word under or besides position trimmed to position.column

    Parameters

    • position: IPosition

      The position to look for a word.

    Returns IWordAtPosition

    The word under or besides position. Will never be null.

  • Get the word under or besides position trimmed to position.column

    Parameters

    • position: IPosition

      The position to look for a word.

    Returns IWordAtPosition

    The word under or besides position. Will never be null.

isDisposed

  • isDisposed(): boolean
  • Returns if the model was disposed or not.

    Returns boolean

modifyPosition

  • Advances the given position by the given offest (negative offsets are also accepted) and returns it as a new valid position.

    If the offset and position are such that their combination goes beyond the beginning or end of the model, throws an exception.

    If the ofsset is such that the new position would be in the middle of a multi-byte line terminator, throws an exception.

    Parameters

    Returns Position

normalizeIndentation

  • normalizeIndentation(str: string): string
  • Normalize a string containing whitespace according to indentation rules (converts to spaces or to tabs).

    Parameters

    • str: string

    Returns string

pushEditOperations

  • pushEditOperations(beforeCursorState: Selection[], editOperations: IIdentifiedSingleEditOperation[], cursorStateComputer: ICursorStateComputer): Selection[]
  • Push edit operations, basically editing the model. This is the preferred way of editing the model. The edit operations will land on the undo stack.

    Parameters

    • beforeCursorState: Selection[]

      The cursor state before the edit operaions. This cursor state will be returned when undo or redo are invoked.

    • editOperations: IIdentifiedSingleEditOperation[]

      The edit operations.

    • cursorStateComputer: ICursorStateComputer

      A callback that can compute the resulting cursors state after the edit operations have been executed.

    Returns Selection[]

    The cursor state returned by the cursorStateComputer.

pushStackElement

  • pushStackElement(): void
  • Push a stack element onto the undo stack. This acts as an undo/redo point. The idea is to use pushEditOperations to edit the model and then to pushStackElement to create an undo/redo stop point.

    Returns void

setEOL

setValue

  • setValue(newValue: string): void
  • Replace the entire text buffer value contained in this model.

    Parameters

    • newValue: string

    Returns void

updateOptions

validatePosition

validateRange