Compartilhar via


CToolBarCtrl::SetRows

Solicita que o controle de barra de ferramentas para redimensionar próprio para o número de linhas solicitado.

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

Parâmetros

  • nRows
    Número de linhas solicitado.

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

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

Comentários

Se a barra de ferramentas não se pode redimensionar ao número ou as linhas solicitado, redimensionar-se-&z válido para o tamanho maior ou menor após a seguir, dependendo do valor de bLarger.Se bLarger é Verdadeiro, o novo número de linhas será maior que o número solicitado.Se bLarger é Falso, o novo número de linhas será menor do 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 para que todas as linhas têm o mesmo número de botões (a não ser que talvez a última linha).Por exemplo, uma barra de ferramentas que contém quatro botões não pôde ser dimensionada a três linhas porque as duas últimas linhas precisariam ser menor.Se você tentou dimensione a três linhas, você obteria quatro linhas se bLarger foi Verdadeiro e duas linhas se bLarger foi Falso.

Se houver separadores na barra de ferramentas, as regras para quando um determinado número de linhas é válida são mais complicadas.Layout é calculado para que os grupos de botões (um botão com separador antes do primeiro botão e o último no grupo) nunca estão divididos em várias linhas a menos que o grupo não pode caber em uma linha.

Se um grupo não couber em uma linha, o grupo será iniciada na próxima linha mesmo se caberia na linha onde o grupo grande terminou.O objetivo de essa regra é fazer a separação entre grandes grupos mais visível.Separadores verticais resultantes são contados como linhas.

Observe também que a função de membro de SetRows escolheu sempre o layout que resulta no menor tamanho da barra de ferramentas.Criando uma barra de ferramentas com o estilo de TBSTYLE_WRAPABLE e então redimensionar o controle irá aplicar apenas o descrito acima método dada a largura do controle.

Essa função só pode ser chamada para barras de ferramentas que foram criados com o estilo de TBSTYLE_WRAPABLE .

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe de CToolBarCtrl

Gráfico de hierarquia

CToolBarCtrl::Create

CToolBarCtrl::GetRows