Edição avançada
Esta seção contém informações sobre os elementos de programação usados com controles de edição avançada. Um controle de edição avançada permite que o usuário insira, edite, imprima e salve texto. O texto pode ser atribuído à formatação de caracteres e parágrafos e pode incluir objetos COM (Component Object Model) inseridos.
Como os controles de edição avançada dão suporte a quase todas as mensagens e códigos de notificação usados com de várias linhas editar controles, os aplicativos que já usam controles de edição podem ser facilmente alterados para usar controles de edição avançada.
Súmulas
| Tópico | Conteúdo |
|---|---|
| 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 | Conteúdo |
|---|---|
| AutoCorrectProc | A função AutoCorrectProc é uma função de retorno de chamada definida pelo aplicativo usada com a mensagem EM_SETAUTOCORRECTPROC. |
| editStreamCallback | A funçãoEditStreamCallbacké 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 ou para fora de um controle de edição avançada. |
| 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 da classe de caractere e 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 de Edição Avançada da Microsoft. |
Interfaces
| Tópico | Conteúdo |
|---|---|
| IRichEditOle | A interface deIRichEditOleexpõe a funcionalidade COM de um controle de edição avançada. A interface pode ser obtida enviando a 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 | Conteúdo |
|---|---|
| EM_AUTOURLDETECT | Habilita ou desabilita a detecção automática de URLs por um controle de edição avançada. |
| 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á alguma ação na fila de refazer controle. |
| EM_DISPLAYBAND | Exibe uma parte do conteúdo de um controle de edição avançada, como formatado anteriormente para um dispositivo usando a mensagem EM_FORMATRANGE. |
| EM_EXGETSEL | Recupera as posições de caractere inicial e final da seleção em um controle de edição avançada. |
| 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 o texto em um controle de edição avançada. |
| EM_FINDTEXTEX | Localiza o texto em um controle de edição avançada. |
| EM_FINDTEXTEXW | Localiza o texto Unicode em um controle de edição avançada. |
| EM_FINDTEXTW | Localiza o 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 de edição avançada. |
| EM_GETBIDIOPTIONS | Indica o estado atual das opções bidirecionais no controle de edição avançada. |
| EM_GETCHARFORMAT | Determina a formatação de caracteres em um controle de edição avançada. |
| 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çada. 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 da composição do IME (Editor de Método de Entrada). Essa mensagem está disponível apenas em versões em idioma asiático do sistema operacional. |
| EM_GETIMECOMPMODE | Obtém o modo IME atual para um controle de edição avançada. |
| EM_GETIMECOMPTEXT | Obtém o texto de composição do IME. |
| EM_GETIMEMODEBIAS | Obtém o viés de modo IME para um controle Rich Edit. |
| EM_GETIMEOPTIONS | Recupera as opções atuais do IME. Essa mensagem está disponível apenas em 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çada para suporte a IME e idioma asiático. |
| 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 de controle de edição avançada. |
| EM_GETPAGEROTATE | Deprecado. Obtém o layout de texto de 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. Essa mensagem está disponível apenas em 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 no momento em um controle de edição avançada. |
| EM_GETTEXTEX | Obtém todo o texto do controle rich edit em qualquer base de código específica desejada. |
| EM_GETTEXTLENGTHEX | Calcula o comprimento do texto de várias maneiras. Geralmente, ele é 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çada. |
| 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 desfazer, se houver. Microsoft Rich Edit 1.0: não há suporte para esta mensagem. |
| EM_GETWORDBREAKPROCEX | Recupera o endereço do procedimento de quebra de palavra estendido registrado no momento. |
| EM_GETWORDWRAPMODE | Obtém as opções de quebra de palavra e quebra de palavra atuais para o controle de edição avançada. Essa mensagem está disponível apenas em 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çada. |
| EM_ISIME | Determina se a localidade de entrada atual é uma localidade do Leste Asiático. |
| EM_PASTESPECIAL | Cola um formato de área de transferência específico em um controle de edição avançada. |
| EM_RECONVERSION | Invoca a caixa de diálogo de reconversão do IME. |
| EM_REDO | Refazer a próxima ação na fila de refazer do controle. |
| EM_REQUESTRESIZE | Força um controle de edição avançada 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 da tela de fundo para um controle de edição avançada. |
| EM_SETCHARFORMAT | Define a formatação de caracteres em um controle de edição avançada. |
| EM_SETCTFMODEBIAS | Defina o viés de 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çada. 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 do 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. Essa mensagem está disponível apenas em versões em idioma asiático do sistema operacional. |
| EM_SETIMEMODEBIAS | Define o viés de modo IME para um controle Rich Edit. |
| EM_SETIMEOPTIONS | Define as opções de IME. Essa mensagem está disponível apenas em versões em idioma asiático do sistema operacional. |
| EM_SETLANGOPTIONS | Define opções para suporte a IME e idioma asiático em um controle de edição avançada. |
| EM_SETOLECALLBACK | Fornece um controle de edição avançada a 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çada. |
| EM_SETPAGEROTATE | Deprecado. 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. Essa mensagem está disponível apenas em versões em idioma asiático do sistema operacional. |
| EM_SETSCROLLPOS | Informa 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 usada para a formatação "o que você vê é o que você obtém" (WYSIWYG) em um controle de edição avançada. |
| 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 de usar texto avançado 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 de quebra de palavra estendido. |
| EM_SETWORDWRAPMODE | Define as opções de quebra de palavras e quebra de palavras para o controle de edição avançada. Essa mensagem está disponível apenas em versões em idioma asiático do sistema operacional. |
| EM_SETZOOM | Define a taxa de zoom em qualquer lugar 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 desfazer. |
| EM_STREAMIN | Substitui o conteúdo de um controle de edição avançada por um fluxo de dados fornecido por um aplicativo definido editStreamCallback função de retorno de chamada. |
| EM_STREAMOUT | Faz com que um controle de edição avançada passe seu conteúdo para um aplicativo definido função editStreamCallback de retorno de chamada. Em seguida, a função de retorno de chamada pode gravar o fluxo de dados em um arquivo ou em qualquer outro local escolhido. |
Notificações
| Tópico | Conteúdo |
|---|---|
| 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 a direita para a esquerda. 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 de WM_NOTIFY. |
| EN_DRAGDROPDONE | Notifica a janela pai de um controle de edição avançada que a operação de arrastar e soltar concluiu. Um controle de edição avançada envia esse código de notificação na forma de uma mensagem de WM_NOTIFY. |
| EN_DROPFILES | Notifica a janela pai de um controle de edição avançada de que o usuário está tentando soltar arquivos no controle. Um controle de edição avançada 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 de 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ç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 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 de 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 de 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 de WM_NOTIFY. |
| EN_PROTECTED | Notifica a janela pai de um controle de edição avançada de que o usuário está tomando 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 de 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 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 de 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çada envia esse código de notificação na forma de uma mensagem de 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 de 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 de WM_NOTIFY. |
Estruturas
| Tópico | Conteúdo |
|---|---|
| BIDIOPTIONS | Contém informações bidirecionais sobre um controle de edição avançada. Essa estrutura é usada pelas mensagens EM_GETBIDIOPTIONS e EM_SETBIDIOPTIONS para obter e definir as informações bidirecionais para um controle. |
| CHARFORMAT | Contém informações sobre a formatação de caracteres em um controle de edição avançada. |
| CHARFORMAT2 | Contém informações sobre a formatação de caracteres em um controle de edição avançada.
CHARFORMAT2 é uma extensão do Microsoft Rich Edit 2.0 da estrutura deCHARFORMAT. O Microsoft Rich Edit 2.0 permite que você use qualquer estrutura com as mensagens EM_GETCHARFORMAT e EM_SETCHARFORMAT. |
| CHARRANGE | Especifica um intervalo de caracteres em um controle de edição avançada. |
| 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çada em uma mensagem de 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. |
| ENCORRECTTEXT | Contém informações sobre o texto selecionado a ser corrigido. |
| 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. |
|
| DE ENLINK | 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. |
| PROTEGIDOS | Contém informações associadas a um código de notificação EN_PROTECTED. Um controle de edição avançada envia essa notificação quando o usuário tenta editar o texto protegido. |
| ENSAVECLIPBOARD | 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çada. 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 tamanho 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 de posição do objeto. |
| PARAFORMAT | 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. |
| de PONTUAÇÃO | Contém informações sobre a pontuação usada em um controle de edição avançada. |
| REOBJECT | Contém informações sobre um objeto. |
| REPASTESPECIAL | 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. |
| REQRESIZE | Contém o tamanho solicitado de um controle de edição avançada. 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) a ser usada 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çada. Essa estrutura é preenchida pela mensagem EM_GETTEXTRANGE. O buffer apontado pelo lpstrText membro deve ser grande o suficiente para receber todos os caracteres e o caractere nulo de terminação. |