Partilhar via


Interface HTMLWindow3

Representa uma janela do documento HTML no Visual Studio ambiente de desenvolvimento integrado (IDE).

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

Sintaxe

<GuidAttribute("BAD0A3DD-8109-4684-B806-A5282267BFE4")> _
Public Interface HTMLWindow3

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

Comentários

HTMLWindow3 retornado pela Object propriedade das Window objeto quando o documento é um documento HTML. Window.Selection e 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 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 o modo de exibição (para o design ou código-fonte) não significa necessariamente alternando a guia (divisão/design/origem).Por exemplo, quando você clica na guia dividir, alternar entre modos de exibição entre o design e código-fonte não altera a guia, ele só ativa ou desativa as partes de design e código-fonte no modo divisão.

The Visual Studio 2008 HTMLWindow object now also implements the HTMLWindow3 interface that returns the current view (either Design or Source) and the current pane (tab, either Design, Source, or Split).

Regras HTMLWindow3

O comportamento de HTMLWindow3 é:

Get

Painel (tabulação) corrente

Retornos de exibição corrente

vsHTMLPaneDesign

vsHTMLViewDesign

vsHTMLPaneSource

vsHTMLViewSource

vsHTMLPaneSplit

Um dos vsHTMLViewDesign ou vsHTMLViewSource, dependendo de qual peça está ativo.

Set

Painel (tabulação) corrente

Configuração

vsHTMLPaneDesign

  • configuração o modo de exibição para vsHTMLViewSource ou no painel para vsHTMLPaneSource Alterna o Editor de HTML para visualização código-fonte e o painel código-fonte.

  • configuração o painel de vsHTMLPaneSplit Alterna o Editor de HTML para o painel de divisão com a parte do projeto ativo.

vsHTMLPaneSource

  • configuração o modo de exibição para vsHTMLViewDesign ou no painel para vsHTMLPaneDesign Alterna o Editor de HTML para modo de modo de exibição de Design e o painel Design.

  • Definir o painel para vsHTMLPaneSplit Alterna o Editor de HTML para o painel de divisão com a parte de fonte ativo.

vsHTMLPaneSplit

  • configuração o modo de exibição para vsHTMLViewDesign Alterna o editor para a parte do design do painel de divisão. O painel não faz alterar para o modo de modo de exibição de Design.

  • configuração o modo de exibição para vsHTMLViewSource Alterna o editor para a parte de fonte do painel de divisão. O painel não será alterado para painel de fonte.

  • configuração o painel de vsHTMLPaneDesign Alterna o editor para o modo de modo de exibição de Design e o painel Design.

  • Definir o painel para vsHTMLPaneSource Alterna o editor para visualização código-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

Membros HTMLWindow3

Namespace EnvDTE90