privatevoid 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 CRect objeto ou estrutura RECT que receberá o novo Retangular delimitador da barra de ferramentas.
Observações
Chame essa função para solicitar o controle de barra de ferramentas para redimensionar próprio para o número de linhas solicitado.
Se a barra de ferramentas não é possível redimensionar próprio para o número solicitado de linhas, ele irá redimensionar próprio quer o próximo maior ou próximo menor tamanho válido, dependendo do valor de bLarger. Se bLarger for TRUE, o novo número de linhas será maior que o número solicitado. Se bLarger for FALSE, 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 tal que todas as linhas têm o mesmo número de botões (exceto talvez a última linha). Por exemplo, uma barra de ferramentas contém quatro botões não poderia ser dimensionada para três linhas porque as duas últimas linhas teria que ser mais curto. Se você tentou fazer seu tamanho para três linhas, você teria quatro linhas se bLarger era verdadeiro e duas linhas se bLarger era falso.
Se existem separadores na barra de ferramentas, as regras para quando um determinado número de linhas é válido são mais complicadas. O layout é computado tal que grupos de botão (botões com um separador antes do primeiro) e o último botão no grupo nunca são divididos em várias linhas a menos que o grupo não couber em uma linha.
Se um grupo não couber em uma linha, o próximo grupo começará na próxima linha mesmo se ele se encaixaria na linha onde terminou o grande grupo. A finalidade desta regra é fazer a separação entre os grandes grupos mais perceptíveis. Os separadores verticais resultantes são contados como linhas.
Observe também que a função de membro SetRows será sempre escolheu o layout que resulta no menor tamanho de barra de ferramentas. Criar uma barra de ferramentas com o estilo TBSTYLE_WRAPABLE e, em seguida, o Controlarar de redimensionamento simplesmente aplicará o método esboçado acima, tendo em conta a largura do controle.
Esta função só pode ser chamada para barras de ferramentas que foram criadas com o estilo TBSTYLE_WRAPABLE.
Visão geral de CToolBarCtrl | Membros de classe | Gráfico de hierarquia
Co&nsulte tambémnbsp; Estilos de barra de ferramentas em CToolBarCtrl::Create, CToolBarCtrl::GetRows