Funzione di callback EDITWORDBREAKPROCA (winuser.h)

Articolo
08/27/2023

Funzione di callback definita dall'applicazione usata con il messaggio EM_SETWORDBREAKPROC . Un controllo di modifica su più righe o un controllo di modifica rtf 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

EDITWORDBREAKPROCA Editwordbreakproca;

int Editwordbreakproca(
  [in] LPSTR 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 di una posizione di carattere nel buffer di testo che identifica il punto in cui la funzione deve iniziare a verificare 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, questo è il 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 la classe di caratteri e i flag di interruzione di parola del carattere nella posizione specificata. Questo valore è destinato all'uso con controlli di modifica avanzati.
WB_ISDELIMITER	Controlla 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 di fine parola a sinistra della posizione specificata. Questo valore è destinato all'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 del tasto CTRL+SINISTRA. Questo valore è destinato all'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 del tasto CTRL+DESTRA. Questo valore è destinato all'uso con controlli di modifica avanzati.
WB_RIGHT	Trova l'inizio di una parola a destra della posizione specificata. Ciò è utile nei controlli di modifica allineati a destra.
WB_RIGHTBREAK	Trova il delimitatore di fine parola a destra della posizione specificata. Ciò è utile nei controlli di modifica allineati a destra. Questo valore è destinato all'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 avanzamento riga deve essere considerato come una singola parola dalla funzione di callback. Anche due ritorni a capo seguiti da un avanzamento riga devono essere considerati 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 .

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

Rich Edit 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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)