HTMLWindow3, interface

Représente une fenêtre de document HTML de l'environnement de développement intégré (IDE) de Visual Studio.

Espace de noms :  EnvDTE90
Assembly :  EnvDTE90 (dans EnvDTE90.dll)

Syntaxe

'Déclaration
<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

Le type HTMLWindow3 expose les membres suivants.

Propriétés

	Nom	Description
	CurrentPane	Obtient ou définit le type de fenêtre d'éditeur HTML active.
	CurrentView	Obtient ou indique si la fenêtre d'éditeur HTML est en mode d'affichage Source, Design ou Fractionné.

Début

Méthodes

	Nom	Description
	WaitForBackgroundProcessingComplete	Suspend l'exécution du programme jusqu'à la fin du traitement en arrière-plan.

Début

Notes

HTMLWindow3 est retourné par la propriété Object de l'objet Window dans le cas d'un document HTML.Window.Selection et Document.Selection retournent un objet TextSelection lorsque la propriété CurrentTab a la valeur vsHTMLTabsSource.

HTMLWindow3, vsHTMLPanes et vsHTMLViews ont été ajoutés avec l'introduction du mode Fractionné dans l'éditeur HTML de Visual Studio 2008.Le mode Fractionné sépare les onglets et les éléments d'affichage de la fenêtre de l'éditeur HTML.Le changement de mode (Design ou Source) n'implique pas nécessairement un changement d'onglet (Design/Fractionné/Source).Par exemple, lorsque vous cliquez sur l'onglet Fractionné, le basculement entre les modes Design et Source n'entraîne pas de changement d'onglet mais active ou désactive simplement les volets Design et Source en mode Fractionné.

Désormais, l'objet Visual Studio 2008HTMLWindow implémente également l'interface HTMLWindow3 qui retourne le affichage actuel (Design ou Source) et le volet actuel (onglet Design, Source ou Fractionné).

Règles HTMLWindow3

Le comportement de HTMLWindow3 est :

Get

Volet actuel (onglet)	Retourne l'affichage actuel
vsHTMLPaneDesign	vsHTMLViewDesign
vsHTMLPaneSource	vsHTMLViewSource
vsHTMLPaneSplit	vsHTMLViewDesign ou vsHTMLViewSource, en fonction de quelle partie est active.

Set

Volet actuel (onglet)	Paramètre
vsHTMLPaneDesign	Affecter la valeur vsHTMLViewSource au mode d'affichage ou la valeur vsHTMLPaneSource au volet fait basculer l'éditeur HTML en mode et volet Source. Affecter la valeur vsHTMLPaneSplit au volet fait basculer l'éditeur HTML en volet Fractionné avec la partie Design active.
vsHTMLPaneSource	Affecter la valeur vsHTMLViewDesign au mode d'affichage ou la valeur vsHTMLPaneDesign au volet fait basculer l'éditeur HTML en mode et volet Design. Affecter la valeur vsHTMLPaneSplit au volet fait basculer l'éditeur HTML en volet Fractionné avec la partie Source active.
vsHTMLPaneSplit	Affecter la valeur vsHTMLViewDesign au mode d'affichage fait basculer l'éditeur dans la partie Design du volet Fractionné.Le volet ne bascule PAS en mode Design. Affecter la valeur vsHTMLViewSource au mode d'affichage fait basculer l'éditeur dans la partie Source du volet Fractionné.Le volet ne bascule pas en volet Source. Affecter la valeur vsHTMLPaneDesign au volet fait basculer l'éditeur en mode et volet Design. Affecter la valeur vsHTMLPaneSource au volet fait basculer l'éditeur en mode et volet Source.

Exemples

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

Voir aussi

Référence

EnvDTE90, espace de noms