ToolBar.Wrappable Свойство

Определение

Возвращает или задает значение, указывающее, переносятся ли кнопки панели инструментов на следующую строку, если размер панели инструментов становится недостаточным для отображения всех кнопок в одной строке.

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

Значение свойства

Значение true, если кнопки панели инструментов переносятся на другую строку, когда размер панели инструментов становится недостаточным для отображения всех кнопок в одной строке. В противном случае — значение false. Значение по умолчанию — true.

Примеры

В следующем примере кода создается ToolBar элемент управления, задаются некоторые его общие свойства и добавляется в Form. Делегаты также добавляются в ButtonClick события и ButtonDropDown . В этом примере требуется, чтобы ToolBar были объявлены именованные toolBar1 и ImageList именованные imageList1 .

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

Комментарии

Кнопки панели инструментов можно разделить на логические группы с помощью разделителя. Разделитель — это кнопка панели инструментов со свойством Style, имеющим значение ToolBarButtonStyle.Separator. Если свойству Wrappable присвоено значение true , а панель инструментов становится слишком маленькой для отображения всех кнопок в одной строке, панель инструментов разбивается на дополнительные строки с разрывами, происходящими в разделителях. Это гарантирует, что группы кнопок остаются вместе. Кнопки панели инструментов, которые не входят в группу, можно разделять при переносе панели инструментов. Панель инструментов может стать слишком маленькой, чтобы отобразить все свои кнопки в одной строке, если размер ее родительского элемента Form изменен.

Применяется к

См. также раздел