Propriedade TextSelection.Text

Artigo
08/25/2010

Define ou obtém o texto selecionado.

Namespace: EnvDTE
Assembly: EnvDTE (em EnvDTE. dll)

Sintaxe

Default Property Text As String

Dim instance As TextSelection
Dim value As String

value = instance

instance = value

string this { get; set; }

property String^ default {
    String^ get ();
    void set (String^ value);
}

function get Text () : String
function set Text (value : String)

Valor da propriedade

Tipo: System.String
Uma Cadeia de Caracteres que representa o texto selecionado.

Comentários

A propriedade Text é a propriedade padrão para o objeto TextSelection.

Quando a propriedade Text é lido, o texto no texto selecionado é retornado, e a seleção propriamente dito é inalterada.

Quando a propriedade Text é definida, o valor de Text é inserido na frente do texto selecionado e, em seguida, recolhido, como o que acontece quando o texto é colado em um documento.Anotação que essa propriedade se comporta exatamente como ele faria quando o editor está no modo de Inserir (ou seja, nonovertype).Qualquer texto após o caractere 128th será truncado.

Se a propriedade Mode do objeto TextSelection é definida como Column, em seguida, Configuração a propriedade Text gera um erro.

Exemplos

Este exemplo funciona somente no Visual Studio .NET 2003.For more information, see Como: Migrar o código que cria projetos usando modelos.

Sub TextExample(ByVal dte As DTE)

    ' NOTE: This examples requires a reference to the 
    '       VSLangProj namespace.

    ' Create a new solution.
    Dim soln As Solution = dte.Solution
    Dim solnName As String = "NewSolution.sln"
    Dim tempPath As String = System.IO.Path.GetTempPath()
    soln.Create(tempPath, solnName)

    ' Create a new Visual Basic Console Application project.
    Dim templatePath As String = 
        dte.Solution.TemplatePath(PrjKind.prjKindVBProject)
    templatePath &= "ConsoleApplication.vsz"
    Dim projName As String = "NewProject"
    soln.AddFromTemplate(templatePath, tempPath & projName, projName)
    Dim proj As Project = soln.Item(1)

    ' Add a comment to Module1.vb.
    Dim item As ProjectItem = proj.ProjectItems.Item("Module1.vb")
    Dim sel As TextSelection = CType(item.Document.Selection, 
        TextSelection)

    sel.StartOfDocument()
    sel.NewLine()
    sel.LineUp()
    sel.Text = "' New comment" & vbCrLf

End Sub

public void TextExample(DTE dte)
{
    // NOTE: This examples requires a reference to the 
    //       VSLangProj namespace.

    // Create a new solution.
    Solution soln = dte.Solution;
    string solnName = "NewSolution.sln";
    string tempPath = System.IO.Path.GetTempPath();
    soln.Create(tempPath, solnName);

    // Create a new C# Console Application project.
    string templatePath = 
        dte.Solution.get_TemplatePath(PrjKind.prjKindCSharpProject);
    templatePath += "CSharpConsole.vsz";
    string projName = "Project1";
    soln.AddFromTemplate(templatePath, tempPath + projName, 
        projName, false);
    Project proj = soln.Item(1);

    // Add a comment to Class1.cs.
    ProjectItem item = proj.ProjectItems.Item("Class1.cs");
    TextSelection sel = (TextSelection)item.Document.Selection;

    sel.StartOfDocument(false);
    sel.NewLine(1);
    sel.LineUp(false, 1);
    sel.Text = "// New comment\n";
}

Permissões

Confiar total para o chamador imediato. Este membro não pode ser usado pelo código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de códigos parcialmente Confiável.