Sdílet prostřednictvím


HTMLWindow3 – rozhraní

Představuje okna HTML v Visual Studio integrované vývojové prostředí (IDE).

Obor názvů:  EnvDTE90
Sestavení:  EnvDTE90 (v EnvDTE90.dll)

Syntaxe

'Deklarace
<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

Typ HTMLWindow3 zveřejňuje následující členy.

Vlastnosti

  Název Popis
Veřejná vlastnost CurrentPane Získá nebo nastaví aktuální Editor HTML typ okna.
Veřejná vlastnost CurrentView Získá nebo nastaví, zda se okno editoru HTML je zdroj nebo rozdělit Návrhář zobrazení.

Nahoru

Metody

  Název Popis
Veřejná metoda WaitForBackgroundProcessingComplete Pozastaví provádění programu, až do dokončení zpracování na pozadí.

Nahoru

Poznámky

HTMLWindow3vrátil Object vlastnost Window objektu v případě, že dokument je dokument HTML.Window.Selectiona Document.Selection vrátí TextSelection objektu při CurrentTab vlastnost vsHTMLTabsSource.

HTMLWindow3, vsHTMLPanes a vsHTMLViews byly přidány zavedení rozděleného zobrazení v Visual Studio 2008 editoru HTML.Rozdělené zobrazení odděluje prvky kartu a zobrazení okna editoru HTML.Přepnutí zobrazení (na návrh nebo zdroj) neznamená přepnutí na kartu (Split/návrh/zdroj).Například při kartu rozdělit přepínání zobrazení návrhu a zdroje na kartě nezmění, pouze aktivuje nebo deaktivuje částí návrhu a zdroje v rozděleném zobrazení.

Visual Studio 2008HTMLWindow Objekt nyní také implementuje HTMLWindow3 rozhraní, která vrací aktuální zobrazení (návrh nebo zdroj) a aktuální podokno (karta návrh, zdroj nebo rozdělit). 

HTMLWindow3 pravidla

Chování HTMLWindow3 je:

Získat

Aktuální podokno (karta)

Vrátí aktuální zobrazení

vsHTMLPaneDesign

vsHTMLViewDesign

vsHTMLPaneSource

vsHTMLViewSource

vsHTMLPaneSplit

Buď vsHTMLViewDesign nebo vsHTMLViewSourcev závislosti na části, které je aktivní.

Nastavit

Aktuální podokno (karta)

Nastavení

vsHTMLPaneDesign

  • Nastavení zobrazení na vsHTMLViewSource nebo v podokně na vsHTMLPaneSource přepnutí do zobrazení zdroje a podokno zdroj HTML Editor.

  • V podokně nastavení na vsHTMLPaneSplit přepne do podokna Rozdělit s aktivní částí návrhu editoru HTML.

vsHTMLPaneSource

  • Nastavení zobrazení na vsHTMLViewDesign nebo v podokně na vsHTMLPaneDesign přepnutí do návrhového zobrazení a podokně Návrh editoru HTML.

  • V podokně nastavení na vsHTMLPaneSplit přepne na rozdělení podokna s aktivní částí zdroj HTML Editor.

vsHTMLPaneSplit

  • Nastavení zobrazení na vsHTMLViewDesign přepne na část návrhu rozdělení podokna v editoru.V podokně nezmění do návrhového zobrazení.

  • Nastavení zobrazení na vsHTMLViewSource přepínače editor zdroj část podokna rozdělit.V podokně do podokna zdroj nezmění.

  • V podokně nastavení na vsHTMLPaneDesign přepnutí do návrhového zobrazení a podokně Návrh editoru.

  • V podokně nastavení na vsHTMLPaneSource editor přepnutí do zobrazení zdroj a podokno zdroj.

Příklady

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.");
}

Viz také

Referenční dokumentace

EnvDTE90 – obor názvů