Modifica rtf

Questa sezione contiene informazioni sugli elementi di programmazione usati con controlli di modifica avanzati. Un controllo rich edit consente all'utente di immettere, modificare, stampare e salvare testo. Il testo può essere assegnato a caratteri e formattazione di paragrafo e può includere oggetti COM (Component Object Model) incorporati.

Poiché i controlli di modifica avanzati supportano quasi tutti i messaggi e i codici di notifica usati con controlli di modifica su più righe, le applicazioni che già usano controlli di modifica possono essere facilmente modificate per usare controlli di modifica avanzati.

Panoramiche

Argomento	Contenuto
Informazioni sui controlli Rich Edit	Questa sezione presenta controlli di modifica avanzati.
Uso di controlli Rich Edit	Questa sezione contiene argomenti che illustrano come creare e usare controlli di modifica avanzati.

Funzioni

Argomento	Contenuto
Correzione automaticaProc	La funzione AutoCorrectProc è una funzione di callback definita dall'applicazione usata con il messaggio EM_edizione Standard TAUTOCORRECTPROC.
EditStreamCallback	La funzione EditStreamCallback è una funzione di callback definita dall'applicazione usata con i messaggi EM_STREAMIN e EM_STREAMOUT. Viene usato per trasferire un flusso di dati in o fuori da un controllo di modifica avanzato.
EditWordBreakProcEx	La funzione EditWordBreakProcEx è una funzione di callback definita dall'applicazione usata con il messaggio EM_edizione Standard TWORDBREAKPROCEX. Determina l'indice dei caratteri dell'interruzione di parola o della classe di caratteri e dei flag di word break dei caratteri nel testo specificato.
SillabatoProc	La funzione HyphenateProc è una funzione di callback definita dall'applicazione usata con il messaggio EM_edizione Standard THYPHENATEINFO. Determina come viene eseguita la sillabazione in un controllo Microsoft Rich Edit.

Interfacce

Argomento	Contenuto
IRichEditOle	L'interfaccia IRichEditOle espone la funzionalità COM di un controllo di modifica avanzato. L'interfaccia può essere ottenuta inviando il messaggio di EM_GETOLEINTERFACE .
IRichEditOleCallback	L'interfaccia IRichEditOleCallback viene utilizzata da un controllo di modifica rtf per recuperare le informazioni correlate a OLE dal client. Un client di controllo di modifica avanzato è responsabile dell'implementazione di questa interfaccia e dell'assegnazione al controllo tramite il messaggio EM_edizione Standard TOLECALLBACK.

Messaggi

Argomento	Contenuto
EM_AUTOURLDETECT	Abilita o disabilita il rilevamento automatico degli URL tramite un controllo di modifica avanzato.
EM_CANPASTE	Determina se un controllo rich edit può incollare un formato degli Appunti specificato.
EM_CANREDO	Determina se sono presenti azioni nella coda di rollforward del controllo.
EM_DISPLAYBAND	Visualizza una parte del contenuto di un controllo di modifica rtf, come in precedenza formattato per un dispositivo usando il messaggio EM_FORMATRANGE.
EM_EXGETedizione Standard L	Recupera le posizioni dei caratteri iniziali e finali della selezione in un controllo di modifica rtf.
EM_EXLIMITTEXT	Imposta un limite massimo per la quantità di testo che l'utente può digitare o incollare in un controllo di modifica rtf.
EM_EXLINEFROMCHAR	Determina quale riga contiene il carattere specificato in un controllo di modifica rtf.
EM_EXedizione Standard T edizione Standard L	Seleziona un intervallo di caratteri o oggetti COM in un controllo Rich Edit.
EM_FINDTEXT	Trova testo all'interno di un controllo rich edit.
EM_FINDTEXTEX	Trova testo all'interno di un controllo rich edit.
EM_FINDTEXTEXW	Trova testo Unicode all'interno di un controllo rich edit.
EM_FINDTEXTW	Trova testo Unicode all'interno di un controllo rich edit.
EM_FINDWORDBREAK	Trova l'interruzione di parola successiva prima o dopo la posizione del carattere specificata o recupera informazioni sul carattere in tale posizione.
EM_FORMATRANGE	Formatta un intervallo di testo in un controllo di modifica rtf per un dispositivo specifico.
EM_GETAUTOURLDETECT	Indica se il rilevamento dell'URL automatico è attivato nel controllo rich edit.
EM_GETBIDIOPTIONS	Indica lo stato corrente delle opzioni bidirezionali nel controllo rich edit.
EM_GETCHARFORMAT	Determina la formattazione dei caratteri in un controllo di modifica rtf.
EM_GETCTFMODEBIAS	Ottiene i valori di distorsione della modalità TSF (Text Services Framework) per un controllo Rich Edit.
EM_GETCTFOPENSTATUS	Determina se la tastiera TSF è aperta o chiusa.
EM_GETEDITSTYLE	Recupera i flag di stile di modifica correnti.
EM_GETEVENTMASK	Recupera la maschera evento per un controllo rich edit. La maschera eventi specifica i codici di notifica inviati dal controllo alla relativa finestra padre.
EM_GETHYPHENATEINFO	Ottiene informazioni sulla sillabazione per un controllo Rich Edit.
EM_GETIMECOLOR	Recupera il colore di composizione IME (Input Method Editor). Questo messaggio è disponibile solo nelle versioni asiatiche del sistema operativo.
EM_GETIMECOMPMODE	Ottiene la modalità IME corrente per un controllo di modifica avanzato.
EM_GETIMECOMPTEXT	Ottiene il testo della composizione IME.
EM_GETIMEMODEBIAS	Ottiene la distorsione della modalità IME per un controllo Rich Edit.
EM_GETIMEOPTIONS	Recupera le opzioni IME correnti. Questo messaggio è disponibile solo nelle versioni asiatiche del sistema operativo.
EM_GETIMEPROPERTY	Ottiene la proprietà e le funzionalità dell'IME associato alle impostazioni locali di input correnti.
EM_GETLANGOPTIONS	Ottiene le impostazioni delle opzioni di un controllo di modifica avanzato per il supporto delle lingue IME e asiatiche.
EM_GETOLEINTERFACE	Recupera un oggetto IRichEditOle che un client può utilizzare per accedere alle funzionalità COM di un controllo di modifica avanzato.
EM_GETOPTIONS	Recupera le opzioni avanzate del controllo di modifica.
EM_GETPAGEROTATE	Deprecato. Ottiene il layout di testo per un controllo Rich Edit.
EM_GETPARAFORMAT	Recupera la formattazione di paragrafo della selezione corrente in un controllo di modifica rtf.
EM_GETPUNCTUATION	Ottiene i caratteri di punteggiatura correnti per il controllo rich edit. Questo messaggio è disponibile solo nelle versioni asiatiche del sistema operativo.
EM_GETREDONAME	Recupera il tipo dell'azione successiva, se presente, nella coda di rollforward del controllo rich edit.
EM_GETSCROLLPOS	Ottiene la posizione di scorrimento corrente del controllo di modifica.
EM_GETedizione Standard LTEXT	Recupera il testo attualmente selezionato in un controllo rich edit.
EM_GETTEXTEX	Ottiene tutto il testo dal controllo rich edit in qualsiasi codebase specifica desiderata.
EM_GETTEXTLENGTHEX	Calcola la lunghezza del testo in vari modi. Viene in genere chiamato prima di creare un buffer per ricevere il testo dal controllo .
EM_GETTEXTMODE	Ottiene la modalità di testo corrente e il livello di annullamento di un controllo di modifica rtf.
EM_GETTEXTRANGE	Recupera un intervallo di caratteri specificato da un controllo di modifica avanzato.
EM_GETTYPOGRAPHYOPTIONS	Recupera lo stato corrente delle opzioni tipografiche di un controllo di modifica avanzato.
EM_GETUNDONAME	Microsoft Rich Edit 2.0 e versioni successive: recupera il tipo dell'azione di annullamento successiva, se presente. Microsoft Rich Edit 1.0: questo messaggio non è supportato.
EM_GETWORDBREAKPROCEX	Recupera l'indirizzo della routine word break estesa attualmente registrata.
EM_GETWORDWRAPMODE	Ottiene le opzioni di ritorno a capo automatico e word break correnti per il controllo di modifica rtf. Questo messaggio è disponibile solo nelle versioni asiatiche del sistema operativo.
EM_GETZOOM	Ottiene il rapporto di zoom corrente, sempre compreso tra 1/64 e 64.
EM_HIDEedizione Standard LECTION	Nasconde o mostra la selezione in un controllo di modifica rtf.
EM_ISIME	Determina se le impostazioni locali di input correnti sono impostazioni locali dell'Asia orientale.
EM_PASTESPECIAL	Incolla un formato specifico degli Appunti in un controllo di modifica rtf.
EM_RECONVERSION	Richiama la finestra di dialogo di riconversione IME.
EM_REDO	Ripete l'azione successiva nella coda di rollforward del controllo.
EM_REQUESTRESIZE	Forza un controllo di modifica avanzato per inviare un codice di notifica EN_REQUESTRESIZE alla finestra padre.
EM_edizione Standard LECTIONTYPE	Determina il tipo di selezione per un controllo rich edit.
EM_edizione Standard TBIDIOPTIONS	Imposta lo stato corrente delle opzioni bidirezionali nel controllo rich edit.
EM_edizione Standard TBKGNDCOLOR	Imposta il colore di sfondo per un controllo rich edit.
EM_edizione Standard TCHARFORMAT	Imposta la formattazione dei caratteri in un controllo rich edit.
EM_edizione Standard TCTFMODEBIAS	Impostare la distorsione della modalità TSF per un controllo Rich Edit.
EM_edizione Standard TCTFOPENSTATUS	Apre o chiude la tastiera TSF.
EM_edizione Standard TEDITSTYLE	Imposta i flag di stile di modifica correnti.
EM_edizione Standard TEVENTMASK	Imposta la maschera evento per un controllo rich edit. La maschera eventi specifica i codici di notifica inviati dal controllo alla relativa finestra padre.
EM_edizione Standard TFONTSIZE	Imposta le dimensioni del carattere per il testo selezionato.
EM_edizione Standard THYPHENATEINFO	Imposta il modo in cui un controllo Rich Edit esegue la sillabazione.
EM_edizione Standard TIMECOLOR	Imposta il colore di composizione IME. Questo messaggio è disponibile solo nelle versioni asiatiche del sistema operativo.
EM_edizione Standard TIMEMODEBIAS	Imposta la distorsione della modalità IME per un controllo Rich Edit.
EM_edizione Standard TIMEOPTIONS	Imposta le opzioni IME. Questo messaggio è disponibile solo nelle versioni asiatiche del sistema operativo.
EM_edizione Standard TLANGOPTIONS	Imposta le opzioni per il supporto di lingue asiatiche e IME in un controllo di modifica avanzato.
EM_edizione Standard TOLECALLBACK	Fornisce un controllo di modifica avanzato a un oggetto IRichEditOleCallback utilizzato dal controllo per ottenere le risorse e le informazioni correlate a OLE dal client.
EM_edizione Standard TOPTIONS	Imposta le opzioni per un controllo rich edit.
EM_edizione Standard TPAGEROTATE	Deprecato. Imposta il layout di testo per un controllo Rich Edit.
EM_edizione Standard TPALETTE	Modifica la tavolozza utilizzata dalla modifica avanzata per la relativa finestra di visualizzazione.
EM_edizione Standard TPARAFORMAT	Imposta la formattazione del paragrafo per la selezione corrente in un controllo di modifica rtf.
EM_edizione Standard TPUNCTUATION	Imposta i caratteri di punteggiatura per un controllo di modifica rtf. Questo messaggio è disponibile solo nelle versioni asiatiche del sistema operativo.
EM_edizione Standard TSCROLLPOS	Indica al controllo rich edit di scorrere fino a un punto specifico.
EM_edizione Standard TTARGETDEVICE	Imposta la larghezza del dispositivo e della linea di destinazione usata per la formattazione "what you see is what you get" (WYSIWYG) in un controllo di modifica avanzato.
EM_edizione Standard TTEXTEX	Combina la funzionalità di WM_edizione Standard TTEXT e EM_REPLACEedizione Standard L e aggiunge la possibilità di impostare il testo usando una tabella codici e di usare testo RTF o testo normale.
EM_edizione Standard TTEXTMODE	Imposta la modalità di testo o il livello di annullamento di un controllo di modifica rtf. Il messaggio ha esito negativo se il controllo contiene testo.
EM_edizione Standard TTYPOGRAPHYOPTIONS	Imposta lo stato corrente delle opzioni di tipografia di un controllo di modifica avanzato.
EM_edizione Standard TUNDOLIMIT	Imposta il numero massimo di azioni che possono essere archiviate nella coda di annullamento.
EM_edizione Standard TWORDBREAKPROCEX	Imposta la routine di word break estesa.
EM_edizione Standard TWORDWRAPMODE	Imposta le opzioni di ritorno a capo automatico e di word break per il controllo di modifica rtf. Questo messaggio è disponibile solo nelle versioni asiatiche del sistema operativo.
EM_edizione Standard TZOOM	Imposta il rapporto di zoom in qualsiasi punto compreso tra 1/64 e 64.
EM_SHOWSCROLLBAR	Visualizza o nasconde una delle barre di scorrimento nella finestra Host di testo.
EM_STOPGROUPTYPING	Impedisce al controllo di raccogliere altre azioni di digitazione nell'azione di annullamento corrente. Il controllo archivia l'azione di digitazione successiva, se presente, in una nuova azione nella coda di annullamento.
EM_STREAMIN	Sostituisce il contenuto di un controllo di modifica avanzato con un flusso di dati fornito da un'applicazione definita dalla funzione di callback EditStreamCallback.
EM_STREAMOUT	Fa sì che un controllo rich edit passi il relativo contenuto a un'applicazione definita dalla funzione di callback EditStreamCallback. La funzione di callback può quindi scrivere il flusso di dati in un file o in qualsiasi altra posizione scelta.

Notifications

Argomento	Contenuto
EN_ALIGNLTR	Notifica alla finestra padre di un controllo rich edit che la direzione del paragrafo è stata modificata da sinistra a destra. Un controllo rich edit invia questo codice di notifica sotto forma di messaggio di WM_COMMAND .
EN_ALIGNRTL	Notifica alla finestra padre di un controllo rich edit che la direzione del paragrafo è cambiata da destra a sinistra. Un controllo rich edit invia questo codice di notifica sotto forma di messaggio di WM_COMMAND .
EN_CORRECTTEXT	Notifica alla finestra padre di un controllo rich edit che si è verificato un SYV_CORRECT movimento, dando alla finestra padre la possibilità di annullare la correzione del testo. Un controllo rich edit invia questo codice di notifica sotto forma di messaggio di WM_NOTIFY .
EN_DRAGDROPDONE	Notifica alla finestra padre di un controllo rich edit che l'operazione di trascinamento della selezione è stata completata. Un controllo rich edit invia questo codice di notifica sotto forma di messaggio di WM_NOTIFY .
EN_DROPFILES	Notifica alla finestra padre di un controllo rich edit che l'utente sta tentando di eliminare i file nel controllo. Un controllo rich edit invia questo codice di notifica sotto forma di messaggio di WM_NOTIFY quando riceve il messaggio WM_DROPFILES.
EN_IMECHANGE	Notifica all'elemento padre di un controllo di modifica rtf che lo stato di conversione IME è stato modificato. Questo messaggio è disponibile solo per le versioni asiatiche del sistema operativo. Un controllo rich edit invia questo codice di notifica sotto forma di messaggio di WM_COMMAND .
EN_LINK	Notifica alla finestra padre di un controllo di modifica rtf quando l'utente fa clic sul mouse o quando il puntatore del mouse è posizionato sul testo con effetto CFE_LINK. La finestra padre del controllo riceve questo codice di notifica tramite un messaggio di WM_NOTIFY .
EN_LOWFIRTF	Notifica alla finestra padre di un controllo rich edit di un controllo Rich Edit che è stata ricevuta una parola chiave RTF (Rich Text Format) non supportata. Un controllo Rich Edit invia questo codice di notifica sotto forma di messaggio di WM_NOTIFY .
EN_MSGFILTER	Notifica alla finestra padre di un controllo rich edit di un evento della tastiera o del mouse nel controllo . Un controllo rich edit invia questo codice di notifica sotto forma di messaggio di WM_NOTIFY .
EN_OBJECTPOSITIONS	Notifica alla finestra padre di un controllo rich edit quando il controllo legge negli oggetti . Un controllo rich edit invia questo codice di notifica sotto forma di messaggio di WM_NOTIFY .
EN_OLEOPFAILED	Notifica a una finestra padre di un controllo di modifica avanzata che un'azione dell'utente su un oggetto COM non è riuscita. Un controllo rich edit invia questo codice di notifica sotto forma di messaggio di WM_NOTIFY .
EN_PROTECTED	Notifica alla finestra padre di un controllo rich edit che l'utente sta eseguendo un'azione che modifica un intervallo di testo protetto. Un controllo rich edit invia questo codice di notifica sotto forma di messaggio di WM_NOTIFY .
EN_REQUESTRESIZE	Notifica alla finestra padre di un controllo di modifica rtf che il contenuto del controllo è minore o maggiore delle dimensioni della finestra del controllo. Un controllo rich edit invia questo codice di notifica sotto forma di messaggio di WM_NOTIFY .
EN_SAVECLIPBOARD	Notifica alla finestra padre del controllo rich edit che il controllo sta chiudendo e che gli Appunti contengono informazioni. Un controllo rich edit invia questo codice di notifica sotto forma di messaggio di WM_NOTIFY .
EN_edizione Standard LCHANGE	Notifica alla finestra padre di un controllo di modifica rtf che la selezione corrente è stata modificata. Un controllo rich edit invia questo codice di notifica sotto forma di messaggio di WM_NOTIFY .
EN_STOPNOUNDO	Notifica alla finestra padre di un controllo rich edit che si è verificata un'azione per la quale il controllo non può allocare memoria sufficiente per mantenere lo stato di annullamento. Un controllo rich edit invia questo codice di notifica sotto forma di messaggio di WM_NOTIFY .

Strutture

Argomento	Contenuto
BIDIOPTIONS	Contiene informazioni bidirezionali su un controllo di modifica avanzato. Questa struttura viene utilizzata dai messaggi EM_GETBIDIOPTIONS e EM_edizione Standard TBIDIOPTIONS per ottenere e impostare le informazioni bidirezionali per un controllo.
CHARFORMAT	Contiene informazioni sulla formattazione dei caratteri in un controllo di modifica rtf.
CHARFORMAT2	Contiene informazioni sulla formattazione dei caratteri in un controllo di modifica rtf. CHARFORMAT2 è un'estensione di Microsoft Rich Edit 2.0 della struttura CHARFORMAT. Microsoft Rich Edit 2.0 consente di usare entrambe le strutture con i messaggi EM_GETCHARFORMAT e EM_edizione Standard TCHARFORMAT.
CHARRANGE	Specifica un intervallo di caratteri in un controllo di modifica avanzato.
COMPCOLOR	Contiene le impostazioni dei colori per una stringa di composizione.
EDITSTREAM	Contiene informazioni che un'applicazione passa a un controllo di modifica avanzato in un EM_STREAMIN o EM_STREAMOUT messaggio. Il controllo rich edit utilizza le informazioni per trasferire un flusso di dati all'interno o all'esterno del controllo.
ENCORRECTTEXT	Contiene informazioni sul testo selezionato da correggere.
ENDROPFILES	Contiene informazioni associate a un codice di notifica EN_DROPFILES . Un controllo rich edit invia questo codice di notifica quando riceve un messaggio di WM_DROPFILES .
ENLINK	Contiene informazioni su un codice di notifica EN_LINK da un controllo di modifica avanzato.
ENLOWFIRTF	Contiene informazioni su una parola chiave RTF non supportata in un controllo Rich Edit.
ENOLEOPFAILED	Contiene informazioni su un'operazione non riuscita.
ENPROTECTED	Contiene informazioni associate a un codice di notifica EN_PROTECTED . Un controllo rich edit invia questa notifica quando l'utente tenta di modificare il testo protetto.
ENSAVECLIPBOARD	Contiene informazioni su oggetti e testo negli Appunti.
FINDTEXT	Contiene informazioni su un'operazione di ricerca in un controllo di modifica avanzato. Questa struttura viene utilizzata con il messaggio di EM_FINDTEXT .
FINDTEXTEX	Contiene informazioni sul testo da cercare in un controllo di modifica rtf. Questa struttura viene utilizzata con il messaggio di EM_FINDTEXTEX .
FORMATRANGE	Contiene informazioni utilizzate da un controllo di modifica avanzato per formattare l'output per un determinato dispositivo. Questa struttura viene utilizzata con il messaggio di EM_FORMATRANGE .
GETTEXTEX	Contiene informazioni su un'operazione per ottenere testo da un controllo rich edit. Questa struttura viene passata nel wParam nel messaggio di EM_GETTEXTEX.
GETTEXTLENGTHEX	Contiene informazioni sulla modalità di calcolo della lunghezza del testo di un controllo di modifica rtf. Questa struttura viene passata nel wParam nel messaggio di EM_GETTEXTLENGTHEX.
HYPHENATEINFO	Contiene informazioni sulla sillabazione in un controllo Rich Edit.
HYPHRESULT	Contiene informazioni sul risultato della sillabazione in un controllo Rich Edit.
IMECOMPTEXT	Contiene informazioni sul testo della composizione in un controllo Rich Edit.
MSGFILTER	Contiene informazioni su un evento della tastiera o del mouse. Un controllo rich edit invia questa struttura alla relativa finestra padre come parte di un codice di notifica EN_MSGFILTER , consentendo all'elemento padre di modificare il messaggio o impedire che venga elaborato.
OGGETTIPOSITIONS	Contiene informazioni sulla posizione dell'oggetto.
PARAFORMAT	Contiene informazioni sugli attributi di formattazione dei paragrafi in un controllo di modifica avanzato. Questa struttura viene utilizzata con i messaggi EM_GETPARAFORMAT e EM_edizione Standard TPARAFORMAT.
PARAFORMAT2	Contiene informazioni sugli attributi di formattazione dei paragrafi in un controllo di modifica avanzato.
PUNTEGGIATURA	Contiene informazioni sulla punteggiatura utilizzata in un controllo di modifica rtf.
REOBJECT	Contiene informazioni su un oggetto .
REPASTESPECIAL	Contiene informazioni che identificano se l'aspetto di visualizzazione di un oggetto incollato deve essere basato sul contenuto dell'oggetto o sull'icona che rappresenta l'oggetto.
REQRESIZE	Contiene le dimensioni richieste di un controllo rich edit. Un controllo rich edit invia questa struttura alla relativa finestra padre come parte di un codice di notifica EN_REQUESTRESIZE .
edizione Standard LCHANGE	Contiene informazioni associate a un codice di notifica EN_edizione Standard LCHANGE. Un controllo rich edit invia questa notifica alla relativa finestra padre quando cambia la selezione corrente.
edizione Standard TTEXTEX	Specifica la tabella codici (se presente) da utilizzare nel testo dell'impostazione, se il testo sostituisce tutto il testo nel controllo o solo la selezione e se lo stato di annullamento deve essere mantenuto.
TEXTRANGE	Riceve un intervallo di testo da un controllo rich edit. Questa struttura viene compilata dal messaggio di EM_GETTEXTRANGE . Il buffer a cui punta il membro lpstrText deve essere sufficientemente grande da ricevere tutti i caratteri e il carattere Null di terminazione.

Costanti

Argomento	Contenuto
Flag maschera evento controllo Rich Edit	La maschera eventi specifica i codici di notifica inviati da un controllo rich edit alla relativa finestra padre.
Stili di controllo Rich Edit	Descrive gli stili di finestra univoci per i controlli di modifica avanzati.