CToolBarCtrl::SetRows
Demande au contrôle de barre d'outils de se redimensionner le nombre de lignes demandé.
void SetRows(
int nRows,
BOOL bLarger,
LPRECT lpRect
);
Paramètres
nRows
Nombre de lignes demandé.bLarger
Indique s'il faut utiliser plus de lignes ou moins lignes si la barre d'outils ne peut pas être redimensionné au nombre de lignes demandé.lpRect
Pointe vers l'objet de CRect ou à la structure de RECT qui recevront le nouveau rectangle englobant de la barre d'outils.
Notes
Si la barre d'outils ne peut pas se redimensionner au nombre ou aux lignes demandé, il se redimensionnera à la prochaine plus grande ou ensuite plus petite taille valide, selon la valeur d' bLarger.Si bLarger est TRUE, le nouveau nombre de lignes est supérieur au nombre demandé.Si bLarger est FALSE, le nouveau nombre de lignes est inférieur au nombre demandé.
Un nombre donné de lignes est valide pour la barre d'outils si les boutons peuvent être organisés tels que toutes les lignes ont le même nombre de boutons (sauf peut-être la dernière ligne).Par exemple, une barre d'outils qui contient quatre boutons ne peut pas être classée à trois lignes parce que les deux dernières lignes doivent être plus courtes.Si vous tentiez de la redimensionner à trois lignes, vous obtiendriez quatre lignes si bLarger a été TRUE et deux lignes si bLarger a été FALSE.
Si des séparateurs dans la barre d'outils, les règles pour lorsqu'un nombre donné de lignes est valide sont plus complexes.La disposition est calculée tels que les groupes de boutons (boutons avec un séparateur avant que le premier et le dernier bouton dans le groupe) ne sont jamais interrompus sur plusieurs lignes à moins que le groupe ne peut pas figurer sur une ligne.
Si un groupe ne tient pas dans une ligne, le groupe démarre sur la ligne même s'il s'adapterait sur la ligne où le grand groupe est terminé.L'objectif de cette règle est de rendre la séparation entre des grands groupes plus apparente.Les séparateurs verticaux résultantes sont comptés comme lignes.
Notez également que la fonction membre d' SetRows a toujours sélectionnez la disposition qui entraîne la plus petite taille de barre d'outils.Création d'une barre d'outils avec le style d' TBSTYLE_WRAPABLE puis redimensionnement le contrôle applique seulement ce qui précède présentée lignes par méthode donné la largeur du contrôle.
Cette fonction peut être appelée pour les barres d'outils qui ont été créées avec le style d' TBSTYLE_WRAPABLE .
Configuration requise
Header: afxcmn.h