Condividi tramite


CToolBarCtrl::SetRows

Chiede al controllo della barra degli strumenti in base al numero di righe richiesto.

void SetRows( 
   int nRows, 
   BOOL bLarger, 
   LPRECT lpRect  
);

Parametri

  • nRows
    Numero di righe richiesto.

  • bLarger
    Indica se utilizzare più righe o meno righe se la barra degli strumenti non può essere ridimensionata al numero di righe richiesto.

  • lpRect
    Punti all'oggetto CRect o alla struttura RECT che riceverà un nuovo rettangolo di delimitazione di una barra degli strumenti.

Note

Se la barra degli strumenti non può base al numero o le righe richiesto, verrà eseguito a più grande o dopo più piccola dimensione valida seguente, a seconda del valore bLarger. Se bLarger è TRUE, il nuovo numero di righe sarà maggiore del numero richiesto. Se bLarger è FALSE, il nuovo numero di righe sarà inferiore al numero richiesto.

Un numero specificato delle righe è valido per la barra degli strumenti se i pulsanti possono essere ordinati in modo che tutte le righe hanno lo stesso numero di pulsanti (eccetto nell'ultima riga). Ad esempio, una barra degli strumenti che contiene quattro pulsanti non può essere ridimensionata a tre righe nelle ultime due righe avrebbero dovuto essere più brevi. Se tentaste di ridimensionarlo a tre righe, si otterrebbe quattro righe bLarger se è stato TRUE e due righe bLarger se è stato FALSE.

Se esistono separatori nella barra degli strumenti, le regole relative a un determinato numero di righe è valido sono più complesse. Il layout è calcolato in modo che i gruppi di pulsanti (pulsanti con un separatore prima del primo e l'ultimo pulsante nel gruppo non vengano mai bloccati su su più righe a meno che il gruppo non possa adattarsi a una riga.

Se un gruppo non si estende su una riga, il gruppo seguente verrà avviato nella riga seguente anche se si adatterebbe sulla riga in cui il big gruppo è terminata. Lo scopo di questa regola è di creare la separazione tra grandi gruppi più evidente. I separatori verticali risultanti vengono considerati come righe.

Si noti inoltre che la funzione membro SetRows sempre scelti il layout che comporta la più piccola dimensione della barra degli strumenti. Creazione di una barra degli strumenti con lo stile TBSTYLE_WRAPABLE quindi il ridimensionamento del controllo applicherà semplicemente il di sopra descritto metodo specificando la larghezza del controllo.

Questa funzione può essere chiamato solo per le barre degli strumenti create con lo stile TBSTYLE_WRAPABLE.

Requisiti

Header: afxcmn.h

Vedere anche

Riferimenti

Classe CToolBarCtrl

Grafico delle gerarchie

CToolBarCtrl::Create

CToolBarCtrl::GetRows