Partager via


CReBarCtrl::InsertBand

Implémente le comportement du message RB_INSERTBANDWin32, comme décrit dans Kit de développement logiciel Windows.

BOOL InsertBand( 
   UINT uIndex, 
   REBARBANDINFO* prbbi  
);

Paramètres

  • uIndex
    Index de base zéro de l'emplacement où la bande sera insérée. Si vous affectez à ce paramètre à -1, le contrôle ajoute la nouvelle bande au dernier emplacement.

  • prbbi
    Un pointeur vers une structure de REBARBANDINFO qui définit la bande à insérer. Vous devez définir le membre d' cbSize de cette structure à sizeof(REBARBANDINFO) avant d'appeler cette fonction.

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon zéro.

Exemple

REBARBANDINFO rbbi = {0};
rbbi.cbSize = sizeof(rbbi);

TCHAR szText[80];
rbbi.lpText = szText;
rbbi.cch = sizeof(szText) / sizeof(szText[0]);

rbbi.fMask = RBBIM_BACKGROUND | RBBIM_CHILD |
    RBBIM_CHILDSIZE | RBBIM_COLORS | RBBIM_HEADERSIZE |
    RBBIM_IDEALSIZE | RBBIM_ID | RBBIM_IMAGE |
    RBBIM_LPARAM | RBBIM_SIZE | RBBIM_STYLE | RBBIM_TEXT;

m_wndReBar.GetReBarCtrl().GetBandInfo(0, &rbbi);

m_wndReBar.GetReBarCtrl().InsertBand(1, &rbbi);      

Configuration requise

Header: afxcmn.h

Voir aussi

Référence

CReBarCtrl, classe

Graphique de la hiérarchie