ToolBar.Wrappable Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

ToolBar.cs

Obtém ou define um valor que indica se os botões da barra de ferramentas encapsulam para a próxima linha se a barra de ferramentas ficar muito pequena para exibir todos os botões na mesma linha.

public:
 property bool Wrappable { bool get(); void set(bool value); };

public bool Wrappable { get; set; }

member this.Wrappable : bool with get, set

Public Property Wrappable As Boolean

Valor da propriedade

Boolean

true se os botões da barra de ferramentas forem encapsulados em outra linha se a barra de ferramentas ficar muito pequena para exibir todos os botões na mesma linha; caso contrário, false. O valor padrão é true.

Exemplos

O exemplo de código a seguir cria um ToolBar controle, define algumas de suas propriedades comuns e adiciona-o a um Form. Delegados também são adicionados aos eventos eButtonDropDown.ButtonClick Este exemplo requer que um ToolBar nomeado toolBar1 e um ImageList nomeado imageList1 tenham sido declarados.

void AddToolBar()
{
   
   // Add a toolbar and set some of its properties.
   toolBar1 = gcnew ToolBar;
   toolBar1->Appearance = System::Windows::Forms::ToolBarAppearance::Flat;
   toolBar1->BorderStyle = System::Windows::Forms::BorderStyle::None;
   toolBar1->Buttons->Add( this->toolBarButton1 );
   toolBar1->ButtonSize = System::Drawing::Size( 24, 24 );
   toolBar1->Divider = true;
   toolBar1->DropDownArrows = true;
   toolBar1->ImageList = this->imageList1;
   toolBar1->ShowToolTips = true;
   toolBar1->Size = System::Drawing::Size( 292, 25 );
   toolBar1->TabIndex = 0;
   toolBar1->TextAlign = System::Windows::Forms::ToolBarTextAlign::Right;
   toolBar1->Wrappable = false;
   
   // Add handlers for the ButtonClick and ButtonDropDown events.
   toolBar1->ButtonDropDown += gcnew ToolBarButtonClickEventHandler( this, &MyToolBar::toolBar1_ButtonDropDown );
   toolBar1->ButtonClick += gcnew ToolBarButtonClickEventHandler( this, &MyToolBar::toolBar1_ButtonClicked );
   
   // Add the toolbar to the form.
   this->Controls->Add( toolBar1 );
}

private void AddToolBar()
{
   // Add a toolbar and set some of its properties.
   toolBar1 = new ToolBar();
   toolBar1.Appearance = System.Windows.Forms.ToolBarAppearance.Flat;
   toolBar1.BorderStyle = System.Windows.Forms.BorderStyle.None;
   toolBar1.Buttons.Add(this.toolBarButton1);
   toolBar1.ButtonSize = new System.Drawing.Size(24, 24);
   toolBar1.Divider = true;
   toolBar1.DropDownArrows = true;
   toolBar1.ImageList = this.imageList1;
   toolBar1.ShowToolTips = true;
   toolBar1.Size = new System.Drawing.Size(292, 25);
   toolBar1.TabIndex = 0;
   toolBar1.TextAlign = System.Windows.Forms.ToolBarTextAlign.Right;
   toolBar1.Wrappable = false;
   
   // Add handlers for the ButtonClick and ButtonDropDown events.
   toolBar1.ButtonDropDown += 
     new ToolBarButtonClickEventHandler(toolBar1_ButtonDropDown);
   toolBar1.ButtonClick += 
     new ToolBarButtonClickEventHandler(toolBar1_ButtonClicked);

   // Add the toolbar to the form.
   this.Controls.Add(toolBar1);
}

Private Sub AddToolBar()
   ' Add a toolbar and set some of its properties.
   toolBar1 = New ToolBar()
   toolBar1.Appearance = System.Windows.Forms.ToolBarAppearance.Flat
   toolBar1.BorderStyle = System.Windows.Forms.BorderStyle.None
   toolBar1.Buttons.Add(Me.toolBarButton1)
   toolBar1.ButtonSize = New System.Drawing.Size(24, 24)
   toolBar1.Divider = True
   toolBar1.DropDownArrows = True
   toolBar1.ImageList = Me.imageList1
   toolBar1.ShowToolTips = True
   toolBar1.Size = New System.Drawing.Size(292, 25)
   toolBar1.TabIndex = 0
   toolBar1.TextAlign = System.Windows.Forms.ToolBarTextAlign.Right
   toolBar1.Wrappable = False

   ' Add handlers for the ButtonClick and ButtonDropDown events.
   AddHandler toolBar1.ButtonDropDown, AddressOf toolBar1_ButtonDropDown
   AddHandler toolBar1.ButtonClick, AddressOf toolBar1_ButtonClicked

   ' Add the toolbar to the form.
   Me.Controls.Add(toolBar1)
End Sub

Comentários

Os botões da barra de ferramentas podem ser divididos em grupos lógicos usando separadores. Um separador é um botão de barra de ferramentas com a Style propriedade definida como ToolBarButtonStyle.Separator. Se a Wrappable propriedade estiver definida true e a barra de ferramentas ficar muito pequena para exibir todos os botões na mesma linha, a barra de ferramentas será dividida em linhas adicionais, com as quebras ocorrendo nos separadores. Isso garante que os grupos de botões permaneçam juntos. Os botões da barra de ferramentas que não estão em um grupo podem ser separados quando a barra de ferramentas é encapsulada. A barra de ferramentas pode ficar muito pequena para exibir todos os botões na mesma linha se o pai Form for redimensionado.

Confira também

• ToolBarButtonStyle