Funzione di callback EDITWORDBREAKPROCW (winuser.h)

Articolo
08/27/2023

Funzione di callback definita dall'applicazione usata con il messaggio di EM_SETWORDBREAKPROC . Un controllo di modifica multilinea o un controllo di modifica avanzato chiama una funzione EditWordBreakProc per interrompere una riga di testo.

Il tipo EDITWORDBREAKPROC definisce un puntatore a questa funzione di callback. EditWordBreakProc è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

EDITWORDBREAKPROCW Editwordbreakprocw;

int Editwordbreakprocw(
  [in] LPWSTR lpch,
  [in] int ichCurrent,
  [in] int cch,
  [in] int code
)
{...}

Parametri

[in] lpch

Tipo: LPTSTR

Puntatore al testo del controllo di modifica.

[in] ichCurrent

Tipo: int

Indice in una posizione di carattere nel buffer di testo che identifica il punto in cui la funzione deve iniziare a controllare la presenza di un'interruzione di parola.

[in] cch

Tipo: int

Numero di TCHAR nel testo del controllo di modifica. Per il testo ANSI, si tratta del numero di byte; per il testo Unicode, si tratta del numero di WCHAR.

[in] code

Tipo: int

Azione da eseguire dalla funzione di callback. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
WB_CLASSIFY	Recupera i flag di carattere e di interruzione di parola del carattere nella posizione specificata. Questo valore è per l'uso con controlli di modifica avanzati.
WB_ISDELIMITER	Verifica se il carattere nella posizione specificata è un delimitatore.
WB_LEFT	Trova l'inizio di una parola a sinistra della posizione specificata.
WB_LEFTBREAK	Trova il delimitatore end-of-word a sinistra della posizione specificata. Questo valore è per l'uso con controlli di modifica avanzati.
WB_MOVEWORDLEFT	Trova l'inizio di una parola a sinistra della posizione specificata. Questo valore viene usato durante l'elaborazione dei tasti CTRL+LEFT. Questo valore è per l'uso con controlli di modifica avanzati.
WB_MOVEWORDRIGHT	Trova l'inizio di una parola a destra della posizione specificata. Questo valore viene usato durante l'elaborazione di tasti CTRL+RIGHT. Questo valore è per l'uso con controlli di modifica avanzati.
WB_RIGHT	Trova l'inizio di una parola a destra della posizione specificata. Questo è utile nei controlli di modifica allineati a destra.
WB_RIGHTBREAK	Trova il delimitatore end-of-word a destra della posizione specificata. Questo è utile nei controlli di modifica allineati a destra. Questo valore è per l'uso con controlli di modifica avanzati.

Valore restituito

Tipo: int

Se il parametro di codice specifica WB_ISDELIMITER, il valore restituito è diverso da zero (TRUE) se il carattere nella posizione specificata è un delimitatore o zero se non lo è. Se il parametro di codice specifica WB_CLASSIFY, il valore restituito è la classe di caratteri e i flag di interruzione di parola del carattere nella posizione specificata. In caso contrario, il valore restituito è un indice all'inizio di una parola nel buffer di testo.

Commenti

Un ritorno a capo seguito da un feed di linee deve essere considerato come una singola parola dalla funzione di callback. Due ritorni a capo seguiti da un feed di linee devono essere considerati anche come una singola parola.

Un'applicazione deve installare la funzione di callback specificando l'indirizzo della funzione di callback in un messaggio di EM_SETWORDBREAKPROC .

Modifica avanzata 1.0:Microsoft Rich Edit 1.0 passa solo i caratteri ANSI a EditWordBreakProc. Per i controlli di modifica avanzati, è possibile usare in alternativa il messaggio di EM_SETWORDBREAKPROCEX per sostituire la procedura di interruzione di word estesa predefinita con una funzione di callback EditWordBreakProcEx . Questa funzione fornisce informazioni aggiuntive sul testo, ad esempio il set di caratteri.

Modifica avanzata 2.0 e versioni successive:Microsoft Rich Edit 2.0 e versioni successive passano solo i caratteri Unicode a EditWordBreakProc. Pertanto, un'applicazione ANSI converte la stringa Unicode fornita da Rich Edit usando WideCharToMultiByte e quindi converte gli indici in modo appropriato.

Nota

L'intestazione winuser.h definisce EDITWORDBREAKPROC come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)