Compartilhar via


CToolBarCtrl::SetRows

Solicita que o controle de barra de ferramentas se redimensiona o número de linhas solicitado.

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

Parâmetros

  • nRows
    Número de linhas solicitado.

  • bLarger
    Informa ao se usar linhas mais ou menos linhas se a barra de ferramentas não pode ser redimensionada para o número de linhas solicitado.

  • lpRect
    Aponta para o CRect objeto ou RECT estrutura que receberá o novo retângulo delimitador da barra de ferramentas.

Comentários

Se a barra de ferramentas não é possível redimensionar próprio para o número solicitado ou linhas, ela passará a redimensionar-se de dimensionar ou o próximo maior ou o próximo menor válido dimensionar, dependendo do valor de bLarger. If bLarger é TRUE, o novo número de linhas será maior que o número solicitado.If bLarger é FALSE, o novo número de linhas serão menor que o número solicitado.

Um determinado número de linhas é válido para a barra de ferramentas se os botões podem ser organizados de tal forma que todas as linhas tenham o mesmo número de botões (exceto talvez a última linha).Por exemplo, uma barra de ferramentas que contém quatro botões não pode ser ajustada para três linhas porque as duas últimas linhas teriam que ser menor.Se você tentou dimensioná-lo para três linhas, você obteria quatro linhas se bLarger foi TRUE e duas linhas se bLarger foi FALSE.

Se houver separadores na barra de ferramentas, as regras para quando um determinado número de linhas estiver válido são mais complicadas.O layout é calculado de modo que o botão grupos (botões com um separador antes do primeiro) e o último botão no agrupar são nunca divididos em várias linhas, a menos que o agrupar não couberem em uma linha.

Se um agrupar não cabe em uma linha, o próximo agrupar será iniciado na próxima linha, mesmo se ele deve se ajuste na linha onde grande agrupar foi encerrado.A finalidade dessa regra é tornar a separação entre grupos grandes mais perceptíveis.sistema autônomo separadores verticais resultantes são contados sistema autônomo linhas.

Observe também que o SetRows função de membro será sempre escolheu o layout que resultados no menor dimensionar de barra de ferramentas. Criar uma barra de ferramentas com o TBSTYLE_WRAPABLE estilo e, em seguida, redimensionar o controle serão simplesmente aplicar o método descrito acima, dada a largura do controle.

Esta função só pode ser chamada para as barras de ferramentas que foram criadas com o TBSTYLE_WRAPABLE estilo.

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe CToolBarCtrl

Gráfico de hierarquia

CToolBarCtrl::criar

CToolBarCtrl::GetRows

Outros recursos

CToolBarCtrl membros