messaggio EM_SETRECT

Imposta il rettangolo di formattazione di un controllo di modifica su più righe. Il rettangolo di formattazione è il rettangolo di limitazione in cui il controllo disegna il testo. Il rettangolo di limitazione è indipendente dalle dimensioni della finestra di controllo di modifica.

Questo messaggio viene elaborato solo dai controlli di modifica su più righe. È possibile inviare questo messaggio a un controllo di modifica o a un controllo di modifica avanzato.

Parametri

wParam

Rich Edit 2.0 e versioni successive: Indica se lParam specifica coordinate assolute o relative. Un valore pari a zero indica le coordinate assolute. Il valore 1 indica gli offset relativi al rettangolo di formattazione corrente. Gli offset possono essere positivi o negativi.

Modifica controlli e Modifica avanzata 1.0: Questo parametro non viene usato e deve essere zero.

lParam

Puntatore a una struttura RECT che specifica le nuove dimensioni del rettangolo. Se questo parametro è NULL, il rettangolo di formattazione viene impostato sui valori predefiniti.

Valore restituito

Questo messaggio non restituisce un valore.

Commenti

L'impostazione di lParam su NULL non ha alcun effetto se è installato un dispositivo touch o se EM_SETRECT viene inviato da un thread in cui è installato un hook (vedere SetWindowsHookEx). In questi casi , lParam deve contenere un puntatore valido a una struttura RECT .

Il messaggio EM_SETRECT fa sì che il testo del controllo di modifica venga ridisegnato. Per modificare le dimensioni del rettangolo di formattazione senza ridisegnare il testo, usare il messaggio EM_SETRECTNP .

Quando viene creato per la prima volta un controllo di modifica, il rettangolo di formattazione viene impostato su una dimensione predefinita. È possibile usare il messaggio di EM_SETRECT per ingrandire o rendere il rettangolo di formattazione maggiore o inferiore alla finestra di controllo di modifica.

Se il controllo di modifica non dispone di una barra di scorrimento orizzontale e il rettangolo di formattazione è impostato su maggiore della finestra del controllo di modifica, le righe di testo che superano la larghezza della finestra di controllo di modifica ,ma inferiori alla larghezza del rettangolo di formattazione, vengono ritagliate anziché incapsulate.

Se il controllo di modifica contiene un bordo, il rettangolo di formattazione viene ridotto dalle dimensioni del bordo. Se si modifica il rettangolo restituito da un messaggio di EM_GETRECT , è necessario rimuovere le dimensioni del bordo prima di utilizzare il rettangolo con il messaggio EM_SETRECT .

Rich Edit:Rich Edit: Supportato in Microsoft Rich Edit 1.0 e versioni successive. Il rettangolo di formattazione non include la barra di selezione, ovvero un'area non contrassegnata a sinistra di ogni paragrafo. Quando l'utente fa clic sulla barra di selezione, viene selezionata la riga corrispondente. Per informazioni sulla compatibilità delle versioni di modifica avanzate con le varie versioni di sistema, vedere Informazioni sui controlli rich Edit.

Requisiti

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

Vedi anche

Riferimento

EM_GETRECT

EM_SETRECTNP

Altre risorse

RECT