Adicionar o controlo Editor de texto formatado a uma aplicação condicionada por modelo

O controlo de editor de texto formatado é um editor simples, baseado em HTML criado no popular CKEditor. Permite-lhe criar, colar e editar texto formatado nas suas aplicações condicionadas por modelo. Para formatar texto no editor, pode utilizar a barra de ferramentas do editor, inserir etiquetas de HTML ou colar texto formatado a partir de outras aplicações, como um browser ou o Word.

Pode personalizar o aspeto, a funcionalidade e o comportamento do editor. A experiência de texto moderno do controlo é mostrada na seguinte captura de ecrã.

Atualmente, o editor de texto formatado está disponível como duas experiências diferentes:

• Editor de texto moderno: nova experiência que pode ativar
• Editor de texto clássico: experiência predefinida

Melhorias do editor de texto moderno

O editor de texto moderno foi concebido para se alinhar com as interfaces familiares e intuitivas de aplicações Microsoft como o Outlook, Word e OneNote. Esta atualização introduz um design moderno, modo escuro, temas de alto contraste e uma nova funcionalidade do Copilot para melhorar as suas capacidades de edição de texto.

Nota

Algumas funcionalidades que estão disponíveis na experiência clássica de editor de texto formatado ainda não estão disponíveis na experiência moderna. Essas funcionalidades incluem:

• Opções de configuração, conforme descrito neste artigo para a experiência clássica
• Menções

Ativar a experiência de editor de texto formatado moderno

A experiência clássica de editor de texto formatado está ativada por predefinição. Conclua os seguintes passos para mudar para a experiência de editor de texto formatado moderno.

1. No Dynamics 365, clique com o botão direito do rato na aplicação para a qual pretende ativar a experiência de editor de texto formatado moderno e, em seguida, selecione ABRIR NO ESTRUTURADOR DE APLICAÇÕES. O Power Apps abre o estruturador de aplicações.
2. Na barra de comandos, selecione Definições. É apresentada a página Definições.
3. No painel esquerdo, em Definições, selecione Funcionalidades. É apresentada a página Funcionalidades.
4. Defina a alternância para Sim para qualquer uma ou todas as seguintes opções, dependendo das suas necessidades:
   • Ativar uma experiência de controlo RichTextEditor moderna e descrições de e-mail: ativa a experiência do controlo do editor de texto formatado moderno para descrições de e-mail. Esta definição substitui quaisquer personalizações que tenha feito anteriormente na experiência de e-mail clássica (predefinida) do editor de texto formatado.
   • Ativar uma experiência de controlo RichTextEditor moderna para controlos predefinidos: ativa a experiência de editor de texto formatado moderno para instâncias predefinidas, não configuradas.
   • Ativar uma experiência de controlo RichTextEditor moderna para a criação de notas: ativa a experiência do editor de texto formatado moderno para notas. Esta definição substitui quaisquer personalizações que tenha feito anteriormente na experiência de criação de notas (predefinida) do editor de texto formatado.
5. Selecione Guardar.
6. No Estruturador de Aplicações, selecione Publicar.

Reverter da experiência moderna de editor de texto formatado para a experiência clássica

Se precisar de reverter para a experiência clássica de editor de texto formatado, siga os mesmos passos em Ativar a experiência de editor de texto formatado moderno, mas desmarque as opções selecionadas no Passo 4.

Adicionar o controlo do editor de texto formatado a uma coluna de texto

A configuração que se segue está disponível na experiência clássica de editor de texto formatado.

Quando formatar uma coluna de texto como texto formatado, o controlo predefinido do editor de texto formatado é adicionado automaticamente.

1. Iniciar sessão no Power Apps.

2. No painel de navegação esquerdo, selecione Soluções.

3. Abra uma solução e uma tabela na solução.

4. Na área Colunas e dados , selecione uma coluna de texto.

   Se a tabela não contém uma coluna de texto, selecione + (Nova coluna) e introduza um nome para a coluna.

5. Em Tipo de dados, selecione > à direita de Texto e, em seguida, selecione a opção Texto formatado apropriada, com base se a coluna contém uma linha de texto única ou várias linhas.

6. Guarde a coluna e, em seguida, adicione-a a um formulário.

Adicionar o controlo de editor de texto formatado a uma coluna de texto num formulário

A configuração que se segue está disponível na experiência clássica de editor de texto formatado.

1. Inicie sessão no Power Apps.

2. No painel de navegação esquerdo, selecione Soluções.

3. Abra uma solução e uma tabela na solução.

4. Na área Experiências de dados , selecione Formulários e, em seguida, localize o formulário que contém a coluna de texto à que pretende adicionar o editor de texto formatado.

5. Selecione ⋮ > Editar > Editar no novo separador.

6. Na tela do estruturador de formulários, selecione, adicione ou crie uma coluna de texto.

7. No painel de propriedades da coluna, expanda a lista Componentes, selecione + Componente e, em seguida, selecione Controlo de Editor de Texto Formatado.

8. No painel Adicionar Controlo de Editor de Texto Formatado, selecione Web, Telefone e Tablet para permitir a execução de aplicações em qualquer dispositivo para utilizar o editor.

   Se pretender personalizar o editor, introduza o URL relativo do seu ficheiro de configuração, um recurso web JavaScript que contém as propriedades que pretende alterar, na caixa Valor estático. Se deixar este campo vazio, o editor utiliza a sua configuração predefinida.

9. Selecionar Concluído.

10. Selecione Guardar e publicar para aplicar as suas alterações ao formulário.

Personalizar o controlo de editor de texto formatado

As personalizações que se seguem estão disponíveis na experiência clássica de editor de texto formatado.

O Power Apps permite-lhe alterar as propriedades do controlo de editor de texto formatado para personalizar o aspeto, funcionalidades e comportamento do mesmo. Para personalizar uma instância específica do controlo, especifique as propriedades e os respetivos valores num ficheiro de configuração JSON individual. Para personalizar a configuração global do controlo, altere as propriedades no ficheiro de configuração predefinido.

Níveis de personalização

Podem ser aplicados até três níveis ou camadas de configuração ao editor de texto formatado:

1. No nível mais fundamental, cada instância do controlo tira a sua configuração do ficheiro RTEGlobalConfiguration_Readonly.json. O ficheiro é só de leitura, pelo que não pode alterar estas propriedades diretamente.
2. No nível seguinte, todas as instâncias do controlo retiram a sua configuração a partir das propriedades no ficheiro RTEGlobalConfiguration.json, se for possível. Esta configuração é colocada como camada sobre a anterior, pelo que as propriedades neste ficheiro substituem as propriedades com o mesmo nome no ficheiro só de leitura.
3. Por fim, ao nível mais alto, uma instância específica do controlo tira a sua configuração de um ficheiro de configuração específico, se existir um. Esta configuração é colocada como camada sobre a anterior, pelo que as propriedades neste ficheiro substituem as propriedades com o mesmo nome nos dois ficheiros de nível mais baixo.

Temos de adicionar aqui uma ligeira qualificação. Nem todas as propriedades são substituídas por aquelas numa configuração de nível superior. As propriedades extraPlugins são fundidas para permitir a utilização de uma vasta gama de plug-ins externos e de configuração inicial na configuração predefinida. Isto permite-lhe ativar e desativar os plug-ins conforme necessário no ficheiro de configuração para instâncias específicas do controlo.

Personalizar uma instância específica do editor de texto formatado

1. No Visual Studio Code ou outro editor de texto, crie um ficheiro e dê-lhe um nome significativo.

   O ficheiro RTEGlobalConfiguration.json contém a configuração predefinida ou global do editor de texto formatado. Se estiver a personalizar o controlo num formulário de contacto, por exemplo, poderá dar um nome a esse ficheiro como RTEContactFormConfiguration.json.

2. Copie e cole o seguinte fragmento de código no ficheiro:

   {
   "defaultSupportedProps": {
     "propertyName": "value",
     "propertyName": "value",
     "propertyName": "value"
   },
   }
   

   O último par propertyName:value não termina com uma vírgula.

3. Substitua propertyName e value pelas propriedades de controlo de editor de texto formatado que pretende alterar. Os valores das cadeias têm de estar entre aspas.

   Fornecemos algumas configurações de exemplo para si, mas pode definir outras que se adequem às suas necessidades.

4. No Power Apps, crie um recurso web do tipo JavaScript (JS) utilizando o ficheiro JSON que criou no passo 1.

5. Adicione o controlo de editor de texto formatado a uma coluna de texto num formulário e no painel Adicionar Controlo de Editor de Texto Formatado > Valor estático, introduza o URL relativo do recurso web do JavaScript.

   Embora seja possível introduzir o URL absoluto do recurso web, recomendamos que introduza o URL relativo. Dessa forma, o recurso web continua a funcionar se o importar como solução para outro ambiente, desde que o caminho relativo seja o mesmo.

   Por exemplo, se o URL do recurso web for https://yourorg.crm.dynamics.com/WebResources/rtecontactform, o URL relativo é /WebResources/rtecontactform.

6. Selecionar Concluído.

7. Selecione Guardar e publicar para aplicar as suas alterações ao formulário.

Personalizar o editor de texto formatado globalmente

O ficheiro de configuração global editável RTEGlobalConfiguration.json é o segundo nível de personalização que pode aplicar. Por predefinição, o ficheiro está vazio. Isto significa que todas as instâncias do editor de texto formatado utilizam as propriedades no ficheiro só de leitura RTEGlobalConfiguration_Readonly.json, a menos que crie um ficheiro de configuração para uma instância específica do controlo.

Se a sua empresa precisar de personalizar o controlo em todos os locais, especifique os valores de que necessita no ficheiro RTEGlobalConfiguration.json. Utilize o ficheiro só de leitura como exemplo para se certificar de que introduz pares de propriedade-valor no formato correto.

Utilizar o Copilot para aperfeiçoar o texto no editor

O Copilot utiliza algoritmos de processamento de linguagem natural para ajudar a melhorar o conteúdo escrito. Pode adicionar o Copilot ao editor de texto formatado e, em seguida, obter sugestões para melhorar a gramática, a clareza ou a qualidade global do texto. Aprenda a utilizar o Copilot no editor de texto formatado.

Propriedades do editor de texto formatado

O ficheiro JSON que determina a aparência de uma instância do editor de texto formatado contém dois conjuntos de propriedades:

• A secção defaultSupportedProps contém propriedades de plug-ins que determinam o que o controlo pode fazer. Não fica limitado às propriedades do CKEditor e dos seus plug-ins. Também pode definir valores para propriedades de plug-ins que adiciona ou cria.
• A secção de propriedades individual contém propriedades que determinam o aspeto do controlo.

Exemplo de ficheiro de configuração

O código seguinte é um exemplo de um ficheiro JSON que contém propriedades defaultSupportedProps e propriedades de configuração individual. Se uma propriedade tiver um valor predefinido, é apresentado o valor predefinido. Se uma propriedade não tiver um valor predefinido, é apresentado um valor de exemplo para ilustrar a sintaxe. As propriedades estão descritas nas duas tabelas seguintes.

"defaultSupportedProps": {
  "height": 185,
  "stickyStyle": {
    "font-size": "9pt",
    "font-family": "'Segoe UI','Helvetica Neue',sans-serif"
  },
  "stickyStyles_defaultTag": "div",
  "font_defaultLabel": "Segoe UI",
  "fontSize_defaultLabel": "9",
  "toolbarLocation": "bottom",
  "toolbar": [
  [ "CopyFormatting" ],
  [ "Font" ],
  [ "FontSize" ],
  [ "Bold" ],
  [ "Italic" ],
  [ "Underline" ],
  [ "BGColor" ],
  [ "TextColor" ],
  [ "BulletedList" ],
  [ "NumberedList" ],
  [ "Outdent" ],
  [ "Indent" ],
  [ "Blockquote" ],
  [ "JustifyLeft" ],
  [ "JustifyCenter" ],
  [ "JustifyRight" ],
  [ "Link" ],
  [ "Unlink" ],
  [ "Subscript" ],
  [ "Superscript" ],
  [ "Strike" ],
  [ "Image" ],
  [ "BidiLtr" ],
  [ "BidiRtl" ],
  [ "Undo" ],
  [ "Redo" ],
  [ "RemoveFormat" ],
  [ "Table" ]
 ],
  "plugins": [["button,toolbar,dialogui,dialog,autogrow,notification,clipboard,textmatch,fakeobjects,link,autolink,basicstyles,bidi,blockquote,panelbutton,panel,floatpanel,colorbutton,colordialog,listblock,richcombo,menu,contextmenu,copyformatting,enterkey,entities,popup,find,floatingspace,font,format,htmlwriter,horizontalrule,indent,indentblock,indentlist,justify,lineutils,openlink,list,liststyle,maximize,undo,menubutton,notificationaggregator,xml,ajax,pastetools,pastefromword,pastetext,preview,table,quicktable,removeformat,resize,selectall,showborders,sourcearea,specialchar,stylescombo,tab,tabletools,tableresize,tableselection,widgetselection,widget,wysiwygarea,textwatcher"]],
  "extraPlugins": "accessibilityhelp,autogrow,autolink,basicstyles,bidi,blockquote,button,collapser,colorbutton,colordialog,confighelper,contextmenu,copyformatting,dialog,editorplaceholder,filebrowser,filetools,find,floatpanel,font,iframerestrictor,indentblock,justify,notification,panel,panelbutton,pastefromword,quicktable,selectall,stickystyles,superimage,tableresize,tableselection,tabletools,uploadfile,uploadimage,uploadwidget",
  "removePlugins": "a11yhelp,codemirror,magicline,scayt,showborders",
  "superimageImageMaxSize": 5,
  "disallowedContent": "form[action]; *[formaction]; script; *[on*]",
  "linkTargets": ["notSet", "_blank"],
},
"attachmentEntity": {
  "name": "msdyn_richtextfiles",
  "fileAttributeName": "msdyn_fileblob"
},
"disableContentSanitization": true,
"disableDefaultImageProcessing": false,
"disableImages": false,
"externalPlugins": [
  {
    "name": "EmbedMedia",
    "path": "/WebResources/msdyncrm_/myplugins/embedmedia/"
  }
],
"imageEntity": {
  "imageEntityName": "msdyn_richtextfiles",
  "imageFileAttributeName": "msdyn_imageblob"
},
"readOnlySettings": {
  "height": 500,
  "showFullScreenExpander": true
},
"sanitizerAllowlist": {
  "attributes": [],
  "cssProperties": [],
  "domains": [],
  "protocols": [],
  "tags": []
},
"showAsTabControl": false,
"showFullScreenExpander": false,
"showHtml": false,
"showPreview": false,
"showPreviewHeaderWarning": false,
"allowSameOriginSandbox": false

defaultSupportedProps

A tabela seguinte descreve as propriedades mais utilizadas, mas pode configurar todas as propriedades que o CKEditor suporta. O controlo de editor de texto formatado utiliza o CKEditor 4.

Property	Descrição	Default value
altura	Define a altura inicial da área de conteúdo, em pixeis.	"185"
stickyStyle	Define o tipo de letra e tamanho do editor.	Ver defaultSupportedProps
stickyStyles_defaultTag	Cria um wrapper à volta do texto na área de conteúdo do editor. Está inicialmente definido como "div", mas pode alterá-lo para "p" ou qualquer etiqueta alternativa.	"div"
font_defaultLabel	Define a etiqueta de tipo de letra apresentada na barra de ferramentas. A etiqueta só tem aspeto e não é funcional. A propriedade stickyStyle determina o tipo de letra e tamanho do editor.	"Segoe UI"
fontSize_defaultLabel	Define a etiqueta do tamanho de tipo de letra apresentada na barra de ferramentas. A etiqueta só tem aspeto e não é funcional. A propriedade stickyStyle determina o tipo de letra e tamanho do editor.	"9"
toolbarLocation	Define a localização da barra de ferramentas na área de conteúdo do editor. Os valores suportados são "superior" e "inferior".	"inferior"
barra de ferramentas	Lista os botões da barra de ferramentas a apresentar.	Ver defaultSupportedProps
plug-ins	Listas de plug-ins predefinidos que o editor pode utilizar. Os plug-ins nesta lista poderão ser diferentes dos plug-ins carregados, se for atribuído um valor a extraPlugins e removePlugins. Se definir esta propriedade para uma cadeia vazia, o editor é carregado sem a barra de ferramentas.	Ver defaultSupportedProps
extraPlugins	Anexa plug-ins à lista plugins para carregar mais plug-ins. Muitos plug-ins requerem outros plug-ins para funcionarem. O editor de texto formatado adiciona-os automaticamente e não pode utilizar esta propriedade para os definir manualmente. Utilize removePlugins em substituição.	Ver defaultSupportedProps
removePlugins	Listas de plug-ins a não carregar. Utilize-o para alterar os plug-ins que são carregados sem alterar as listas de plugins e extraPlugins.	Ver defaultSupportedProps
superimageImageMaxSize	Define o tamanho máximo em megabytes (MB) permitido para imagens incorporadas ao utilizar o plug-in superimage.	"5"
disallowedContent	Permite-lhe prevenir os utilizadores de introduzirem elementos que não pretende no seu conteúdo. É possível não permitir elementos completos ou por atributos, classes e estilos.	Ver defaultSupportedProps
linkTargets	Permite-lhe configurar que opções de destino da ligação estão disponíveis para os utilizadores quando criarem ligações: - "notSet": sem destino definido - "frame": abre o documento no intervalo especificado - popupWindow": abre o documento numa janela de pop-up - "_blank": abre o documento numa nova janela ou separador - "_top": abre o documento no corpo completo da janela - "_self": abre o documento na mesma janela ou separador em que a ligação está ativada - "_parent": abre o documento no intervalo principal	"notSet", "_blank"

Propriedades individuais

A tabela seguinte descreve mais propriedades que pode utilizar para personalizar o controlo de editor de texto formatado.

Property	Descrição	Default value
attachmentEntity	Para impor mais segurança em ficheiros carregados ao utilizar uma tabela que não a predefinida, defina esta propriedade e especifique uma tabela diferente. Sintaxe: "name": "tableName", "fileAttributeName": "attributeNameofBlobReference"	Ver defaultSupportedProps
disableContentSanitization	A limpeza de conteúdo remove algumas das etiquetas ou atributos personalizados a partir de conteúdo de texto formatado. Está desativada por predefinição para permitir a cópia e a colagem de conteúdo de texto formatado proveniente de origens externas. Esta propriedade aplica-se apenas ao modo de edição. Quando o controlo do editor é só de leitura ou está desativado, o conteúdo é sempre limpo.	verdadeiro
disableDefaultImageProcessing	Por predefinição, as imagens inseridas no editor são carregadas para o attachmentEntity definido na configuração. Os utilizadores externos podem não ter privilégios para ver o conteúdo na tabela. Em vez disso, defina esta propriedade como verdadeira para armazenar imagens como cadeias base64 diretamente na coluna configurada para utilizar o controlo do editor de texto formatado.	false
disableImages	Determina se as imagens podem ser introduzidas no editor. Esta propriedade tem a prioridade máxima. Quando esta propriedade está definida como verdadeira, as imagens são desativadas, independentemente do valor da propriedade imageEntity.	false
externalPlugins	Lista de plug-ins externos ou plug-ins que cria e que podem ser utilizados no controlo do editor de texto formatado. Sintaxe: "name": "pluginName", "path": "pathToPlugin" (o valor do caminho pode ser um URL absoluto ou relativo)	Nenhum; consulte defaultSupportedProps como exemplo
imageEntity	Para impor mais segurança em imagens ao utilizar uma tabela que não a predefinida, defina esta propriedade e especifique uma tabela diferente. Sintaxe: "imageEntityName": "tableName", "imageFileAttributeName": "attributeNameofBlobReference"	Ver defaultSupportedProps
readOnlySettings	Estas propriedades determinam o comportamento da coluna quando visualizada num estado só de leitura ou desativado. Pode especificar qualquer propriedade suportada.	Nenhum; consulte defaultSupportedProps como exemplo
sanitizerAllowlist	Lista outros tipos de conteúdo que podem ser apresentados no editor.	Ver defaultSupportedProps
showAsTabControl	Permite-lhe apresentar mais comandos acima da área de conteúdo. Deve ser definido como verdadeiro para utilizar as seguintes propriedades: showFullScreenExpander, showHtml, showPreview, showPreviewHeaderWarning	false
showFullScreenExpander	Determina se o editor pode ser utilizado em modo de ecrã inteiro. showAsTabControl tem de ser definido como verdadeiro.	false
showHtml	Permite que os utilizadores apresentem e editem o conteúdo HTML diretamente. showAsTabControl tem de ser definido como verdadeiro.	false
showPreview	Permite que os utilizadores pré-visualizem o conteúdo do editor como HTML. showAsTabControl tem de ser definido como verdadeiro.	false
showPreviewHeaderWarning	Permite-lhe mostrar ou ocultar a mensagem de aviso que é exibida ao visualizar o conteúdo. showAsTabControl e showPreview têm de ser definidos como verdadeiro.	false
allowSameOriginSandbox	Permite que o conteúdo no editor seja tratado como da mesma origem que a aplicação de composição. Utilize esta propriedade com atenção. Utilize apenas conteúdo externo fidedigno. Quando esta propriedade está definida como verdadeira, qualquer conteúdo externo poderá ter acesso aos recursos internos.	false

Configurações de exemplo

As seguintes configurações de exemplo criam personalizações específicas do editor de texto formatado na experiência clássica. Pode utilizá-los como estão ou como um ponto de mudança para personalizar uma instância específica do editor de texto formatado ou globalmente.

Definir o tipo de letra predefinido como Calibri de 11 pontos

Defina estas propriedade defaultSupportedProps no seu ficheiro de configuração. Cada valor, exceto o último, deve ser seguido por uma vírgula (,).

"font_defaultLabel": "Calibri",
"fontSize_defaultLabel": "11",
"stickyStyle": {
  "font-size": "11pt",
  "font-family": "Calibri/Calibri, Helvetica, sans-serif;"
},

Fazer com que a tecla Enter introduza uma nova linha em vez de um bloco de parágrafo

Por predefinição, a tecla Enter cria um bloco de parágrafo com a etiqueta HTML <p>. O HTML utiliza blocos de parágrafo para agrupar informações, tal como parágrafos num documento do Word. Os browsers podem formatar a <p> etiqueta de forma ligeiramente diferente, pelo que, para consistência visual, poderá querer utilizar a nova etiqueta de linha ou de quebra de linha <br\>.

Defina esta propriedade defaultSupportedProps no seu ficheiro de configuração. Siga este valor com uma vírgula (,) a menos que seja a última propriedade do ficheiro.

"enterMode": 2,

Colar ou criar conteúdo de HTML 5 apenas

Apresar de o controlo de editor de texto formatado funcionar melhor com conteúdo HTML 5, pode utilizar as etiquetas de HTML 4. No entanto, em alguns casos, a combinação de etiquetas de HTML 4 e HTML 5 pode criar desafios de usabilidade. Para se certificar de que todo o conteúdo é HTML 5, forneça todas as etiquetas de HTML 5 suportadas na propriedade allowedContent. O controlo de editor converte quaisquer etiquetas não conformes para o seu equivalente de HTML 5.

Defina esta propriedade defaultSupportedProps no seu ficheiro de configuração. Siga este valor com uma vírgula (,) a menos que seja a última propriedade do ficheiro.

"allowedContent": "a(*)[*]{*};abbr(*)[*]{*};address(*)[*]{*};area(*)[*]{*};article(*)[*]{*};aside(*)[*]{*};audio(*)[*]{*};b(*)[*]{*};base(*)[*]{*};bdi(*)[*]{*};bdo(*)[*]{*};blockquote(*)[*]{*};body(*)[*]{*};br(*)[*]{*};button(*)[*]{*};canvas(*)[*]{*};caption(*)[*]{*};cite(*)[*]{*};code(*)[*]{*};col(*)[*]{*};colgroup(*)[*]{*};data(*)[*]{*};datalist(*)[*]{*};dd(*)[*]{*};del(*)[*]{*};details(*)[*]{*};dfn(*)[*]{*};dialog(*)[*]{*};div(*)[*]{*};dl(*)[*]{*};dt(*)[*]{*};em(*)[*]{*};embed(*)[*]{*};fieldset(*)[*]{*};figcaption(*)[*]{*};figure(*)[*]{*};footer(*)[*]{*};form(*)[*]{*};h1(*)[*]{*};h2(*)[*]{*};h3(*)[*]{*};h4(*)[*]{*};h5(*)[*]{*};h6(*)[*]{*};head(*)[*]{*};header(*)[*]{*};hr(*)[*]{*};html(*)[*]{*};i(*)[*]{*};iframe(*)[*]{*};img(*)[*]{*};input(*)[*]{*};ins(*)[*]{*};kbd(*)[*]{*};label(*)[*]{*};legend(*)[*]{*};li(*)[*]{*};link(*)[*]{*};main(*)[*]{*};map(*)[*]{*};mark(*)[*]{*};meta(*)[*]{*};meter(*)[*]{*};nav(*)[*]{*};noscript(*)[*]{*};object(*)[*]{*};ol(*)[*]{*};optgroup(*)[*]{*};option(*)[*]{*};output(*)[*]{*};p(*)[*]{*};param(*)[*]{*};picture(*)[*]{*};pre(*)[*]{*};progress(*)[*]{*};q(*)[*]{*};rp(*)[*]{*};rt(*)[*]{*};ruby(*)[*]{*};s(*)[*]{*};samp(*)[*]{*};section(*)[*]{*};select(*)[*]{*};small(*)[*]{*};source(*)[*]{*};span(*)[*]{*};strong(*)[*]{*};style(*)[*]{*};sub(*)[*]{*};summary(*)[*]{*};sup(*)[*]{*};svg(*)[*]{*};table(*)[*]{*};tbody(*)[*]{*};td(*)[*]{*};template(*)[*]{*};textarea(*)[*]{*};tfoot(*)[*]{*};th(*)[*]{*};thead(*)[*]{*};time(*)[*]{*};title(*)[*]{*};tr(*)[*]{*};track(*)[*]{*};u(*)[*]{*};ul(*)[*]{*};var(*)[*]{*};video(*)[*]{*};wbr(*)[*]{*};",

Colar ou criar apenas texto simples

Defina estas propriedade defaultSupportedProps no seu ficheiro de configuração. Cada valor, exceto o último, deve ser seguido por uma vírgula (,).

"enterMode": 2,
"shiftEnterMode": 2,
"allowedContent": "*",
"disallowedContent": "*",
"forcePasteAsPlainText": true,
"toolbar": [],
"removePlugins": "contextmenu,liststyle,openlink,tableresize,tableselection,tabletools",

Defina esta propriedade individual no seu ficheiro de configuração. Siga este valor com uma vírgula (,) a menos que seja a última propriedade do ficheiro.

"disableImages": true,

Permitir que o editor utilize o ecrã inteiro

Defina estas propriedades individuais no seu ficheiro de configuração. Cada valor, exceto o último, deve ser seguido por uma vírgula (,).

"showAsTabControl": true,
"showFullScreenExpander": true,

Permitir a visualização e edição de conteúdos HTML

Para permitir que os utilizadores vejam e editem o HTML do seu conteúdo diretamente, mostre o separador HTML .

Defina estas propriedades individuais no seu ficheiro de configuração. Cada valor, exceto o último, deve ser seguido por uma vírgula (,).

"showAsTabControl": true,
"showHtml": true,

Mostrar uma barra de ferramentas simplificada ou removê-la totalmente

Por predefinição, a barra de ferramentas do editor contém todas as ferramentas de formatação disponíveis. Para fornecer uma barra de ferramentas simplificada, utilize a propriedade toolbar e especifique as ferramentas que os utilizadores podem utilizar para formatar o respetivo conteúdo.

Defina esta propriedade defaultSupportedProps no seu ficheiro de configuração. Siga este valor com uma vírgula (,) a menos que seja a última propriedade do ficheiro.

"toolbar": [ { "items": [ "FontSize", "Bold", "Italic", "Underline", "BGColor" ] } ],

Para remover totalmente a barra de ferramentas, definira o valor de toolbar como '[]' (dois parêntesis retos).

Adicionar uma nova lista de tipos de letra e definir Brush Script MT de 20 pixeis como o tipo de letra predefinido

Defina estas propriedade defaultSupportedProps no seu ficheiro de configuração. Cada valor, exceto o último, deve ser seguido por uma vírgula (,).

"font_names": "Brush Script MT/'Brush Script MT', cursive;Calibri/Calibri, Helvetica, sans-serif;Calibri Light/'Calibri Light', 'Helvetica Light', sans-serif;"
"font_defaultLabel": "Brush Script MT"
"fontSize_sizes": "8/8px;12/12px;20/20px;32/32px"
"fontSize_defaultLabel": "20"
"stickyStyle": {
  "font-size": "20px",
  "font-family": "'Brush Script MT', cursive"
},

Posicione a barra de ferramentas no topo do editor de texto formatado

Defina esta propriedade defaultSupportedProps no seu ficheiro de configuração. Siga este valor com uma vírgula (,) a menos que seja a última propriedade do ficheiro.

"toolbarLocation": "top",

Iniciar o editor a 30 pixeis de altura e aumentar para se ajustar ao conteúdo

Defina estas propriedade defaultSupportedProps no seu ficheiro de configuração. Cada valor, exceto o último, deve ser seguido por uma vírgula (,).

"autoGrow_onStartup": false,
"autoGrow_maxHeight": 0,
"autoGrow_minHeight": 30,
"height": 30,

Fixar a altura do editor para 500 pixeis

Defina estas propriedade defaultSupportedProps no seu ficheiro de configuração. Cada valor, exceto o último, deve ser seguido por uma vírgula (,).

"removePlugins": [ "autogrow" ],
"height": 500,

Fazer com que o menu de contexto (clique com o botão direito do rato) utilize o menu de contexto predefinido do browser

Para substituir o menu de contexto do controlo de editor pelo menu de contexto predefinido do browser, remova o plug-in contextmenu.

Defina esta propriedade defaultSupportedProps no seu ficheiro de configuração. Siga este valor com uma vírgula (,) a menos que seja a última propriedade do ficheiro.

"removePlugins": "contextmenu,liststyle,openlink,tableresize,tableselection,tabletools",

Localizar a configuração de um controlo de editor de texto formatado

Se não tiver a certeza de onde vem a configuração de uma instância do editor de texto formatado, poderá encontrá-la utilizando as ferramentas de programação do browser.

1. No Microsoft Edge ou Google Chrome, execute a sua aplicação condicionada por modelo e abra um formulário que tem o controlo de editor de texto formatado.
2. Clique com o botão direito do rato na área de conteúdo de editor de texto formatado e selecione Inspecionar.
3. No painel de inspeção, selecione o separador Consola.
4. Selecione a página principal Main.aspx na caixa de lista da barra de comandos.

1. Selecione o ícone Limpar consola na barra de comandos do painel de inspeção e, em seguida, introduza CKEDITOR.config. na consola.

1. Na consola do painel de inspeção, insira CKEDITOR.config. para apresentar as diferentes configurações.

1. Selecione uma configuração, como autoGrow_minHeight, para visualizar a definição atual.

A barra de ferramentas do editor de texto formatado

A tabela seguinte descreve as ferramentas de formatação disponíveis no editor de texto formatado por predefinição.

Icon	Nome	Atalho de teclado	Descrição
	Copiar Formatação	Ctrl+Shift+C, Ctrl+Shift+V	Aplicar a aparência de uma secção específica a outra secção.
	Nome do Tipo de Letra	Ctrl+Shift+F	Selecione um tipo de letra. A aplicação considera o tipo de letra que selecionou como tipo de letra predefinido. Segoe UI é o tipo de letra predefinido, se não selecionar um. Quando seleciona qualquer conteúdo formatado, é apresentado o nome do tipo de letra aplicado ao mesmo. Se a seleção contiver vários tipos de letras, é apresentado o primeiro aplicado à seleção.
	Tamanho do Tipo de Letra	Ctrl+Shift+P	Altere o tamanho do seu texto. A aplicação considera o tamanho do tipo de letra que selecionou como tamanho predefinido. 12 é o tamanho predefinido, se não selecionar um. Quando seleciona conteúdo formatado, é apresentado o tamanho do tipo de letra aplicado ao mesmo. Se a seleção contiver vários tamanhos, é apresentado o primeiro aplicado à seleção.
	Negrito	Ctrl+N	Coloque o texto em negrito.
	Italic	Ctrl+I	Coloque o texto em itálico.
	Sublinhado	Ctrl+S	Coloque o texto em sublinhado.
	Cor de Fundo		Para destacar o texto, realce-o com uma cor brilhante.
	Cor do Texto		Altere a cor do seu texto.
	Inserir/Remover Lista com Marcas		Crie uma lista com marcas.
	Inserir/Remover Lista Numerada		Crie uma lista numerada.
	Diminuir Avanço		Mova o parágrafo para mais perto da margem.
	Aumentar Avanço		Afaste o parágrafo da margem.
	Trecho em Bloco		Aplique um formato de cotação a nível de bloco ao seu conteúdo.
	Alinhar à Esquerda	Ctrl+L	Alinhe o conteúdo com a margem esquerda.
	Alinhar ao Centro	Ctrl+E	Centre o conteúdo na página.
	Alinhar à Direita	Ctrl+R	Alinhe o seu conteúdo com a margem direita.
	Associar		Crie uma ligação no documento para aceder rapidamente a páginas web e outros recursos da cloud. Introduza ou cole o texto de ancoragem na caixa Apresentar Texto e, em seguida, introduza ou cole o URL na caixa URL. Opcionalmente, selecione um Tipo de Ligação e um protocolo se a ligação for para algo diferente de uma página web. Para especificar onde uma ligação do tipo URL deve ser aberta, selecione o separador Destino e, em seguida, selecione um Destino. Um URL colado ou digitado é automaticamente convertido numa ligação. Por exemplo, http://myexample.com passa a <a href="http://myexample.com">http://myexample.com</a>.
	Desassociar		Remova a ligação de uma âncora e torne-a em texto simples.
	Superior à Linha		Escreva letras pequenas logo acima da linha de texto.
	Inferior à Linha		Escreva letras pequenas logo abaixo da linha de texto.
	Rasurado		Rasure o texto desenhando uma linha através dele.
	Image		Para introduzir uma imagem, cole-a a partir da área de transferência na área de conteúdo ou arraste um ficheiro de imagem de uma pasta para a área de conteúdo. Arraste qualquer canto da imagem para a redimensionar. O controlo suporta imagens .png, .jpg. e .gif. Para ter mais controlo sobre a origem, aspeto e comportamento da imagem, selecione o botão Imagem. Procure o ficheiro de imagem numa pasta local ou introduza o seu URL. Se a imagem estiver armazenada num servidor externo, introduza o caminho absoluto. Se estiver num servidor local, pode introduzir um caminho relativo. Opcionalmente, introduza uma altura e largura específicas para redimensionar a imagem e selecionar um alinhamento. Também deve introduzir texto alternativo para descrever a imagem para as pessoas que utilizam leitores de ecrã. Se a imagem também for uma ligação a uma página web ou a outro recurso na cloud, introduza o URL do recurso na caixa URL de Destino e, se necessário, selecione o Destino onde a ligação deve ser aberta.
	Orientação do texto da esquerda para a direita		Altere o texto da esquerda para a direita. Esta é a predefinição.
	Orientação do texto da direita para a esquerda		Altere o texto para da direita para a esquerda para conteúdo de idioma bidirecional.
	Anular		Inverter a última alteração que e fez ao conteúdo.
	Refazer		Anular a última anulação ou voltar a aplicar a última alteração que fez ao conteúdo.
	Remover Formato		Remover toda a formatação do texto selecionado.
	Table		Introduza uma tabela com o número de linhas e colunas que selecionou. Para ter mais controlo sobre o tamanho e aspeto da tabela, selecione o botão Tabela > Mais e altere as propriedades da tabela. Pode também clicar com o botão direito do rato numa tabela para ver e alterar as propriedades da tabela. Para alterar a largura de uma coluna, arraste o limite. Pode selecionar uma ou mais células, linhas ou colunas e aplicar a formatação específica e adicionar uma ligação ao texto selecionado e cortar, copiar e colar linhas ou colunas inteiras.
	Definições de Personalização		Predefina o tipo de letra e o tamanho do tipo de letra.
	Ajuda de Acessibilidade	Alt + 0	Abra a lista de atalhos de teclado que pode utilizar no editor de texto formatado.
	Expandir Barra de Ferramentas		Quando a janela for demasiado estreita para mostrar a barra de ferramentas completa, selecione para expandir a barra de ferramentas para uma segunda linha.

Gorjeta

Para utilizar a verificação de ortografia integrada do browser, prima a tecla Ctrl e clique com o botão direito do rato em simultâneo no texto que pretende verificar. Caso contrário, o menu de clique com o botão direito do rato (contexto) fornece formatação contextual para o elemento que selecionou.
Uma alternativa à verificação de ortografia incorporada do seu browser é a extensão de browser do Microsoft Editor. O Microsoft Editor funciona perfeitamente com o controlo de editor de texto formatado e, quando ativado, fornece capacidades de gramática e de verificação ortográfica rápidas e fáceis.

Utilizar o editor de texto formatado offline

O controlo de editor de texto formatado está disponível quando está a trabalhar offline, embora sem algumas das funcionalidades a que está habituado. As imagens que carrega utilizando a configuração predefinida do editor não estão disponíveis quando está a trabalhar offline.

Os seguintes plug-ins estão disponíveis para o editor de texto formatado enquanto está offline:

• ajax, autogrow, basicstyles, bidi, blockquote, button, confighelper, contextmenu, dialog, dialogui, editorplaceholder, enterkey, entities, fakeobjects, floatingspace, floatpanel, format, horizontalrule, htmlwriter, indent, indentblock, indentlist, justify, lineutils, list, listblock, maximize, menu, menubutton, notification, notificationaggregator, panel, panelbutton, popup, preview, removeformat, resize, richcombo, selectall, showborders, sourcearea, specialchar, stylescombo, tab, textmatch, textwatcher, toolbar, undo, widgetselection, wysiwygarea, xml

As seguintes ferramentas de formatação estão disponíveis no editor de texto formatado enquanto está offline:

• Negrito, itálico, sublinhado, listas com pontos e números, reduzir e aumentar avanço, trecho em bloco, alinhar à esquerda, alinhar ao centro, alinhar à direita, rasurar, texto bidirecional, anular e refazer, e remover formatação

Melhores práticas para usar o editor de texto formatado

• Os campos de texto formatado armazenam etiquetas HTML para formatação juntamente com os dados introduzidos pelo utilizador. Quando definir o tamanho máximo de campos de texto formatado, certifique-se de que permite tanto as etiquetas de HTML como os dados do utilizador.

• Para o melhor desempenho, mantenha o conteúdo HTML até 1 MB ou menos. Em tamanhos maiores, pode observar tempos de resposta mais lentos a carregar e editar.

• Na configuração predefinida, as imagens não afetam negativamente o desempenho porque são armazenadas separadamente do conteúdo HTML. No entanto, as imagens são armazenadas como conteúdo base64 na coluna de texto quando o utilizador que as carrega não tem permissões sobre a tabela msdyn_richtextfiles. O conteúdo base64 é grande, por isso geralmente não quer armazenar imagens como parte do conteúdo da coluna.

• Se tiver um direito de acesso de administrador de sistema ou utilizador básico, a funcionalidade de personalização do utilizador funciona por predefinição. Se não tiver estas funções, tem de ter privilégios para criar, ler e escrever na tabela msdyn_customcontrolextendedsettings para o plug-in de personalização do utilizador funcionar.

Perguntas mais frequentes

Por que motivo os carateres digitados são apresentados lentamente?

Se tiver muito conteúdo no editor, o tempo de resposta pode aumentar. Mantenha o conteúdo até 1 MB ou menos para o melhor desempenho. A verificações de ortografia gramática também podem atrasar o desempenho da datilografia.

Porque é que não consigo carregar uma imagem? Porque é que a pré-visualização de imagem não é carregada?

Se o nome do ficheiro de imagem, incluindo o caminho, for longo, é possível que o ficheiro não seja carregado ou a pré-visualização poderá não ser apresentada. Tente encurtar o nome do ficheiro ou mover o ficheiro para uma localização com um caminho mais curto e, em seguida, carregue-o novamente.

Porque é que estou a ver HTML no meu texto?

Se o controlo do editor de texto formatado for utilizado numa coluna que não seja formatada para texto formatado, o conteúdo aparece no HTML subjacente em vez de texto formatado.

Para resolver este problema, certifique-se de que o formato da coluna está definido como Texto Formatado.

Consultar também

• Criar e editar colunas para o Microsoft Dataverse utilizando o portal do Power Apps
• Utilizar o Copilot no editor de texto formatado para e-mail

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).