Interfaccia TextRange

Articolo
08/11/2011

Rappresenta una singola sezione contigua di testo in un documento di testo.

Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Sintassi

'Dichiarazione
<GuidAttribute("72767524-E3B3-43D0-BB46-BBE1D556A9FF")> _
Public Interface TextRange

[GuidAttribute("72767524-E3B3-43D0-BB46-BBE1D556A9FF")]
public interface TextRange

[GuidAttribute(L"72767524-E3B3-43D0-BB46-BBE1D556A9FF")]
public interface class TextRange

[<GuidAttribute("72767524-E3B3-43D0-BB46-BBE1D556A9FF")>]
type TextRange =  interface end

public interface TextRange

Il tipo TextRange espone i seguenti membri.

Proprietà

	Nome	Descrizione
	Collection	Ottiene l'insieme contenente l'oggetto TextRange che supporta questa proprietà.
	DTE	Ottiene l'oggetto di estensibilità di primo livello.
	EndPoint	Ottiene un oggetto EditPoint che rappresenta la fine dell'intervallo.
	StartPoint	Ottiene l'oggetto EditPoint che rappresenta l'inizio del documento di testo o il primo carattere visualizzato del riquadro.

In alto

Note

La sezione di testo è delimitata da una coppia di oggetti EditPoint.

Gli oggetti TextRange vengono utilizzati quando sono presenti espressioni regolari con sottoespressioni con tag. Viene restituito un insieme di intervalli, uno per ogni sottoespressione trovata, e le relative proprietà sono in sola lettura.

Per interventi di carattere generale sul testo, si consiglia di utilizzare oggetti quali TextSelection o EditPoint, perché l'oggetto TextSelection fa riferimento direttamente alla selezione visibile sullo schermo. Quando l'area di selezione cambia, variano anche le coordinate dell'oggetto e viceversa. Di conseguenza, una selezione di testo non può essere utilizzata per rappresentare un intervallo di testo arbitrario senza compromettere tale selezione di testo.

Esempi

Sub TextRangeExample(ByVal dte As EnvDTE.DTE)
    Dim objTxtSel As TextSelection
    Dim colRanges As TextRanges
    Dim objRange As TextRange
    Dim objEP As EditPoint

    objTxtSel = dte.ActiveDocument.Selection
    colRanges = objTxtSel.TextRanges
    For Each objRange In colRanges
        objRange.StartPoint.Insert("/*")
        objRange.EndPoint.Insert("*/")
    Next
End Sub

public void TextRangeExample(_DTE dte)
{
    TextSelection ts;
    TextRanges trs;

    ts = (TextSelection)dte.ActiveDocument.Selection;
    trs = ts.TextRanges;
    MessageBox.Show (trs.Count.ToString ());
    foreach (TextRange tr in trs)
    {
        tr.StartPoint.Insert ("/*");
        tr.EndPoint.Insert ("*/");
    }
}

Vedere anche

Riferimenti

Spazio dei nomi EnvDTE

Condividi tramite