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. |