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