Edição rica
Esta seção contém informações sobre os elementos de programação usados com controles de edição avançados. Um controle de edição avançado permite que o usuário insira, edite, imprima e salve texto. O texto pode receber formatação de caracteres e parágrafos e pode incluir objetos COM (Component Object Model) incorporados.
Como os controles de edição avançados suportam quase todas as mensagens e códigos de notificação usados com controles de edição de de várias linhas, os aplicativos que já usam controles de edição podem ser facilmente alterados para usar controles de edição avançados.
Visão geral
| Tópico | Índice |
|---|---|
| Sobre controles de edição avançada | Esta seção apresenta controles de edição avançados. |
| Usando controles de edição avançados | Esta seção contém tópicos que demonstram como criar e usar controles de edição avançados. |
Funções
| Tópico | Índice |
|---|---|
| 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çãoEditWordBreakProcEx é 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. |
| HyphenateProc | 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 | Índice |
|---|---|
| IRichEditOle | O interface IRichEditOle expõe a funcionalidade COM de um controle de edição avançado. A interface pode ser obtida através do envio da mensagem EM_GETOLEINTERFACE. |
| IRichEditOleCallback | A interfaceIRichEditOleCallbacké usada por um controle de edição de 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 | Índice |
|---|---|
| EM_AUTOURLDETECT | Habilita ou desabilita a deteção automática de URLs por um controle de edição avançado. |
| EM_CANPASTE | Determina se um controle de edição avançado pode colar um formato de área de transferência especificado. |
| EM_CANREDO | Determina se há alguma ação na fila de refazer controle. |
| EM_DISPLAYBAND | Exibe uma parte do conteúdo de um controle de edição avançado, conforme formatado anteriormente para um dispositivo usando a mensagem EM_FORMATRANGE. |
| EM_EXGETSEL | Recupera as posições dos 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çado. |
| EM_EXLINEFROMCHAR | Determina qual linha contém o caractere especificado em um controle de edição avançado. |
| EM_EXSETSEL | Seleciona um intervalo de caracteres ou objetos COM em um controle Rich Edit. |
| EM_FINDTEXT | Localiza texto dentro de um controle de edição avançado. |
| EM_FINDTEXTEX | Localiza texto dentro de um controle de edição avançado. |
| EM_FINDTEXTEXW | Localiza texto Unicode dentro de um controle de edição avançado. |
| EM_FINDTEXTW | Localiza texto Unicode dentro de um controle de edição avançado. |
| 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çado para um dispositivo específico. |
| EM_GETAUTOURLDETECT | Indica se a deteção automática de URL está ativada no controle de edição avançada. |
| 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 de edição avançado. |
| EM_GETCTFMODEBIAS | Obtém os valores de viés do 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 apenas em versões de 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 apenas em versões de 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 objetoIRichEditOleque um cliente pode usar para acessar a funcionalidade COM de um controle de edição avançado. |
| 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çado. |
| EM_GETPUNCTUATION | Obtém os caracteres de pontuação atuais para o controle de edição avançada. Esta mensagem está disponível apenas em versões de 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çado. |
| 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. Geralmente é chamado antes de criar um buffer para receber o texto do controle. |
| EM_GETTEXTMODE | Obtém o modo de texto atual e desfaz o nível de um controle de edição avançado. |
| 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çado. |
| 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 palavras estendido atualmente registrado. |
| EM_GETWORDWRAPMODE | Obtém as opções atuais de quebra automática de texto e quebra de palavra para o controle de edição avançada. Esta mensagem está disponível apenas em versões de 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çado. |
| EM_RECONVERSION | Invoca a caixa de diálogo de reconversão do IME. |
| EM_REDO | Refaz a próxima ação na fila de refazer 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çado. |
| EM_SETBIDIOPTIONS | Define o estado atual das opções bidirecionais no controle rich edit. |
| 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 hifenização. |
| EM_SETIMECOLOR | Define a cor da composição do IME. Esta mensagem está disponível apenas em versões de 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 apenas em versões de 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çado. |
| EM_SETPUNCTUATION | Define os caracteres de pontuação para um controle de edição avançado. Esta mensagem está disponível apenas em versões de idioma asiático do sistema operacional. |
| EM_SETSCROLLPOS | Diz ao controle de edição avançado para rolar até um ponto específico. |
| EM_SETTARGETDEVICE | Define o dispositivo de destino e a largura da linha usada para a formatação "what you see is what you get" (WYSIWYG) em um controle de edição avançado. |
| EM_SETTEXTEX | Combina a funcionalidade de WM_SETTEXT e EM_REPLACESELe 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çado. 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çado. |
| 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 texto e quebra de texto para o controle de edição avançada. Esta mensagem está disponível apenas em versões de idioma asiático do sistema operacional. |
| EM_SETZOOM | Define a relação 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 um aplicativo definido função de retorno de chamada EditStreamCallback. |
| EM_STREAMOUT | Faz com que um controle de edição avançado passe seu conteúdo para um aplicativo definido função de retorno de chamada EditStreamCallback. A função de retorno de chamada pode então gravar o fluxo de dados em um arquivo ou em qualquer outro local que escolher. |
Notificações
| Tópico | Índice |
|---|---|
| EN_ALIGNLTR | Notifica a janela pai de um controle de edição avançado de que a direção do parágrafo foi alterada para a esquerda para a direita. Um controle de edição avançado 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çado de que a direção do parágrafo foi alterada para a direita para a esquerda. Um controle de edição avançado 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çado de que ocorreu um gesto de SYV_CORRECT, dando à janela pai a chance de cancelar a correção do texto. Um controle de edição avançado 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çado de que a operação de arrastar e soltar foi concluída. Um controle de edição avançado 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çado de que o usuário está tentando soltar arquivos no controle. Um controle de edição avançado envia esse código de notificação na forma de uma mensagem WM_NOTIFY quando recebe a mensagem WM_DROPFILES. |
| EN_IMECHANGE | Notifica o pai de um controle de edição avançado de que o status de conversão do IME foi alterado. Esta mensagem está disponível apenas para versões em idioma asiático do sistema operacional. Um controle de edição avançado 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çado 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çado de um evento de teclado ou mouse no controle. Um controle de edição avançado 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çado quando o controle lê em objetos. Um controle de edição avançado 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çado de que uma ação do usuário em um objeto COM falhou. Um controle de edição avançado 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çado de que o usuário está executando uma ação que alteraria um intervalo protegido de texto. Um controle de edição avançado 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çado de que o conteúdo do controle é menor ou maior do que o tamanho da janela do controle. Um controle de edição avançado envia esse código de notificação na forma de uma mensagem WM_NOTIFY. |
| EN_SAVECLIPBOARD | Notifica a janela pai do controle de edição avançada de que o controle está fechando e a área de transferência contém informações. Um controle de edição avançado 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çado de que a seleção atual foi alterada. Um controle de edição avançado 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çado 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çado envia esse código de notificação na forma de uma mensagem WM_NOTIFY. |
Estruturas
| Tópico | Índice |
|---|---|
| BIDIOPÇÕES | Contém informações bidirecionais sobre um controle de edição avançado. Essa estrutura é usada pelo EM_GETBIDIOPTIONS e EM_SETBIDIOPTIONS mensagens para obter e definir as informações bidirecionais para um controle. |
| CHARFORMAT | Contém informações sobre formatação de caracteres em um controle de edição avançado. |
| CHARFORMAT2 | Contém informações sobre formatação de caracteres em um controle de edição avançado.
CHARFORMAT2 é uma extensão do Microsoft Rich Edit 2.0 da estruturaCHARFORMAT. Microsoft Rich Edit 2.0 permite que você use qualquer estrutura com o EM_GETCHARFORMAT e EM_SETCHARFORMAT mensagens. |
| ORGANIZAR | 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 fora do controle. |
| ENCORRECTTEXT | 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çado envia esse código de notificação quando recebe uma mensagem WM_DROPFILES. |
| ENLINK | Contém informações sobre um código de notificação EN_LINK de um controle de edição avançado. |
| 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. |
| PROTEGIDA | 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 o texto protegido. |
| ENSAVECLIP | Contém informações sobre objetos e texto na área de transferência. |
| FINDTEXT | Contém informações sobre uma operação de pesquisa em um controle de edição avançado. Esta estrutura é usada com a mensagem EM_FINDTEXT. |
| FINDTEXTEX | Contém informações sobre texto a ser pesquisado em um controle de edição avançado. Esta estrutura é usada com a mensagem EM_FINDTEXTEX. |
| FORMATRANGE | Contém informações que um controle de edição avançado usa para formatar sua saída para um dispositivo específico. Esta 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çado. 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çado 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çado 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. |
| OBJECTPOSIÇÕES | Contém informações sobre a posição do objeto. |
| PARAFORMAT | Contém informações sobre atributos de formatação de parágrafo em um controle de edição avançado. Esta 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çado. |
| PONTUAÇÃO | Contém informações sobre a pontuação usada em um controle de edição avançado. |
| REOBJETO | Contém informações sobre um objeto. |
| REPASTESPECIAL | Contém informações que identificam se o aspeto de exibição de um objeto colado deve ser baseado no conteúdo do objeto ou no ícone que representa o objeto. |
| REQRESIZE | Contém o tamanho solicitado de um controle de edição avançado. Um controle de edição avançado 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çado 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. |
| TEXTRANGE | Recebe um intervalo de texto de um controle de edição avançado. Esta 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 | Índice |
|---|---|
| Sinalizadores de máscara de evento Rich Edit Control | A máscara de evento especifica quais códigos de notificação um controle de edição avançado envia para sua janela pai. |
| Estilos de controle de edição avançados | Descreve os estilos de janela que são exclusivos para controles de edição avançados. |