messaggio TTM_ADJUSTRECT

Calcola il rettangolo di visualizzazione del testo di un controllo descrizione comando dal rettangolo della finestra o dal rettangolo della finestra della descrizione comando necessario per visualizzare un rettangolo di visualizzazione del testo specificato.

Parametri

wParam

Valore che specifica l'operazione da eseguire. Se TRUE, viene usato lParam per specificare un rettangolo di visualizzazione del testo e riceve il rettangolo della finestra corrispondente. Se FALSE, lParam viene usato per specificare un rettangolo di finestra e riceve il rettangolo di visualizzazione del testo corrispondente.

lParam

Struttura RECT per contenere un rettangolo della finestra della descrizione comando o un rettangolo di visualizzazione del testo.

Valore restituito

Restituisce un valore diverso da zero se il rettangolo viene modificato correttamente e restituisce zero se si verifica un errore.

Commenti

Questo messaggio è particolarmente utile quando si desidera utilizzare un controllo descrizione comando per visualizzare il testo completo di una stringa che viene in genere troncata. Viene comunemente usato con controlli listview e treeview. Questo messaggio viene in genere inviato in risposta a un codice di notifica TTN_SHOW in modo da poter posizionare correttamente il controllo descrizione comando.

Il rettangolo della finestra della descrizione comando è leggermente più grande del rettangolo di visualizzazione del testo che delimita la stringa della descrizione comando. Anche l'origine della finestra viene spostata verso l'alto e verso sinistra dall'origine del rettangolo di visualizzazione del testo. Per posizionare il rettangolo di visualizzazione del testo, è necessario calcolare il rettangolo della finestra corrispondente e usare tale rettangolo per posizionare la descrizione comando. TTM_ADJUSTRECT gestisce automaticamente questo calcolo.

Se si imposta wParam su TRUE, TTM_ADJUSTRECT accetta le dimensioni e la posizione del rettangolo di visualizzazione del testo della descrizione comando desiderato e passa indietro le dimensioni e la posizione della finestra della descrizione comando necessaria per visualizzare il testo nella posizione specificata. Se si imposta wParam su FALSE, è possibile specificare un rettangolo della finestra della descrizione comando e TTM_ADJUSTRECT restituirà le dimensioni e la posizione del relativo rettangolo di testo.

Il frammento di codice seguente illustra l'uso del messaggio TTM_ADJUSTRECT per posizionare un controllo descrizione comando per visualizzare il testo completo della stringa di un controllo al posto di una stringa troncata. La funzione GetMyItemRect definita dall'applicazione restituisce il rettangolo di testo che sarà necessario per visualizzare il testo della descrizione comando direttamente sulla stringa troncata. I dettagli del modo in cui questa funzione viene implementata dipenderanno dal controllo specifico. TTM_ADJUSTRECT viene usato per inviare questo rettangolo di testo al controllo della descrizione comando. Restituisce un rettangolo di finestra con dimensioni appropriate e posizionate che viene quindi utilizzato per posizionare la finestra della descrizione comando.

case TTN_SHOW:

if (MyStringIsTruncated) {
    RECT rc;
    
    GetMyItemRect(&rc);
    SendMessage(hwndToolTip, TTM_ADJUSTRECT, TRUE, (LPARAM)&rc);
    SetWindowPos(hwndToolTip,
                 NULL,
                 rc.left, rc.top,
                 0, 0,
                 SWP_NOSIZE|SWP_NOZORDER|SWP_NOACTIVATE);
} 

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Commctrl.h