HtmlWindow.Frames Propriedade

public:
 property System::Windows::Forms::HtmlWindowCollection ^ Frames { System::Windows::Forms::HtmlWindowCollection ^ get(); };

public System.Windows.Forms.HtmlWindowCollection Frames { get; }

public System.Windows.Forms.HtmlWindowCollection? Frames { get; }

member this.Frames : System.Windows.Forms.HtmlWindowCollection

Public ReadOnly Property Frames As HtmlWindowCollection

Valor de Propriedade

Um HtmlWindowCollection de documentos FRAME e IFRAME objetos.

Exemplos

O exemplo de código seguinte inspeciona cada documento dentro de uma página contendo frames e cria uma tabela com todos os hiperlinks de saída de cada página para inspeção futura.

private void GetLinksFromFrames()
{
    Hashtable linksTable = new Hashtable();
    string frameUrl;

    if (!(webBrowser1.Document == null))
    {
        HtmlWindow currentWindow = webBrowser1.Document.Window;
        if (currentWindow.Frames.Count > 0)
        {
            foreach (HtmlWindow frame in currentWindow.Frames)
            {
                frameUrl = frame.Url.ToString();
                Hashtable frameLinksHash = new Hashtable();

                linksTable.Add(frameUrl, frameLinksHash);
                foreach (HtmlElement hrefElement in frame.Document.Links)
                {
                    frameLinksHash.Add(hrefElement.GetAttribute("HREF"), "Url");
                }
            }
        }
        else
        {
            Hashtable docLinksHash = new Hashtable();
            linksTable.Add(webBrowser1.Document.Url.ToString(), docLinksHash);

            foreach (HtmlElement hrefElement in webBrowser1.Document.Links)
            {
                docLinksHash.Add(hrefElement.GetAttribute("HREF"), "Url");
            }
        }
    }
}

Dim LinksTable As Hashtable

Private Sub GetLinksFromFrames()
    LinksTable = New Hashtable()
    Dim FrameUrl As String

    If (WebBrowser1.Document IsNot Nothing) Then
        With WebBrowser1.Document
            Dim CurrentWindow As HtmlWindow = .Window
            If (CurrentWindow.Frames.Count > 0) Then
                For Each Frame As HtmlWindow In CurrentWindow.Frames
                    FrameUrl = Frame.Url.ToString()
                    Dim FrameLinksHash As New Hashtable()
                    LinksTable.Add(FrameUrl, FrameLinksHash)

                    For Each HrefElement As HtmlElement In Frame.Document.Links
                        FrameLinksHash.Add(HrefElement.GetAttribute("HREF"), "Url")
                    Next
                Next
            Else
                Dim DocLinksHash As New Hashtable()
                LinksTable.Add(.Url.ToString(), DocLinksHash)

                For Each HrefElement As HtmlElement In .Links
                    DocLinksHash.Add(HrefElement.GetAttribute("HREF"), "Url")
                Next
            End If
        End With
    End If
End Sub

Observações

A FRAME é um conjunto de janelas definidas dentro de um FRAMESET. FRAMEs permitem alojar múltiplos documentos dentro de um único documento. Cada um FRAME é definido como possuindo uma certa largura de linha e coluna, e está posicionado na página em relação aos outros FRAMEs definidos dentro do FRAMESET; a posição de a FRAME é fixa, embora um utilizador possa por vezes usar o cursor do rato para aumentar ou diminuir o FRAME. An IFRAME é semelhante a uma estrutura, mas não precisa de estar ancorada numa posição fixa.

Os frames conterão uma instância de HtmlWindow para cada FRAME ou IFRAME definidos dentro de uma página Web.

Ver também

• Coleção de molduras