An editor.

Hierarchy

Index

Events

onDidDispose

  • An event emitted when the editor has been disposed.

    Parameters

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

    Returns IDisposable

Methods

dispose

  • dispose(): void

focus

  • focus(): void
  • Brings browser focus to the editor text

    Returns void

getEditorType

  • getEditorType(): string
  • Get the editor type. Please see EditorType. This is to avoid an instanceof check

    Returns string

getId

  • getId(): string
  • Get a unique id for this editor instance.

    Returns string

getModel

getPosition

getSelection

getSelections

  • getSelections(): Selection[] | null
  • Returns all the selections of the editor.

    Returns Selection[] | null

getSupportedActions

  • getSupportedActions(): IEditorAction[]
  • Returns all actions associated with this editor.

    Returns IEditorAction[]

getVisibleColumnFromPosition

  • getVisibleColumnFromPosition(position: IPosition): number
  • Given a position, returns a column number that takes tab-widths into account.

    Parameters

    Returns number

hasTextFocus

  • hasTextFocus(): boolean
  • Returns true if the text inside this editor is focused (i.e. cursor is blinking).

    Returns boolean

layout

  • Instructs the editor to remeasure its container. This method should be called when the container of the editor gets resized.

    If a dimension is passed in, the passed in value will be used.

    Parameters

    Returns void

restoreViewState

  • Restores the view state of the editor from a serializable object generated by saveViewState.

    Parameters

    Returns void

revealLine

  • revealLine(lineNumber: number, scrollType?: ScrollType): void
  • Scroll vertically as necessary and reveal a line.

    Parameters

    • lineNumber: number
    • Optional scrollType: ScrollType

    Returns void

revealLineInCenter

  • revealLineInCenter(lineNumber: number, scrollType?: ScrollType): void
  • Scroll vertically as necessary and reveal a line centered vertically.

    Parameters

    • lineNumber: number
    • Optional scrollType: ScrollType

    Returns void

revealLineInCenterIfOutsideViewport

  • revealLineInCenterIfOutsideViewport(lineNumber: number, scrollType?: ScrollType): void
  • Scroll vertically as necessary and reveal a line centered vertically only if it lies outside the viewport.

    Parameters

    • lineNumber: number
    • Optional scrollType: ScrollType

    Returns void

revealLines

  • revealLines(startLineNumber: number, endLineNumber: number, scrollType?: ScrollType): void
  • Scroll vertically as necessary and reveal lines.

    Parameters

    • startLineNumber: number
    • endLineNumber: number
    • Optional scrollType: ScrollType

    Returns void

revealLinesInCenter

  • revealLinesInCenter(lineNumber: number, endLineNumber: number, scrollType?: ScrollType): void
  • Scroll vertically as necessary and reveal lines centered vertically.

    Parameters

    • lineNumber: number
    • endLineNumber: number
    • Optional scrollType: ScrollType

    Returns void

revealLinesInCenterIfOutsideViewport

  • revealLinesInCenterIfOutsideViewport(lineNumber: number, endLineNumber: number, scrollType?: ScrollType): void
  • Scroll vertically as necessary and reveal lines centered vertically only if it lies outside the viewport.

    Parameters

    • lineNumber: number
    • endLineNumber: number
    • Optional scrollType: ScrollType

    Returns void

revealPosition

  • Scroll vertically or horizontally as necessary and reveal a position.

    Parameters

    Returns void

revealPositionInCenter

  • Scroll vertically or horizontally as necessary and reveal a position centered vertically.

    Parameters

    Returns void

revealPositionInCenterIfOutsideViewport

  • Scroll vertically or horizontally as necessary and reveal a position centered vertically only if it lies outside the viewport.

    Parameters

    Returns void

revealRange

  • Scroll vertically or horizontally as necessary and reveal a range.

    Parameters

    Returns void

revealRangeAtTop

  • Scroll vertically or horizontally as necessary and reveal a range at the top of the viewport.

    Parameters

    Returns void

revealRangeInCenter

  • Scroll vertically or horizontally as necessary and reveal a range centered vertically.

    Parameters

    Returns void

revealRangeInCenterIfOutsideViewport

  • revealRangeInCenterIfOutsideViewport(range: IRange, scrollType?: ScrollType): void
  • Scroll vertically or horizontally as necessary and reveal a range centered vertically only if it lies outside the viewport.

    Parameters

    Returns void

saveViewState

setModel

  • Sets the current model attached to this editor. If the previous model was created by the editor via the value key in the options literal object, it will be destroyed. Otherwise, if the previous model was set via setModel, or the model key in the options literal object, the previous model will not be destroyed. It is safe to call setModel(null) to simply detach the current model from the editor.

    Parameters

    Returns void

setPosition

  • Set the primary position of the cursor. This will remove any secondary cursors.

    Parameters

    • position: IPosition

      New primary cursor's position

    Returns void

setSelection

  • setSelection(selection: IRange): void
  • setSelection(selection: Range): void
  • setSelection(selection: ISelection): void
  • setSelection(selection: Selection): void
  • Set the primary selection of the editor. This will remove any secondary cursors.

    Parameters

    • selection: IRange

      The new selection

    Returns void

  • Set the primary selection of the editor. This will remove any secondary cursors.

    Parameters

    • selection: Range

      The new selection

    Returns void

  • Set the primary selection of the editor. This will remove any secondary cursors.

    Parameters

    Returns void

  • Set the primary selection of the editor. This will remove any secondary cursors.

    Parameters

    Returns void

setSelections

  • setSelections(selections: keyof ISelection[]): void
  • Set the selections for all the cursors of the editor. Cursors will be removed or added, as necessary.

    Parameters

    • selections: keyof ISelection[]

    Returns void

trigger

  • trigger(source: string, handlerId: string, payload: any): void
  • Directly trigger a handler or an editor action.

    Parameters

    • source: string

      The source of the call.

    • handlerId: string

      The id of the handler or the id of a contribution.

    • payload: any

      Extra data to be sent to the handler.

    Returns void

updateOptions