LToolbar::SetRows

#include "ltwrappr.h"

L_INT LToolbar::SetRows (nRows)

L_INT nRows;

/* number of rows */

Sets the number of rows of buttons in the toolbar.

Parameter

Description

nRows

Number of rows requested. The minimum number of rows is one, and the maximum number of rows is equal to the number of buttons in the toolbar.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Buttons are arranged on the rows from left to right.

To determine the current number of rows set, call LToolbar::GetRows.

Required DLLs and Libraries

LTTLB

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

LToolbar::GetRows, Class Members

Topics:

Getting and Setting Toolbar Characteristics

Example

This example gets the current number of rows in the toolbar. If it is not 2, then it will make 2 rows.

L_INT LToolbar__SetRowsExample(LToolbar* tlb)
{
   if ( tlb->IsValid () ) /* check the validity of the toolbar handle */
   {
      L_INT nRow ;
      /* Get the number of rows in the toolbar */
      nRow = tlb->GetRows () ;
      if ( nRow != 2 )
      {
         /* Set the number of rows to 2 */
         tlb->SetRows (2 ) ;
      }
   }
   else
   {
      return FAILURE ;
   }
   return SUCCESS;
}