Interface HTMLWindow3

Artigo
05/17/2015

Representa uma janela de documento em HTML a Visual Studio o ambiente de desenvolvimento integrado (IDE).

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

Sintaxe

'Declaração
<GuidAttribute("BAD0A3DD-8109-4684-B806-A5282267BFE4")> _
Public Interface HTMLWindow3

[GuidAttribute("BAD0A3DD-8109-4684-B806-A5282267BFE4")]
public interface HTMLWindow3

[GuidAttribute(L"BAD0A3DD-8109-4684-B806-A5282267BFE4")]
public interface class HTMLWindow3

[<GuidAttribute("BAD0A3DD-8109-4684-B806-A5282267BFE4")>]
type HTMLWindow3 =  interface end

public interface HTMLWindow3

O tipo HTMLWindow3 expõe os membros a seguir.

Propriedades

	Nome	Descrição
	CurrentPane	Obtém ou define o tipo de janela de Editor de HTML atual.
	CurrentView	Obtém ou define se a janela do Editor de HTML está na origem, Designer ou divisão view.

Superior

Métodos

	Nome	Descrição
	WaitForBackgroundProcessingComplete	Execução de programa faz uma pausa até a conclusão de processamento em segundo plano.

Superior

Comentários

HTMLWindow3é retornado pelo Object propriedade da Window de objeto quando o documento é um documento HTML. Window.Selectione Document.Selection retorna um TextSelection objeto quando o CurrentTab propriedade estiver definida como vsHTMLTabsSource.

HTMLWindow3, vsHTMLPanes e vsHTMLViews foram adicionadas com a introdução do modo de exibição de divisão na Visual Studio 2008 editor de HTML. Modo divisão separa os elementos de guia e o modo de exibição da janela do Editor de HTML. Alternar entre os modos de exibição (para Design ou código-fonte) não significa necessariamente alternando a guia (divisão/Design/origem). Por exemplo, quando você clica na guia de divisão, alternando os modos entre Design e código-fonte não altera a guia, somente ativa ou desativa as partes de origem e de Design no modo de exibição de divisão.

O Visual Studio 2008HTMLWindow de objeto agora também implementa o HTMLWindow3 interface que retorna o modo de exibição atual (Design ou código-fonte) e o painel atual (guia Design, fonte ou divisão).

Regras de HTMLWindow3

O comportamento do HTMLWindow3 é:

Get

Painel atual (guia)	Retorna do modo de exibição atual
vsHTMLPaneDesign	vsHTMLViewDesign
vsHTMLPaneSource	vsHTMLViewSource
vsHTMLPaneSplit	Um dos vsHTMLViewDesign ou vsHTMLViewSource, dependendo de qual peça está ativa.

Set

Painel atual (guia)	Configuração
vsHTMLPaneDesign	Definindo o modo de exibição para vsHTMLViewSource ou o painel de vsHTMLPaneSource alterna o Editor de HTML para visualização código-fonte e o painel código-fonte. A configuração do painel de como vsHTMLPaneSplit alterna o Editor de HTML para o painel de divisão com a parte do projeto ativa.
vsHTMLPaneSource	Definindo o modo de exibição para vsHTMLViewDesign ou o painel de vsHTMLPaneDesign alterna o Editor de HTML para o modo de Design e o painel Design. A configuração do painel de como vsHTMLPaneSplit alterna o Editor de HTML para o painel de divisão com a parte de origem ativa.
vsHTMLPaneSplit	Definindo o modo de exibição para vsHTMLViewDesign alterna o editor para a parte de Design do painel de divisão. O painel não altera para o modo Design. Definindo o modo de exibição para vsHTMLViewSource alterna o editor para a parte de origem do painel de divisão. O painel não altera para o painel de origem. A configuração do painel de como vsHTMLPaneDesign alterna o editor para o modo de Design e o painel Design. A configuração do painel de como vsHTMLPaneSource alterna o editor para o modo fonte e o painel código-fonte.

Exemplos

Sub HTMLWindow3Example(ByVal dte As EnvDTE80.DTE2)
    ' Open an HTML document before running this sample.
    If TypeOf dte.ActiveDocument.ActiveWindow.Object Is HTMLWindow3 _
        Then
            ' Ask the user for a file to insert into the body of the
            ' HTML document. This file should be an HTML fragment.
            Dim strFile As String = InputBox("Enter the name of a _
              file to insert at the end of the HTML document:")
            ' Get the HTMLWindow3 object and determine which tab is 
            ' currently active.
            Dim objHTMLWin As HTMLWindow3 = _
            CType(dte.ActiveDocument.ActiveWindow.Object, HTMLWindow3)
            Dim Tab As vsHTMLTabs = CType(objHTMLWin.CurrentTab, _
              vsHTMLTabs)
            Dim cpane As vsHTMLPanes = vsHTMLPanes.vsHTMLPaneSplit

            ' Switch to the "split" view, source view.
            objHTMLWin.CurrentPane = vsHTMLPanes.vsHTMLPaneSplit
            objHTMLWin.CurrentView = vsHTMLViews.vsHTMLViewSource

            ' Get an EditPoint at the start of the text.
            Dim objTextWin As TextWindow = _
              CType(objHTMLWin.CurrentTabObject, TextWindow)
            Dim objEP As EditPoint = _
            objTextWin.ActivePane.StartPoint.CreateEditPoint

            ' Look for the end of the document body.
            If objEP.FindPattern("</body>") Then
                ' Insert the contents of the file.
                objEP.InsertFromFile(strFile)
            End If

            ' Switch back to the original view of the HTML file.
            'objHTMLWin.CurrentTab = Tab
        Else
            MsgBox("You must open an HTML document.")
        End If
    End Sub

public void HTMLWindowExample(_DTE dte)
{
    // Open an HTML document before running this sample.
    if (dte.ActiveDocument.ActiveWindow.Object is HTMLWindow3)
    {
        HTMLWindow3 objHTMLWin;
        vsHTMLTabs Tab;
        String strFileName;
        // Ask the user for a file to insert into the body of the HTML 
        // document. This file should be an HTML fragment.
        strFileName = Microsoft.VisualBasic.Interaction.InputBox 
        ("Enter the name of a file to insert at the end of the HTML 
        document:","","",100,100);
        // Get the HTMLWindow3 object and determine which tab is 
        // currently active.
        objHTMLWin = dte.ActiveDocument.ActiveWindow.Object as 
        HTMLWindow3;
        Tab = objHTMLWin.CurrentTab;

        // Switch to the "source" tab.
        objHTMLWin.CurrentPane = vsHTMLPanes.vsHTMLPaneSplit;
        objHTMLWin.CurrentTab = vsHTMLViews.vsHTMLViewSource;

        // Get an EditPoint at the start of the text.
        TextWindow objTextWin;
        EditPoint ep;
        EditPoint ep2 = null;
        TextRanges textRanges = null;
        objTextWin = objHTMLWin.CurrentTabObject as TextWindow;
        ep = objTextWin.ActivePane.StartPoint.CreateEditPoint();
        textRanges = objTextWin.Selection.TextRanges;

        // Look for the end of the document body.
        if (ep.FindPattern 
        ("</body>",(int)vsFindOptions.vsFindOptionsNone, ref ep2, ref 
        textRanges))
            // Insert the contents of the file.
            ep.InsertFromFile (strFileName);
            // Switch back to the original view of the HTML file.
            objHTMLWin.CurrentTab = Tab;
    }
    else
        MessageBox.Show ("You must open an HTML document.");
}

Consulte também

Referência

Namespace EnvDTE90

Partilhar via