IVsTextView Interfaz

Definición

Administra la vista de texto de una ventana del editor y contiene métodos para administrar la vista de texto. La vista es esencialmente la ventana del editor mostrada en la interfaz de usuario.

public interface class IVsTextView
public interface class IVsTextView
__interface IVsTextView
[System.Runtime.InteropServices.ComConversionLoss]
[System.Runtime.InteropServices.Guid("BB23A14B-7C61-469A-9890-A95648CED5E6")]
[System.Runtime.InteropServices.InterfaceType(1)]
public interface IVsTextView
[<System.Runtime.InteropServices.ComConversionLoss>]
[<System.Runtime.InteropServices.Guid("BB23A14B-7C61-469A-9890-A95648CED5E6")>]
[<System.Runtime.InteropServices.InterfaceType(1)>]
type IVsTextView = interface
Public Interface IVsTextView
Derivado
Atributos

Comentarios

La IVsTextView interfaz no es el elemento secundario MDI, sino una ventana de texto individual. Si hay un divisor implicado, puede haber varias vistas en un elemento secundario de MDI. El término, símbolo de intercalación, hace referencia al punto de inserción de texto, mientras que el término cursor hace referencia al puntero del mouse.

Precaución

Esta interfaz no es segura para subprocesos. No debe llamar a nada en esta interfaz desde nada excepto el subproceso de interfaz de usuario principal.

Si necesita realizar alguna operación en la vista desde un subproceso diferente, puede:

Algunos métodos de IVsTextView utilizan coordenadas ViewCol (por ejemplo, GetTextStream y GetCaretPos ), mientras que otras usan coordenadas CHARINDEX (por ejemplo, GetWordExtent ). Las coordenadas ViewCol pueden incluir espacio virtual mientras que las coordenadas CharIndex solo son un desplazamiento en una línea de búfer y nunca incluyen espacio virtual.

Si obtiene una coordenada en coordenadas ViewCol, solo debe llamar a métodos que tomen coordenadas CharIndex después de asegurarse de que la coordenada ViewCol no se encuentra en la región de espacio virtual. Por ejemplo, si llama a lo siguiente:

long iLine;

long cCount;

ViewCol iCol;

IVsTextView::SomeMethod(&iLine, &icol);

A continuación, debe comprobar para asegurarse de que se cumple lo siguiente:

IVsTextBuffer::GetLengthOfLine(iLine, &cCount);

iCol < cCount

A continuación, llame a lo siguiente:

IVsTextView::SomeOtherMethod(ViewCol(iCol ))

// where SomeOtherMethod takes ViewCol coordinates

Vea las ilustraciones de la implementación y/o la llamada de esta interfaz en el servicio de lenguaje de figurasde ejemplo.

Notas a los autores de las llamadas

Lo llaman los clientes que desean administrar su vista.

Métodos

AddCommandFilter(IOleCommandTarget, IOleCommandTarget)

Agrega un filtro de comando a la cadena existente de filtros de comandos.

CenterColumns(Int32, Int32, Int32)

Coloca la columna de texto especificada en el centro de la vista.

CenterLines(Int32, Int32)

Coloca las líneas de texto especificadas en el centro de la vista.

ClearSelection(Int32)

Borra la selección actual.

CloseView()

Cierra y anula el registro de una vista con el administrador de vistas.

EnsureSpanVisible(TextSpan)

Garantiza que el texto está en la vista, vertical y horizontalmente.

GetBuffer(IVsTextLines)

Devuelve el contenido actual del búfer de texto.

GetCaretPos(Int32, Int32)

Devuelve el índice de línea y columna de la posición del cursor.

GetLineAndColumn(Int32, Int32, Int32)

Convierte una posición de la secuencia de texto en un índice de línea y columna.

GetLineHeight(Int32)

Devuelve el alto de píxel de una línea.

GetNearestPosition(Int32, Int32, Int32, Int32)

Convierte un índice de línea y columna en una posición de la secuencia de texto.

GetPointOfLineColumn(Int32, Int32, POINT[])

Devuelve las coordenadas de la esquina superior izquierda de una línea y columna determinadas.

GetScrollInfo(Int32, Int32, Int32, Int32, Int32)

Devuelve la configuración básica de la barra de desplazamiento del editor de texto de la barra de desplazamiento especificada.

GetSelectedText(String)

Devuelve una copia del texto seleccionado.

GetSelection(Int32, Int32, Int32, Int32)

Devuelve el intervalo de texto correspondiente a la selección actual, si la hay.

GetSelectionDataObject(IDataObject)

Devuelve una copia del texto seleccionado en formato de interfaz IDataObject.

GetSelectionMode()

Devuelve el modo de selección actual.

GetSelectionSpan(TextSpan[])

Devuelve el intervalo de texto asociado a una selección.

GetTextStream(Int32, Int32, Int32, Int32, String)

Devuelve una secuencia de texto especificada en una cadena.

GetWindowHandle()

Devuelve el identificador de ventana para esta vista.

GetWordExtent(Int32, Int32, UInt32, TextSpan[])

Devuelve la extensión de la palabra actual.

HighlightMatchingBrace(UInt32, UInt32, TextSpan[])

Resalta la llave correspondiente en una construcción de lenguaje.

Initialize(IVsTextLines, IntPtr, UInt32, INITVIEW[])

Crea la vista y permite que los clientes especifiquen una o más opciones de TextViewInitFlags.

PositionCaretForEditing(Int32, Int32)

Coloca el símbolo de intercalación en una posición adecuada para editar una función.

RemoveCommandFilter(IOleCommandTarget)

Quita un filtro de comandos de la cadena de filtros de comandos.

ReplaceTextOnLine(Int32, Int32, Int32, String, Int32)

Reemplaza el texto de línea.

RestrictViewRange(Int32, Int32, IVsViewRangeClient)

Reduce el intervalo de la vista de líneas visibles o editables a un subconjunto de las líneas del búfer.

SendExplicitFocus()

Envía el foco explícito a la ventana.

SetBuffer(IVsTextLines)

Asocia un búfer de texto a la vista.

SetCaretPos(Int32, Int32)

Establece las coordenadas del punto final de una selección.

SetScrollPosition(Int32, Int32)

Establece la configuración básica de la barra de desplazamiento del editor de texto para la barra de desplazamiento especificada.

SetSelection(Int32, Int32, Int32, Int32)

Selecciona el texto especificado.

SetSelectionMode(TextSelMode)

Establece el modo de selección.

SetTopLine(Int32)

Establece la línea superior de la vista en la línea base.

UpdateCompletionStatus(IVsCompletionSet, UInt32)

Se usa para el control de finalización de palabras.

UpdateTipWindow(IVsTipWindow, UInt32)

Actualiza la ventana de la sugerencia.

UpdateViewFrameCaption()

Fuerza la vista para actualizar la leyenda de la ventana de marco, por ejemplo “[Solo lectura]”.

Se aplica a