Compartir a través de


IVsTextView (Interfaz)

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 (UI).

Espacio de nombres:  Microsoft.VisualStudio.TextManager.Interop
Ensamblado:  Microsoft.VisualStudio.TextManager.Interop (en Microsoft.VisualStudio.TextManager.Interop.dll)

Sintaxis

'Declaración
<InterfaceTypeAttribute()> _
<GuidAttribute("BB23A14B-7C61-469A-9890-A95648CED5E6")> _
Public Interface IVsTextView
[InterfaceTypeAttribute()]
[GuidAttribute("BB23A14B-7C61-469A-9890-A95648CED5E6")]
public interface IVsTextView
[InterfaceTypeAttribute()]
[GuidAttribute(L"BB23A14B-7C61-469A-9890-A95648CED5E6")]
public interface class IVsTextView
[<InterfaceTypeAttribute()>]
[<GuidAttribute("BB23A14B-7C61-469A-9890-A95648CED5E6")>]
type IVsTextView =  interface end
public interface IVsTextView

El tipo IVsTextView expone los siguientes miembros.

Métodos

  Nombre Descripción
Método público AddCommandFilter Agrega un filtro de comando a los filtros existentes de la cadena de comandos.
Método público CenterColumns Coloca la columna de texto especificada en el centro de la vista.
Método público CenterLines Coloca las líneas de texto especificadas en el centro de la vista.
Método público ClearSelection borra la selección actual.
Método público CloseView Cierre y los anula una vista con el administrador de la vista.
Método público EnsureSpanVisible Garantiza que el texto está en la vista, vertical y horizontalmente.
Método público GetBuffer Devuelve el contenido actual del búfer de texto.
Método público GetCaretPos Devuelve la línea y el índice de la posición del cursor.
Método público GetLineAndColumn Convierte una secuencia de texto colocar a una línea y un índice de columna.
Método público GetLineHeight Devuelve el alto del píxel de una línea.
Método público GetNearestPosition Convierte una línea y un índice de columna en una posición de la secuencia de texto.
Método público GetPointOfLineColumn Devuelve las coordenadas de la esquina superior izquierda de una línea y una columna determinada.
Método público GetScrollInfo Devuelve los valores básicos de la barra de desplazamiento del editor de texto de la barra de desplazamiento especificada.
Método público GetSelectedText Devuelve una copia del texto seleccionado.
Método público GetSelection Devuelve el intervalo de texto correspondiente a la selección actual, si existe una.
Método público GetSelectionDataObject Devuelve una copia del texto seleccionado en formato de la interfaz de IDataObject .
Método público GetSelectionMode Devuelve el modo de selección actual.
Método público GetSelectionSpan Devuelve el intervalo de texto asociado con una selección.
Método público GetTextStream devuelve una secuencia especificada de texto en una cadena.
Método público GetWindowHandle Devuelve el identificador de ventana para esta vista.
Método público GetWordExtent Devuelve la extensión actual de word.
Método público HighlightMatchingBrace Resalta la llave correspondiente en una construcción de lenguaje.
Método público Initialize Crea la vista y permite que los clientes especifiquen una o más opciones de TextViewInitFlags.
Método público PositionCaretForEditing Coloca el símbolo de intercalación en una posición adecuada para modificar una función.
Método público RemoveCommandFilter Quita un filtro de comando de los filtros de la cadena de comandos.
Método público ReplaceTextOnLine reemplaza el texto de la línea.
Método público RestrictViewRange La información del método no se proporciona.el método no se implementa.
Método público SendExplicitFocus Envía el foco explícito a la ventana.
Método público SetBuffer Asocia un búfer de texto a la vista.
Método público SetCaretPos Establece las coordenadas del punto final de una selección.
Método público SetScrollPosition Establece los valores básicos de la barra de desplazamiento del editor de texto de la barra de desplazamiento especificada.
Método público SetSelection Selects especificado el texto.
Método público SetSelectionMode Establece el modo de selección.
Método público SetTopLine Establece la línea superior de la vista a la línea base.
Método público UpdateCompletionStatus Utilizado para el control de la finalización de palabras.
Método público UpdateTipWindow actualiza la ventana de la sugerencia.
Método público UpdateViewFrameCaption Fuerza la vista para actualizar la leyenda de la ventana de marco, por ejemplo “[read only]”.

Arriba

Comentarios

La interfaz de IVsTextView no es el elemento secundario de MDI, sino una ventana individual de texto. Si un divisor está completo, 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, el cursor, hace referencia al puntero del mouse.

Advertencia

Esta interfaz no es seguro para subprocesos.No debe llamar a nada en esta interfaz todos menos el subproceso principal de la interfaz de usuario.

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

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

Si obtiene una coordenada en las coordenadas de ViewCol, debe llamar a los métodos que toman las coordenadas de CharIndex después de asegurarse de que la coordenada de ViewCol no está en la región del espacio virtual. Por ejemplo, si llama al siguiente:

long iLine;

long cCount;

ViewCol iCol;

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

Deberá comprobar para asegurarse de que se cumple lo siguiente:

IVsTextBuffer::GetLengthOfLine(iLine, &cCount);

iCol < cCount

Llamar a continuación al siguiente:

IVsTextView::SomeOtherMethod(ViewCol(iCol ))

// where SomeOtherMethod takes ViewCol coordinates

Vea las ilustraciones de implementación o de la llamada de esta interfaz en el ejemplo Figures Language Service.

Notas para los llamadores

Llamado por los clientes que desean administrar su vista.

Vea también

Referencia

Microsoft.VisualStudio.TextManager.Interop (Espacio de nombres)