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