Edição avançada

Esta seção contém informações sobre os elementos de programação usados com controles rich edit. Um controle de edição avançada permite que o usuário insira, edite, imprima e salve texto. O texto pode receber formatação de caractere e parágrafo e pode incluir objetos COM (Component Object Model) incorporados.

Como os controles de edição avançada oferecem suporte a quase todas as mensagens e códigos de notificação usados com controles de edição de várias linhas , os aplicativos que já usam controles de edição podem ser facilmente alterados para usar controles de edição avançada.

Visões gerais

Tópico	Contents
Sobre controles de edição avançada	Esta seção apresenta controles de edição avançada.
Usando controles de edição avançada	Esta seção contém tópicos que demonstram como criar e usar controles de edição avançada.

Funções

Tópico	Contents
AutoCorrectProc	A função AutoCorrectProc é uma função de retorno de chamada definida pelo aplicativo usada com a mensagem EM_SETAUTOCORRECTPROC.
EditStreamCallback	A função EditStreamCallback é uma função de retorno de chamada definida pelo aplicativo usada com as mensagens EM_STREAMIN e EM_STREAMOUT. Ele é usado para transferir um fluxo de dados para dentro ou para fora de um controle de edição avançado.
EditWordBreakProcEx	A função EditWordBreakProcEx é uma função de retorno de chamada definida pelo aplicativo usada com a mensagem EM_SETWORDBREAKPROCEX. Ele determina o índice de caracteres da quebra de palavra ou a classe de caractere e os sinalizadores de quebra de palavra dos caracteres no texto especificado.
HifenatoProc	A função HyphenateProc é uma função de retorno de chamada definida pelo aplicativo usada com a mensagem EM_SETHYPHENATEINFO. Ele determina como a hifenização é feita em um controle Microsoft Rich Edit.

Interfaces

Tópico	Contents
IRichEditOle	A interface IRichEditOle expõe a funcionalidade COM de um controle de edição avançado. A interface pode ser obtida enviando a mensagem EM_GETOLEINTERFACE.
IRichEditOleCallback	A interface IRichEditOleCallback é usada por um controle de edição rich text para recuperar informações relacionadas ao OLE de seu cliente. Um cliente de controle de edição avançada é responsável por implementar essa interface e atribuí-la ao controle usando a mensagem EM_SETOLECALLBACK.

Mensagens

Tópico	Contents
EM_AUTOURLDETECT	Habilita ou desabilita a detecção automática de URLs por um controle de edição avançado.
EM_CANPASTE	Determina se um controle de edição avançada pode colar um formato de área de transferência especificado.
EM_CANREDO	Determina se há ações na fila de refazer controle.
EM_DISPLAYBAND	Exibe uma parte do conteúdo de um controle de edição avançada, conforme formatado anteriormente para um dispositivo usando a mensagem EM_FORMATRANGE.
EM_EXGETSEL	Recupera as posições de caracteres inicial e final da seleção em um controle de edição avançado.
EM_EXLIMITTEXT	Define um limite superior para a quantidade de texto que o usuário pode digitar ou colar em um controle de edição avançada.
EM_EXLINEFROMCHAR	Determina qual linha contém o caractere especificado em um controle de edição avançada.
EM_EXSETSEL	Seleciona um intervalo de caracteres ou objetos COM em um controle Rich Edit.
EM_FINDTEXT	Localiza texto em um controle de edição avançada.
EM_FINDTEXTEX	Localiza texto em um controle de edição avançada.
EM_FINDTEXTEXW	Localiza texto Unicode em um controle de edição avançada.
EM_FINDTEXTW	Localiza texto Unicode em um controle de edição avançada.
EM_FINDWORDBREAK	Localiza a próxima quebra de palavra antes ou depois da posição de caractere especificada ou recupera informações sobre o caractere nessa posição.
EM_FORMATRANGE	Formata um intervalo de texto em um controle de edição avançada para um dispositivo específico.
EM_GETAUTOURLDETECT	Indica se a detecção automática de URL está ativada no controle rich edit.
EM_GETBIDIOPTIONS	Indica o estado atual das opções bidirecionais no controle rich edit.
EM_GETCHARFORMAT	Determina a formatação de caracteres em um controle rich edit.
EM_GETCTFMODEBIAS	Obtém os valores de viés de modo TSF (Text Services Framework) para um controle Rich Edit.
EM_GETCTFOPENSTATUS	Determina se o teclado TSF está aberto ou fechado.
EM_GETEDITSTYLE	Recupera os sinalizadores de estilo de edição atuais.
EM_GETEVENTMASK	Recupera a máscara de evento para um controle de edição avançado. A máscara de evento especifica quais códigos de notificação o controle envia para sua janela pai.
EM_GETHYPHENATEINFO	Obtém informações sobre hifenização para um controle Rich Edit.
EM_GETIMECOLOR	Recupera a cor de composição do IME (Editor de Método de Entrada). Esta mensagem está disponível somente nas versões em idioma asiático do sistema operacional.
EM_GETIMECOMPMODE	Obtém o modo IME atual para um controle de edição avançado.
EM_GETIMECOMPTEXT	Obtém o texto de composição do IME.
EM_GETIMEMODEBIAS	Obtém o viés do modo IME para um controle Rich Edit.
EM_GETIMEOPTIONS	Recupera as opções atuais do IME. Esta mensagem está disponível somente nas versões em idioma asiático do sistema operacional.
EM_GETIMEPROPERTY	Obtém a propriedade e os recursos do IME associados à localidade de entrada atual.
EM_GETLANGOPTIONS	Obtém as configurações de opção de um controle de edição avançado para suporte a IME e idiomas asiáticos.
EM_GETOLEINTERFACE	Recupera um objeto IRichEditOle que um cliente pode usar para acessar a funcionalidade COM de um controle de edição avançada.
EM_GETOPTIONS	Recupera opções avançadas de controle de edição.
EM_GETPAGEROTATE	Preterido. Obtém o layout de texto para um controle Rich Edit.
EM_GETPARAFORMAT	Recupera a formatação de parágrafo da seleção atual em um controle de edição avançada.
EM_GETPUNCTUATION	Obtém os caracteres de pontuação atuais para o controle de edição avançada. Esta mensagem está disponível somente nas versões em idioma asiático do sistema operacional.
EM_GETREDONAME	Recupera o tipo da próxima ação, se houver, na fila de refazer do controle de edição avançada.
EM_GETSCROLLPOS	Obtém a posição de rolagem atual do controle de edição.
EM_GETSELTEXT	Recupera o texto selecionado atualmente em um controle de edição avançada.
EM_GETTEXTEX	Obtém todo o texto do controle de edição avançada em qualquer base de código específica desejada.
EM_GETTEXTLENGTHEX	Calcula o comprimento do texto de várias maneiras. Ele geralmente é chamado antes de criar um buffer para receber o texto do controle.
EM_GETTEXTMODE	Obtém o modo de texto atual e o nível de desfazer de um controle de edição avançada.
EM_GETTEXTRANGE	Recupera um intervalo especificado de caracteres de um controle de edição avançado.
EM_GETTYPOGRAPHYOPTIONS	Recupera o estado atual das opções de tipografia de um controle de edição avançada.
EM_GETUNDONAME	Microsoft Rich Edit 2.0 e posterior: recupera o tipo da próxima ação de desfazer, se houver. Microsoft Rich Edit 1.0: Esta mensagem não é suportada.
EM_GETWORDBREAKPROCEX	Recupera o endereço do procedimento de quebra de palavra estendido atualmente registrado.
EM_GETWORDWRAPMODE	Obtém as opções atuais de quebra automática de linha e quebra de palavra para o controle de edição avançado. Esta mensagem está disponível somente nas versões em idioma asiático do sistema operacional.
EM_GETZOOM	Obtém a taxa de zoom atual, que está sempre entre 1/64 e 64.
EM_HIDESELECTION	Oculta ou mostra a seleção em um controle de edição avançado.
EM_ISIME	Determina se a localidade de entrada atual é uma localidade do Leste Asiático.
EM_PASTESPECIAL	Cola um formato específico da área de transferência em um controle de edição avançada.
EM_RECONVERSION	Invoca a caixa de diálogo de reconversão do IME.
EM_REDO	Refaz a próxima ação na fila de restauração do controle.
EM_REQUESTRESIZE	Força um controle de edição avançado a enviar um código de notificação EN_REQUESTRESIZE para sua janela pai.
EM_SELECTIONTYPE	Determina o tipo de seleção para um controle de edição avançada.
EM_SETBIDIOPTIONS	Define o estado atual das opções bidirecionais no controle de edição avançada.
EM_SETBKGNDCOLOR	Define a cor do plano de fundo para um controle de edição avançado.
EM_SETCHARFORMAT	Define a formatação de caracteres em um controle de edição avançado.
EM_SETCTFMODEBIAS	Defina o viés do modo TSF para um controle Rich Edit.
EM_SETCTFOPENSTATUS	Abre ou fecha o teclado TSF.
EM_SETEDITSTYLE	Define os sinalizadores de estilo de edição atuais.
EM_SETEVENTMASK	Define a máscara de evento para um controle de edição avançado. A máscara de evento especifica quais códigos de notificação o controle envia para sua janela pai.
EM_SETFONTSIZE	Define o tamanho da fonte para o texto selecionado.
EM_SETHYPHENATEINFO	Define a maneira como um controle Rich Edit faz a hifenização.
EM_SETIMECOLOR	Define a cor de composição do IME. Esta mensagem está disponível somente nas versões em idioma asiático do sistema operacional.
EM_SETIMEMODEBIAS	Define o viés do modo IME para um controle Rich Edit.
EM_SETIMEOPTIONS	Define as opções do IME. Esta mensagem está disponível somente nas versões em idioma asiático do sistema operacional.
EM_SETLANGOPTIONS	Define opções para suporte a IME e idiomas asiáticos em um controle de edição avançado.
EM_SETOLECALLBACK	Fornece a um controle de edição avançado um objeto IRichEditOleCallback que o controle usa para obter recursos e informações relacionados ao OLE do cliente.
EM_SETOPTIONS	Define as opções para um controle de edição avançado.
EM_SETPAGEROTATE	Preterido. Define o layout de texto para um controle Rich Edit.
EM_SETPALETTE	Altera a paleta que a edição avançada usa para sua janela de exibição.
EM_SETPARAFORMAT	Define a formatação de parágrafo para a seleção atual em um controle de edição avançada.
EM_SETPUNCTUATION	Define os caracteres de pontuação para um controle de edição avançada. Esta mensagem está disponível somente nas versões em idioma asiático do sistema operacional.
EM_SETSCROLLPOS	Diz ao controle de edição avançada para rolar até um ponto específico.
EM_SETTARGETDEVICE	Define o dispositivo de destino e a largura da linha usados para a formatação "o que você vê é o que você obtém" (WYSIWYG) em um controle de edição avançado.
EM_SETTEXTEX	Combina a funcionalidade de WM_SETTEXT e EM_REPLACESEL e adiciona a capacidade de definir texto usando uma página de código e usar rich text ou texto sem formatação.
EM_SETTEXTMODE	Define o modo de texto ou o nível de desfazer de um controle de edição avançada. A mensagem falhará se o controle contiver qualquer texto.
EM_SETTYPOGRAPHYOPTIONS	Define o estado atual das opções de tipografia de um controle de edição avançada.
EM_SETUNDOLIMIT	Define o número máximo de ações que podem ser armazenadas na fila de desfazer.
EM_SETWORDBREAKPROCEX	Define o procedimento estendido de quebra de palavras.
EM_SETWORDWRAPMODE	Define as opções de quebra automática de linha e separação de palavras para o controle de edição avançada. Esta mensagem está disponível somente nas versões em idioma asiático do sistema operacional.
EM_SETZOOM	Define a taxa de zoom entre 1/64 e 64.
EM_SHOWSCROLLBAR	Mostra ou oculta uma das barras de rolagem na janela Host de Texto.
EM_STOPGROUPTYPING	Impede que o controle colete ações de digitação adicionais na ação de desfazer atual. O controle armazena a próxima ação de digitação, se houver, em uma nova ação na fila de desfazer.
EM_STREAMIN	Substitui o conteúdo de um controle de edição avançado por um fluxo de dados fornecido por uma função de retorno de chamada EditStreamCallback definida pelo aplicativo.
EM_STREAMOUT	Faz com que um controle de edição avançado passe seu conteúdo para uma função de retorno de chamada EditStreamCallback definida pelo aplicativo. A função de retorno de chamada pode gravar o fluxo de dados em um arquivo ou em qualquer outro local escolhido.

Notifications

Tópico	Contents
EN_ALIGNLTR	Notifica a janela pai de um controle de edição avançada de que a direção do parágrafo foi alterada para da esquerda para a direita. Um controle de edição avançada envia esse código de notificação na forma de uma mensagem WM\_COMMAND.
EN_ALIGNRTL	Notifica a janela pai de um controle de edição avançada de que a direção do parágrafo foi alterada para da esquerda para a direita. Um controle de edição avançada envia esse código de notificação na forma de uma mensagem WM\_COMMAND.
EN_CORRECTTEXT	Notifica a janela pai de um controle de edição avançada de que ocorreu um gesto SYV_CORRECT, dando à janela pai a chance de cancelar a correção do texto. Um controle de edição avançada envia esse código de notificação na forma de uma mensagem WM_NOTIFY.
EN_DRAGDROPDONE	Notifica a janela pai de um controle de edição avançada de que a operação de arrastar e soltar foi concluída. Um controle de edição avançada envia esse código de notificação na forma de uma mensagem WM_NOTIFY.
EN_DROPFILES	Notifica a janela pai de um controle de edição avançada que o usuário está tentando soltar arquivos no controle. Um controle rich edit envia esse código de notificação na forma de uma mensagem de WM_NOTIFY quando recebe a mensagem WM_DROPFILES.
EN_IMECHANGE	Notifica o pai de um controle de edição avançada de que o status de conversão do IME foi alterado. Esta mensagem está disponível apenas para versões de idioma asiático do sistema operacional. Um controle de edição avançada envia esse código de notificação na forma de uma mensagem WM\_COMMAND.
EN_LINK	Notifica a janela pai de um controle de edição avançada quando o usuário clica no mouse ou quando o ponteiro do mouse está sobre o texto que tem o efeito CFE_LINK. A janela pai do controle recebe esse código de notificação por meio de uma mensagem WM_NOTIFY.
EN_LOWFIRTF	Notifica a janela pai de um controle de edição avançada de um controle Rich Edit de que uma palavra-chave RTF (Rich Text Format) sem suporte foi recebida. Um controle Rich Edit envia esse código de notificação na forma de uma mensagem WM_NOTIFY.
EN_MSGFILTER	Notifica a janela pai de um controle de edição avançada de um evento de teclado ou mouse no controle. Um controle de edição avançada envia esse código de notificação na forma de uma mensagem WM_NOTIFY.
EN_OBJECTPOSITIONS	Notifica a janela pai de um controle de edição avançada quando o controle é lido em objetos. Um controle de edição avançada envia esse código de notificação na forma de uma mensagem WM_NOTIFY.
EN_OLEOPFAILED	Notifica a janela pai de um controle de edição avançada de que uma ação do usuário em um objeto COM falhou. Um controle de edição avançada envia esse código de notificação na forma de uma mensagem WM_NOTIFY.
EN_PROTECTED	Notifica a janela pai de um controle de edição avançada de que o usuário está executando uma ação que alteraria um intervalo protegido de texto. Um controle de edição avançada envia esse código de notificação na forma de uma mensagem WM_NOTIFY.
EN_REQUESTRESIZE	Notifica a janela pai de um controle de edição avançada de que o conteúdo do controle é menor ou maior do que o tamanho da janela do controle. Um controle de edição avançada envia esse código de notificação na forma de uma mensagem WM_NOTIFY.
EN_SAVECLIPBOARD	Notifica a janela pai do controle rich edit de que o controle está fechando e a área de transferência contém informações. Um controle de edição avançada envia esse código de notificação na forma de uma mensagem WM_NOTIFY.
EN_SELCHANGE	Notifica a janela pai de um controle de edição avançada de que a seleção atual foi alterada. Um controle de edição avançada envia esse código de notificação na forma de uma mensagem WM_NOTIFY.
EN_STOPNOUNDO	Notifica a janela pai de um controle de edição avançada de que ocorreu uma ação para a qual o controle não pode alocar memória suficiente para manter o estado de desfazer. Um controle de edição avançada envia esse código de notificação na forma de uma mensagem WM_NOTIFY.

Estruturas

Tópico	Contents
BIDIOPÇÕES	Contém informações bidirecionais sobre um controle de edição avançado. Essa estrutura é usada pelas mensagens EM_GETBIDIOPTIONS e EM_SETBIDIOPTIONS para obter e definir as informações bidirecionais para um controle.
FORMATO CHARFORMAT	Contém informações sobre formatação de caracteres em um controle de edição avançada.
CHARFORMAT2	Contém informações sobre formatação de caracteres em um controle de edição avançada. CHARFORMAT2 é uma extensão do Microsoft Rich Edit 2.0 da estrutura CHARFORMAT. Microsoft Rich Edit 2.0 permite que você use qualquer estrutura com o EM_GETCHARFORMAT e EM_SETCHARFORMAT mensagens.
DESCABIMENTO.	Especifica um intervalo de caracteres em um controle de edição avançado.
COMPCOLOR	Contém configurações de cor para uma cadeia de caracteres de composição.
EDITSTREAM	Contém informações que um aplicativo passa para um controle de edição avançado em uma mensagem EM_STREAMIN ou EM_STREAMOUT. O controle de edição avançada usa as informações para transferir um fluxo de dados para dentro ou para fora do controle.
TEXTO CORRETO	Contém informações sobre o texto selecionado a ser corrigido.
ENDROPFILES	Contém informações associadas a um código de notificação EN_DROPFILES . Um controle de edição avançada envia esse código de notificação quando recebe uma mensagem WM_DROPFILES.
LIGAÇÃO	Contém informações sobre um código de notificação EN_LINK de um controle de edição avançada.
ENLOWFIRTF	Contém informações sobre uma palavra-chave RTF sem suporte em um controle Rich Edit.
ENOLEOPFAILED	Contém informações sobre uma operação com falha.
PROTEGIDO	Contém informações associadas a um código de notificação EN_PROTECTED . Um controle rich edit envia essa notificação quando o usuário tenta editar texto protegido.
ENSAVEÁREA de transferência	Contém informações sobre objetos e texto na área de transferência.
LOCALIZAR TEXTO	Contém informações sobre uma operação de pesquisa em um controle de edição avançado. Essa estrutura é usada com a mensagem EM_FINDTEXT.
FINDTEXTEX	Contém informações sobre texto a ser pesquisado em um controle de edição avançada. Essa estrutura é usada com a mensagem EM_FINDTEXTEX.
FORMATRANGE	Contém informações que um controle de edição avançada usa para formatar sua saída para um dispositivo específico. Essa estrutura é usada com a mensagem EM_FORMATRANGE.
GETTEXTEX	Contém informações sobre uma operação para obter texto de um controle de edição avançada. Essa estrutura é passada no wParam na mensagem EM_GETTEXTEX .
GETTEXTLENGTHEX	Contém informações sobre como o comprimento do texto de um controle de edição avançada deve ser calculado. Essa estrutura é passada no wParam na mensagem EM_GETTEXTLENGTHEX.
HYPHENATEINFO	Contém informações sobre hifenização em um controle Rich Edit.
HYPHRESULT	Contém informações sobre o resultado da hifenização em um controle Rich Edit.
IMECOMPTEXT	Contém informações sobre o texto de composição em um controle Rich Edit.
MSGFILTER	Contém informações sobre um evento de teclado ou mouse. Um controle de edição avançada envia essa estrutura para sua janela pai como parte de um código de notificação EN_MSGFILTER , permitindo que o pai altere a mensagem ou impeça que ela seja processada.
OBJECTPOSITIONS	Contém informações sobre a posição do objeto.
PARAFORMATO	Contém informações sobre atributos de formatação de parágrafo em um controle de edição avançada. Essa estrutura é usada com as mensagens EM_GETPARAFORMAT e EM_SETPARAFORMAT.
PARAFORMAT2	Contém informações sobre atributos de formatação de parágrafo em um controle de edição avançada.
PONTUAÇÃO	Contém informações sobre a pontuação usada em um controle de edição avançado.
REOBJECT	Contém informações sobre um objeto.
REPASTOESPECIAL	Contém informações que identificam se o aspecto de exibição de um objeto colado deve ser baseado no conteúdo do objeto ou no ícone que representa o objeto.
REQREDIMENSIONAR	Contém o tamanho solicitado de um controle de edição avançado. Um controle de edição avançada envia essa estrutura para sua janela pai como parte de um código de notificação EN_REQUESTRESIZE .
SELCHANGE	Contém informações associadas a um código de notificação EN_SELCHANGE . Um controle de edição avançada envia essa notificação para sua janela pai quando a seleção atual é alterada.
SETTEXTEX	Especifica qual página de código (se houver) usar na configuração de texto, se o texto substitui todo o texto no controle ou apenas a seleção e se o estado de desfazer deve ser preservado.
INTERVALO DE TEXTO	Recebe um intervalo de texto de um controle de edição avançada. Essa estrutura é preenchida pela mensagem EM_GETTEXTRANGE. O buffer apontado pelo membro lpstrText deve ser grande o suficiente para receber todos os caracteres e o caractere nulo de terminação.

Constantes

Tópico	Contents
Sinalizadores de máscara de evento de controle de edição avançada	A máscara de evento especifica quais códigos de notificação um controle rich edit envia para sua janela pai.
Estilos de controle de edição avançada	Descreve os estilos de janela que são exclusivos para controles de edição avançada.