Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Classe HtmlElement

Representa um elemento HTML dentro de uma página da Web.

System.Object
  System.Windows.Forms.HtmlElement

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

[PermissionSetAttribute(SecurityAction.LinkDemand, Name = "FullTrust")]
public sealed class HtmlElement

O tipo HtmlElement expõe os membros a seguir.

  NomeDescrição
Propriedade públicaAllObtém um HtmlElementCollection de todos os elementos abaixo do elemento atual.
Propriedade públicaCanHaveChildrenObtém um valor que indica se esse elemento pode ter elementos filho.
Propriedade públicaChildrenObtém um HtmlElementCollection de todos os filhos do elemento atual.
Propriedade públicaClientRectangleObtém os limites da área cliente do elemento no documento HTML.
Propriedade públicaDocumentObtém o HtmlDocument ao qual pertence este elemento.
Propriedade públicaDomElementObtém um ponteiro de interface não gerenciada para esse elemento.
Propriedade públicaEnabledObtém ou define se o usuário pode inserir dados neste elemento.
Propriedade públicaFirstChildObtém o próximo elemento abaixo desse elemento na árvore do documento.
Propriedade públicaIdObtém ou define um rótulo pelo qual identificar o elemento.
Propriedade públicaInnerHtmlObtém ou define a marcação HTML sob esse elemento.
Propriedade públicaInnerTextObtém ou define o texto atribuído ao elemento.
Propriedade públicaNameObtém ou define o nome do elemento.
Propriedade públicaNextSiblingObtém o próximo elemento de mesmo nível, como esse elemento na árvore do documento.
Propriedade públicaOffsetParentObtém o elemento do qual OffsetRectangle é calculado.
Propriedade públicaOffsetRectangleObtém o local de um elemento em relação ao seu pai.
Propriedade públicaOuterHtmlObtém ou define o código HTML do elemento atual.
Propriedade públicaOuterTextObtém ou define o texto do elemento atual.
Propriedade públicaParentObtém o elemento do pai do elemento atual.
Propriedade públicaScrollLeftObtém ou define a distância entre a borda do elemento e a borda esquerda do seu conteúdo.
Propriedade públicaScrollRectangleObtém as dimensões da região rolável de um elemento.
Propriedade públicaScrollTopObtém ou define a distância entre a borda do elemento e a borda superior do seu conteúdo.
Propriedade públicaStyleObtém ou define uma lista delimitada por vírgulas dos estilos para o elemento atual.
Propriedade públicaTabIndexObtém ou define o local desse elemento na ordem de tabulação.
Propriedade públicaTagNameObtém o nome da marca HTML.
Superior

  NomeDescrição
Método públicoAppendChildAdiciona um elemento para a subárvore do elemento.
Método públicoAttachEventHandlerAdiciona um manipulador de eventos para um evento nomeado sobre o HTML documento objeto DOM (modelo).
Método públicoDetachEventHandlerRemove um manipulador de eventos de um evento nomeado sobre o HTML documento objeto DOM (modelo).
Método públicoEqualsSe o objeto fornecido é igual para o elemento atual de testes. (Substitui Object.Equals(Object).)
Método públicoFocusColoca o foco de entrada do usuário no elemento atual.
Método públicoGetAttributeRecupera o valor do atributo nomeado no elemento.
Método públicoGetElementsByTagNameRecupera uma coleção de elementos representados em HTML por especificado HTML marca.
Método públicoGetHashCodeServe como a função de hash padrão. (Substitui Object.GetHashCode().)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método públicoInsertAdjacentElementInserir um novo elemento para o documento objeto DOM (modelo).
Método públicoInvokeMember(String)Executa um método não exposto no elemento DOM subjacente desse elemento.
Método públicoInvokeMember(String, Object[])Executa uma função definida na página HTML atual por uma linguagem de script.
Método públicoRaiseEventFaz com que o evento nomeado chamar todos os manipuladores de eventos registrados.
Método públicoRemoveFocusRemove o foco do elemento atual, se esse elemento tiver foco.
Método públicoScrollIntoViewRola o documento que contém este elemento até que a borda superior ou inferior desse elemento é alinhada com a janela do documento.
Método públicoSetAttributeDefine o valor do atributo nomeado no elemento.
Método públicoToStringRetorna uma string que representa o objeto atual. (Herdado de Object.)
Superior

  NomeDescrição
Evento públicoClickOcorre quando o usuário clica no elemento com o botão esquerdo do mouse.
Evento públicoDoubleClickOcorre quando o usuário clica no botão esquerdo do mouse sobre um elemento duas vezes em sucessão rápida.
Evento públicoDragOcorre quando o usuário arrasta o texto em vários locais.
Evento públicoDragEndOcorre quando um usuário conclui uma operação de arrastar.
Evento públicoDragLeaveOcorre quando o usuário não está arrastando um item sobre este elemento.
Evento públicoDragOverOcorre quando o usuário arrasta o texto sobre o elemento.
Evento públicoFocusingOcorre quando o elemento vai receber recebe foco.
Evento públicoGotFocusOcorre quando o elemento recebe foco.
Evento públicoKeyDownOcorre quando o usuário pressiona uma tecla no teclado.
Evento públicoKeyPressOcorre quando o usuário pressiona e libera uma tecla no teclado.
Evento públicoKeyUpOcorre quando o usuário libera uma tecla no teclado.
Evento públicoLosingFocusOcorre quando o elemento vai perder foco.
Evento públicoLostFocusOcorre quando o elemento perdeu foco.
Evento públicoMouseDownOcorre quando o usuário pressiona um botão do mouse.
Evento públicoMouseEnterOcorre quando o usuário primeiro move o cursor do mouse sobre o elemento atual.
Evento públicoMouseLeaveOcorre quando o usuário move o cursor do mouse fora do elemento atual.
Evento públicoMouseMoveOcorre quando o usuário move o cursor do mouse entre o elemento.
Evento públicoMouseOverOcorre quando o cursor do mouse entra nos limites do elemento.
Evento públicoMouseUpOcorre quando o usuário libera um botão do mouse.
Superior

  NomeDescrição
Operador públicoMembro estáticoEqualityCompara dois elementos de igualdade.
Operador públicoMembro estáticoInequalityCompara dois HtmlElement objetos desigualdade.
Superior

HtmlElement representa qualquer possível tipo de elemento em um documento HTML, como BODY, TABLE, e FORM, entre outros. A classe expõe as propriedades mais comuns que você pode esperar encontrar em todos os elementos.

A maioria dos elementos podem ter elementos filho: outros elementos HTML que são colocados abaixo delas. Use o CanHaveChildren a propriedade para testar se um determinado elemento tem filhos e o Children coleção iterar através delas. O Parent propriedade para retornar o HtmlElement no qual o elemento atual está aninhado.

Você freqüentemente precisa acessar atributos, propriedades e métodos no elemento subjacente que não são diretamente expostos por HtmlElement, como o SRC de atributo em um IMG elemento ou o Submit método em um FORM. O GetAttribute e SetAttribute métodos permitem que você recuperar e alterar os atributos ou propriedade em um elemento específico, enquanto InvokeMember fornece acesso a todos os métodos não expostos no gerenciado documento objeto DOM (modelo). Se seu aplicativo não gerenciado a permissão de código, você também pode acessar não exposta de propriedades e métodos com o DomElement atributo.

Use o TagName a propriedade para testar se um elemento é de um tipo específico.

Qualquer documento HTML pode ser modificado em tempo de execução. Você pode criar novos HtmlElement objetos com o CreateElement o método de HtmlDocumente adicioná-los para outro elemento usando o AppendChild ou InsertAdjacentElement métodos. Você também pode criar os elementos como marcas HTML e atribuí-los a um elemento existente InnerHtml propriedade.

O exemplo de código a seguir mostra como examinar um documento HTML arbitrário e derive uma seqüência de caracteres que descreve os elementos HTML, com recuo e nível números usados para indicar como profundamente aninhados os elementos no documento. Este exemplo de código requer que os hosts do aplicativo um WebBrowser controle denominado WebBrowser1.


		private void PrintDomBegin()
		{
			if (webBrowser1.Document != null)
			{
				HtmlElementCollection elemColl = null;
				HtmlDocument doc = webBrowser1.Document;
				if (doc != null)
				{
					elemColl = doc.GetElementsByTagName("HTML");
					String str = PrintDom(elemColl, new System.Text.StringBuilder(), 0);
					webBrowser1.DocumentText = str;
				}
			}
		}

		private string PrintDom(HtmlElementCollection elemColl, System.Text.StringBuilder returnStr, Int32 depth)
		{
			System.Text.StringBuilder str = new System.Text.StringBuilder();

			foreach (HtmlElement elem in elemColl)
			{
				string elemName;

				elemName = elem.GetAttribute("ID");
				if (elemName == null || elemName.Length == 0)
				{
					elemName = elem.GetAttribute("name");
					if (elemName == null || elemName.Length == 0)
					{
						elemName = "<no name>";
					}
				}

				str.Append(' ', depth * 4);
				str.Append(elemName + ": " + elem.TagName + "(Level " + depth + ")");
				returnStr.AppendLine(str.ToString());

				if (elem.CanHaveChildren)
				{
					PrintDom(elem.Children, returnStr, depth + 1);
				}

				str.Remove(0, str.Length);
			}

			return(returnStr.ToString());
		}


.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Qualquer estático (Shared no Visual Basic) membro público desse tipo é thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Contribuições da comunidade

ADICIONAR
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2014 Microsoft