Funções gerais de edição

É possível controlar funções gerais de edição na janela Documento. Essas funções inserem textos, HTMLs e objetos; aplicam, alteram e removem fonte e marcação de caracteres; modificam tags, atributos e mais.

Disponibilidade

Dreamweaver 3.

Descrição

Aplica o tipo específico de marcação de caracteres à seleção. Se a seleção for um ponto de inserção, ela aplicará a marcação de caracteres especificada a qualquer texto posteriormente digitado.

Argumentos

tagName

• O argumento tagName é o nome da tag associada à marcação de caracteres. Deve ser uma das seguintes sequências de caracteres: "b", "cite", "code", "dfn", "em", "i", "kbd", "samp", "s", "strong", "tt", "u" ou "var".

Retorna

Nada.

dom.applyFontMarkup()

Disponibilidade

Dreamweaver 3.

Descrição

Aplica a tag FONT e o atributo e o valor especificados à seleção atual.

Argumentos

attribute, value

• O argumento attribute deve ser "face", "size" ou "color".

• O argumento value é o valor a ser atribuído ao atributo; por exemplo, "Arial, Helvetica, sans-serif", "5" ou "#FF0000".

Retorna

Nada.

dom.deleteSelection()

Disponibilidade

Dreamweaver 3.

Descrição

Exclui a seleção no documento.

Argumentos

Nenhum.

Retorna

Nada.

dom.editAttribute()

Disponibilidade

Dreamweaver 3.

Descrição

Exibe a interface apropriada para editar o atributo do Documento especificado. Na maioria dos casos, essa interface é uma caixa de diálogo. Esta função é válida apenas para o documento ativo.

Argumentos

attribute

• O attribute é uma sequência de caracteres que especifica o atributo de tag que você deseja editar.

Retorna

Nada.

dom.exitBlock()

Disponibilidade

Dreamweaver 3.

Descrição

Sai do parágrafo ou bloco de cabeçalho, deixando o ponto de inserção fora de todos os elementos do bloco.

Argumentos

Nenhum.

Retorna

Nada.

dom.getCharSet()

Disponibilidade

Dreamweaver 4.

Descrição

Retorna o atributo charset na tag meta do documento.

Argumentos

Nenhum.

Retorna

A identidade de codificação de documento. Por exemplo, no documento Latin1, a função retornará iso-8859-1.

dom.getFontMarkup()

Disponibilidade

Dreamweaver 3.

Descrição

Obtém o valor do atributo específico da tag FONT para a seleção atual.

Argumentos

attribute

• O argumento attribute deve ser "face", "size" ou "color".

Retorna

Uma sequência de caracteres que conterá o valor de atributo especificado ou uma sequência de caracteres vazia, se o atributo não estiver definido.

dom.getLineFromOffset()

Disponibilidade

Dreamweaver MX.

Descrição

Localiza o número de linha de um deslocamento de caractere específico no texto (o código HTML ou JavaScript) do arquivo.

Argumentos

offset

• O argumento offset é um número inteiro que representa o local de caracteres do início do arquivo.

Retorna

Um número inteiro que representa o número de linhas no documento.

dom.getLinkHref()

Disponibilidade

Dreamweaver 3.

Descrição

Obtém a interface que está em torno da seleção atual. Esta função é equivalente a loop pelos pais e de avós do nó atual até um link seja encontrada e chamando ogetAttribute('HREF') na interface.

Argumentos

Nenhum.

Retorna

Uma sequência de caracteres que contém o nome do arquivo vinculado, que é expresso como um URL de file://.

dom.getLinkTarget()

Disponibilidade

Dreamweaver 3.

Descrição

Obtém o destino do link em torno da seleção atual. Essa função é equivalente a loop pelos pais e de avós do nó atual até um link seja encontrada e chamando a função getAttribute('TARGET') na interface.

Argumentos

Nenhum.

Retorna

Uma sequência de caracteres que contém o valor do atributo TARGET para a interface ou uma sequência de caracteres vazia, se não houver um destino especificado.

dom.getListTag()

Disponibilidade

Dreamweaver 3.

Descrição

Obtém o estilo da lista selecionada.

Argumentos

Nenhum.

Retorna

Uma sequência de caracteres que contém a tag associada à lista ("ul", "ol" ou "dl") ou uma sequência de caracteres vazia se nenhuma tag estiver associada à lista. Esse valor retorna sempre minúsculas.

dom.getTextAlignment()

Disponibilidade

Dreamweaver 3.

Descrição

Obtém o alinhamento do bloco que contém a seleção.

Argumentos

Nenhum.

Retorna

Uma sequência de caracteres que contém o valor do atributo ALIGN para a tag associada ao bloco, ou uma sequência de caracteres vazia, se o atributo ALIGN não estiver definido para a tag. Esse valor retorna sempre minúsculas.

dom.getTextFormat()

Disponibilidade

Dreamweaver 3.

Descrição

Obtém o formato de bloco de texto selecionado.

Argumentos

Nenhum.

Retorna

Uma sequência de caracteres que contém a tag do bloco associado ao texto (por exemplo, "p", "h1", "pre" etc.) ou uma sequência de caracteres vazia, se nenhuma tag de bloco estiver associada à seleção. Esse valor retorna sempre minúsculas.

dom.hasCharacterMarkup()

Disponibilidade

Dreamweaver 3.

Descrição

Verifica se a seleção já tem a marcação de caracteres especificada.

Argumentos

markupTagName

• O argumento markupTagName é o nome da tag que você está verificando. Deve ser uma das seguintes sequências de caracteres: "b", "cite", "code", "dfn", "em", "i", "kbd", "samp", "s", "strong", "tt", "u" ou "var".

Retorna

Um valor booliano que indica se a seleção inteira tem a marcação de caracteres especificada. A função retornará o valor false se apenas parte da seleção tiver a marcação especificada.

dom.indent()

Disponibilidade

Dreamweaver 3.

Descrição

Recua a seleção usando as tags BLOCKQUOTE. Se a seleção for um item de lista, esta função recuará a seleção para converter o item selecionado em uma lista aninhada. Essa lista aninhada tem o mesmo tipo da lista e externa e contém um item, a seleção original.

Argumentos

Nenhum.

Retorna

Nada.

dom.insertHTML()

Disponibilidade

Dreamweaver 3.

Descrição

Insere conteúdo HTML no documento no ponto de inserção atual.

Argumentos

contentToInsert, {bReplaceCurrentSelection}

• O argumento contentToInsert é o conteúdo que você deseja inserir.

• O argumento opcional bReplaceCurrentSelection é um valor booliano que indica se o conteúdo precisa substituir a seleção atual. Se o argumento bReplaceCurrentSelection for um valor true, o conteúdo substituirá a seleção atual. Se o valor for false, o conteúdo será inserido depois da seleção atual.

Retorna

Nada.

Exemplo

O código a seguir insere a sequência de caracteres HTML <b>130</b> no documento atual:

O resultado é exibido na janela Documento.

dom.insertObject()

Disponibilidade

Dreamweaver 3.

Descrição

Insere o objeto especificado, solicitando que o usuário especifique os parâmetros, se necessário.

Argumentos

objectName

• O argumento objectName é o nome de um objeto na pasta Configuração/Objetos.

Retorna

Nada.

Exemplo

Uma chamada para a funçãodom.insertObject('Button') insere um botão no documento ativo da seleção atual. Se não houver nada selecionado, essa função inserirá o botão no ponto de inserção atual.

dom.insertText()

Disponibilidade

Dreamweaver 3.

Descrição

Insere conteúdo de texto no documento, no ponto de inserção atual.

Argumentos

contentToInsert, {bReplaceCurrentSelection}

• O argumento contentToInsert é o conteúdo que você deseja inserir.

• O argumento opcional bReplaceCurrentSelection é um valor booliano que indica se o conteúdo precisa substituir a seleção atual. Se o argumento bReplaceCurrentSelection for um valor true, o conteúdo substituirá a seleção atual. Se o valor for false, o conteúdo será inserido depois da seleção atual.

Retorna

Nada.

Exemplo

O código a seguir insere o texto &lt;b&gt;130&lt;/b&gt; no documento atual:

Os resultados são exibidos na janela Documento.

dom.newBlock()

Disponibilidade

Dreamweaver 3.

Descrição

Cria um bloco com a mesma tag e atributo que o bloco que contém a seleção atual ou cria um novo parágrafo se o ponteiro estiver fora de todos os bloqueios.

Argumentos

Nenhum.

Retorna

Nada.

Exemplo

Se a seleção atual estiver em um o parágrafo alinhado ao centro, uma chamada para a função dom.newBlock() vai inserir <p align="center"> após o parágrafo atual.

dom.notifyFlashObjectChanged()

Disponibilidade

Dreamweaver 4.

Descrição

Instrui o Dreamweaver que o arquivo de objeto Flash atual foi alterado. O Dreamweaver atualiza a exibição de pré-visualização, redimensionando-a conforme necessário, mantendo a proporção de largura-altura do tamanho original.

Argumentos

Nenhum.

Retorna

Nada.

dom.outdent()

Disponibilidade

Dreamweaver 3.

Descrição

Remove o recuo da seleção.

Argumentos

Nenhum.

Retorna

Nada.

dom.removeCharacterMarkup()

Disponibilidade

Dreamweaver 3.

Descrição

Remove o tipo especificado de marcação de caracteres da seleção.

Argumentos

tagName

• O argumento tagName é o nome da tag associada à marcação de caracteres. Deve ser uma das seguintes sequências de caracteres: "b", "cite", "code", "dfn", "em", "i", "kbd", "samp", "s", "strong", "tt", "u" ou "var".

Retorna

Nada.

dom.removeFontMarkup()

Disponibilidade

Dreamweaver 3.

Descrição

Remove o atributo especificado e o valor de uma tagFONT. Se a remoção do atributo deixar apenas a tag FONT, a tag FONT também será removida.

Argumentos

attribute

• O argumento attribute deve ser "face", "size" ou "color".

Retorna

Nada.

dom.resizeSelection()

Disponibilidade

Dreamweaver 3.

Descrição

Redimensiona o objeto selecionado com as dimensões especificadas.

Argumentos

newWidth, newHeight

• O argumento newWidth especifica a nova largura para a qual a função definirá o objeto selecionado.

• O argumento newHeight especifica a nova altura para a qual a função definirá o objeto selecionado.

Retorna

Nada.

dom.setAttributeWithErrorChecking()

Disponibilidade

Dreamweaver 3.

Descrição

Define o atributo especificado para o valor especificado para a seleção atual, informando ao usuário se o valor estiver incorreto ou fora da faixa. Esta função é válida apenas para o documento ativo.

Argumentos

attribute, value

• O argumento attribute especifica o atributo a ser definido para a seleção atual.

• O argumento value especifica o valor a ser definido para o atributo.

Retorna

Nada.

dom.setLinkHref()

Disponibilidade

Dreamweaver 3.

Descrição

Transforma a seleção em um link de hipertexto ou altera o valor do URL da tag HREFF que contém a seleção atual.

Argumentos

linkHREF

• O argumento linkHREF é o URL (caminho relativo ao documento, caminho relativo à raiz ou o URL absoluto) incluindo o link. Se o argumento for omitido, a caixa de diálogo Selecionar arquivo HTML será exibida.

Retorna

Nada.

Ativador

Consulte dom.canSetLinkHref().

dom.setLinkTarget()

Disponibilidade

Dreamweaver 3.

Descrição

Define um destino do link em torno da seleção atual. Esta função é equivalente a loop pelos pais e de avós do nó atual até um link seja encontrada e chamando osetAttribute('TARGET') na interface.

Argumentos

{linkTarget}

• O argumento opcional linkTarget é uma sequência de caracteres que representa o nome do quadro, o nome da janela ou um dos destinos reservados ("_self", "_parent", "_top" ou "_blank"). Se o argumento for omitido, a caixa de diálogo Definir destino será exibida.

Retorna

Nada.

dom.setListBoxKind()

Disponibilidade

Dreamweaver 3.

Descrição

Altera o tipo de menu SELECT selecionado.

Argumentos

kind

• O argumento kind deve ser "menu" ou "list box".

Retorna

Nada.

dom.showListPropertiesDialog()

Disponibilidade

Dreamweaver 3.

Descrição

Abre a caixa de diálogo Listar propriedades.

Argumentos

Nenhum.

Retorna

Nada.

Ativador

Consulte dom.canShowListPropertiesDialog().

dom.setListTag()

Disponibilidade

Dreamweaver 3.

Descrição

Define o estilo da lista selecionada.

Argumentos

listTag

• O argumentolistTag é a tag associada à lista. Deve ser "ol", "ul", "dl" ou uma sequência de caracteres vazia.

Retorna

Nada.

dom.setTextAlignment()

Disponibilidade

Dreamweaver 3.

Descrição

Define o atributo ALIGN do bloco que contém a seleção para o valor especificado.

Argumentos

alignValue

• O argumento alignValue deve ser "left", "center" ou "right".

Retorna

Nada.

dom.setTextFieldKind()

Disponibilidade

Dreamweaver 3 (obsoleto desde a Dreamweaver CS5.5)

Descrição

Define o formato do campo de texto selecionado.

Argumentos

fieldType

• O argumento fieldType deve ser "input", "textarea" ou "password".

Retorna

Nada.

dom.setTextFormat()

Disponibilidade

Dreamweaver 4.

Descrição

Define o formato de bloco do texto selecionado.

Argumentos

blockFormat

• O argumento blockFormat é uma sequência de caracteres que especifica um dos seguintes formatos: "" (para nenhuma formatação), "p", "h1", "h2", "h3", "h4", "h5", "h6" ou "pre".

Retorna

Nada.

dom.showFontColorDialog()

Disponibilidade

Dreamweaver 3.

Descrição

Abre a caixa de diálogo Seletor de cores.

Argumentos

Nenhum.

Retorna

Nada.

dreamweaver.deleteSelection()

Disponibilidade

Dreamweaver 3.

Descrição

Exclui a seleção no documento ativo ou no painel Site. No Macintosh, exclui a caixa de texto com foco em uma caixa de diálogo ou em um painel flutuante.

Argumentos

Nenhum.

Retorna

Nada.

Ativador

Consulte dreamweaver.canDeleteSelection().

dreamweaver.editFontList()

Disponibilidade

Dreamweaver 3.

Descrição

Abre a caixa de diálogo Editar lista de fontes.

Argumentos

Nenhum.

Retorna

Nada.

dreamweaver.getFontList()

Disponibilidade

Dreamweaver 3.

Descrição

Obtém uma lista de todos os grupos de fontes que aparecem no Inspetor de propriedades de texto e na caixa de diálogo Definição de estilo.

Argumentos

Nenhum.

Retorna

Uma matriz de sequências de caracteres que representam cada item na lista de fontes.

Exemplo

Para a instalação padrão do Dreamweaver, uma chamada para a função dreamweaver.getFontList() retorna uma matriz contendo os seguintes itens:

• "Arial, Helvetica, sans-serif"

• "Times New Roman, Times, serif"

• "Courier New, Courier, mono"

• "Georgia, Times New Roman, Times, serif"

• "Verdana, Arial, Helvetica, sans-serif"

dreamweaver.getFontStyles()

Disponibilidade

Dreamweaver 4.

Descrição

Retorna os estilos aceitos por uma fonte TrueType especificada.

Argumentos

fontName

• O argumento fontName é uma sequência de caracteres que contém o nome da fonte.

Retorna

Uma matriz de três valores boolianos que indica o que a fonte aceita. O primeiro valor indica se a fonte aceita negrito, o segundo indica se a fonte aceita itálico e o terceiro indica se a fonte aceita negrito e itálico.

dreamweaver.getKeyState()

Disponibilidade

Dreamweaver 3.

Descrição

Determina se a tecla modificadora específica é deprimida.

Argumentos

key

• O argumento key deve ser um dos seguintes valores: "Cmd", "Ctrl", "Alt" ou "Shift". No Windows, "Alt" e "Ctrl" referem-se à tecla Control. No Macintosh, "Cmd" refere-se à tecla Option.

Retorna

Um valor booliano que indica se a tecla está pressionada.

Exemplo

O seguinte código verifica se as teclas Shift e Control (Windows) ou as teclas Shift e Command (Macintosh) estão pressionadas antes de executar uma operação:

dreamweaver.getNaturalSize()

Disponibilidade

Dreamweaver 4.

Descrição

Retorna a largura e a altura de um objeto gráfico.

Argumentos

url

• O argumento url aponta para um objeto gráfico cujas dimensões desejamos saber. O Dreamweaver deve ter suporte a esse objeto (GIF, JPEG, PNG, Flash e Shockwave). O URL fornecido como argumento para a função getNaturalSize() deve ser um URL absoluto que aponta para um arquivo local; não pode ser um URL relativo.

Retorna

Uma matriz de dois números inteiros sendo que o primeiro número inteiro define a largura do objeto, enquanto o segunda define a altura.

dreamweaver.getSystemFontList()

Disponibilidade

Dreamweaver 4.

Descrição

Retorna uma lista de fontes do sistema. Esta função pode obter todas as fontes ou apenas as fontes TrueType.

Argumentos

fontTypes

• O argumento fontTypes é uma sequência de caracteres que contém o valor all ou o valor TrueType.

Retorna

Uma matriz de sequências de caracteres contendo os nomes de fontes inteiros; retornará um valor null se a origem for encontrada.

dreamweaver.getSystemFontName()

Disponibilidade

Dreamweaver CS5.

Descrição

Retorna o nome da fonte do sistema.

Argumentos

Nenhum.

Retorna

Uma sequência de caracteres contendo o nome da fonte do sistema.