ToolStripProgressBar Класс

Определение

Представляет элемент управления "индикатор выполнения Windows", содержащийся в объекте StatusStrip.Represents a Windows progress bar control contained in a StatusStrip.

public ref class ToolStripProgressBar : System::Windows::Forms::ToolStripControlHost
public class ToolStripProgressBar : System.Windows.Forms.ToolStripControlHost
type ToolStripProgressBar = class
    inherit ToolStripControlHost
Public Class ToolStripProgressBar
Inherits ToolStripControlHost
Наследование

Примеры

В следующем примере кода демонстрируется ToolStripProgressBar, который вычисляет последовательность чисел Фибоначчи.The following code example demonstrates a ToolStripProgressBar that calculates a sequence of Fibonacci numbers.

using System;
using System.Collections.Generic;
using System.Windows.Forms;
using System.ComponentModel;

class FibonacciNumber : Form
{
    [STAThread]
    static void Main()
    {
        Application.EnableVisualStyles();
        Application.Run(new FibonacciNumber());
    }

    private StatusStrip progressStatusStrip;
    private ToolStripProgressBar toolStripProgressBar;
    private NumericUpDown requestedCountControl;
    private Button goButton;
    private TextBox outputTextBox;
    private BackgroundWorker backgroundWorker;
    private ToolStripStatusLabel toolStripStatusLabel;
    private int requestedCount;

    public FibonacciNumber()
    {
        Text = "Fibonacci";
        
        // Prepare the StatusStrip.
        progressStatusStrip = new StatusStrip();
        toolStripProgressBar = new ToolStripProgressBar();
        toolStripProgressBar.Enabled = false;
        toolStripStatusLabel = new ToolStripStatusLabel();
        progressStatusStrip.Items.Add(toolStripProgressBar);
        progressStatusStrip.Items.Add(toolStripStatusLabel);

        FlowLayoutPanel flp = new FlowLayoutPanel();
        flp.Dock = DockStyle.Top;

        Label beforeLabel = new Label();
        beforeLabel.Text = "Calculate the first ";
        beforeLabel.AutoSize = true;
        flp.Controls.Add(beforeLabel);
        requestedCountControl = new NumericUpDown();
        requestedCountControl.Maximum = 1000;
        requestedCountControl.Minimum = 1;
        requestedCountControl.Value = 100;
        flp.Controls.Add(requestedCountControl);
        Label afterLabel = new Label();
        afterLabel.Text = "Numbers in the Fibonacci sequence.";
        afterLabel.AutoSize = true;
        flp.Controls.Add(afterLabel);
        
        goButton = new Button();
        goButton.Text = "&Go";
        goButton.Click += new System.EventHandler(button1_Click);
        flp.Controls.Add(goButton);

        outputTextBox = new TextBox();
        outputTextBox.Multiline = true;
        outputTextBox.ReadOnly = true;
        outputTextBox.ScrollBars = ScrollBars.Vertical;
        outputTextBox.Dock = DockStyle.Fill;

        Controls.Add(outputTextBox);
        Controls.Add(progressStatusStrip);
        Controls.Add(flp);

        backgroundWorker = new BackgroundWorker();
        backgroundWorker.WorkerReportsProgress = true;
        backgroundWorker.DoWork += new DoWorkEventHandler(backgroundWorker1_DoWork);
        backgroundWorker.RunWorkerCompleted += new RunWorkerCompletedEventHandler(backgroundWorker1_RunWorkerCompleted);
        backgroundWorker.ProgressChanged += new ProgressChangedEventHandler(backgroundWorker1_ProgressChanged);
    }

    private void backgroundWorker1_DoWork(object sender, DoWorkEventArgs e)
    {
        // This method will run on a thread other than the UI thread.
        // Be sure not to manipulate any Windows Forms controls created
        // on the UI thread from this method.
        backgroundWorker.ReportProgress(0, "Working...");
        Decimal lastlast = 0;
        Decimal last = 1;
        Decimal current;
        if (requestedCount >= 1)
        { AppendNumber(0); }
        if (requestedCount >= 2)
        { AppendNumber(1); }
        for (int i = 2; i < requestedCount; ++i)
        {
            // Calculate the number.
            checked { current = lastlast + last; }
            // Introduce some delay to simulate a more complicated calculation.
            System.Threading.Thread.Sleep(100);
            AppendNumber(current);
            backgroundWorker.ReportProgress((100 * i) / requestedCount, "Working...");
            // Get ready for the next iteration.
            lastlast = last;
            last = current;
        }

        backgroundWorker.ReportProgress(100, "Complete!");
    }

    private delegate void AppendNumberDelegate(Decimal number);
    private void AppendNumber(Decimal number)
    {
        if (outputTextBox.InvokeRequired)
        { outputTextBox.Invoke(new AppendNumberDelegate(AppendNumber), number); }
        else
        { outputTextBox.AppendText(number.ToString("N0") + Environment.NewLine); }
    }
    private void backgroundWorker1_ProgressChanged(object sender, ProgressChangedEventArgs e)
    {
        toolStripProgressBar.Value = e.ProgressPercentage;
        toolStripStatusLabel.Text = e.UserState as String;
    }

    private void backgroundWorker1_RunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
    {
        if (e.Error is OverflowException)
        { outputTextBox.AppendText(Environment.NewLine + "**OVERFLOW ERROR, number is too large to be represented by the decimal data type**"); }
        toolStripProgressBar.Enabled = false;
        requestedCountControl.Enabled = true;
        goButton.Enabled = true;
    }

    private void button1_Click(object sender, EventArgs e)
    {
        goButton.Enabled = false;
        toolStripProgressBar.Enabled = true;
        requestedCount = (int)requestedCountControl.Value;
        requestedCountControl.Enabled = false;
        outputTextBox.Clear();
        backgroundWorker.RunWorkerAsync();
    }
}
Imports System.Collections.Generic
Imports System.Windows.Forms
Imports System.ComponentModel



Class FibonacciNumber
   Inherits Form
   
   <STAThread()>  _
   Shared Sub Main()
      Application.EnableVisualStyles()
      Application.Run(New FibonacciNumber())
   End Sub    
   Private progressStatusStrip As StatusStrip
   Private toolStripProgressBar As ToolStripProgressBar
   Private requestedCountControl As NumericUpDown
   Private goButton As Button
   Private outputTextBox As TextBox
   Private backgroundWorker As BackgroundWorker
   Private toolStripStatusLabel As ToolStripStatusLabel
   Private requestedCount As Integer
   
   
   Public Sub New()
      [Text] = "Fibonacci"
      
      ' Prepare the StatusStrip.
      progressStatusStrip = New StatusStrip()
      toolStripProgressBar = New ToolStripProgressBar()
      toolStripProgressBar.Enabled = False
      toolStripStatusLabel = New ToolStripStatusLabel()
      progressStatusStrip.Items.Add(toolStripProgressBar)
      progressStatusStrip.Items.Add(toolStripStatusLabel)
      
      Dim flp As New FlowLayoutPanel()
      flp.Dock = DockStyle.Top
      
      Dim beforeLabel As New Label()
      beforeLabel.Text = "Calculate the first "
      beforeLabel.AutoSize = True
      flp.Controls.Add(beforeLabel)
      requestedCountControl = New NumericUpDown()
      requestedCountControl.Maximum = 1000
      requestedCountControl.Minimum = 1
      requestedCountControl.Value = 100
      flp.Controls.Add(requestedCountControl)
      Dim afterLabel As New Label()
      afterLabel.Text = "Numbers in the Fibonacci sequence."
      afterLabel.AutoSize = True
      flp.Controls.Add(afterLabel)
      
      goButton = New Button()
      goButton.Text = "&Go"
      AddHandler goButton.Click, AddressOf button1_Click
      flp.Controls.Add(goButton)
      
      outputTextBox = New TextBox()
      outputTextBox.Multiline = True
      outputTextBox.ReadOnly = True
      outputTextBox.ScrollBars = ScrollBars.Vertical
      outputTextBox.Dock = DockStyle.Fill
      
      Controls.Add(outputTextBox)
      Controls.Add(progressStatusStrip)
      Controls.Add(flp)
      
      backgroundWorker = New BackgroundWorker()
      backgroundWorker.WorkerReportsProgress = True
      AddHandler backgroundWorker.DoWork, AddressOf backgroundWorker1_DoWork
      AddHandler backgroundWorker.RunWorkerCompleted, AddressOf backgroundWorker1_RunWorkerCompleted
      AddHandler backgroundWorker.ProgressChanged, AddressOf backgroundWorker1_ProgressChanged
   End Sub 
    
   
   Private Sub backgroundWorker1_DoWork(sender As Object, e As DoWorkEventArgs)
      ' This method will run on a thread other than the UI thread.
      ' Be sure not to manipulate any Windows Forms controls created
      ' on the UI thread from this method.
      backgroundWorker.ReportProgress(0, "Working...")
      Dim lastlast As [Decimal] = 0
      Dim last As [Decimal] = 1
      Dim current As [Decimal]
      If requestedCount >= 1 Then
         AppendNumber(0)
      End If
      If requestedCount >= 2 Then
         AppendNumber(1)
      End If
      Dim i As Integer
      
      While i < requestedCount
         ' Calculate the number.
         current = lastlast + last
         ' Introduce some delay to simulate a more complicated calculation.
         System.Threading.Thread.Sleep(100)
         AppendNumber(current)
         backgroundWorker.ReportProgress(100 * i / requestedCount, "Working...")
         ' Get ready for the next iteration.
         lastlast = last
         last = current
         i += 1
      End While
      
      
      backgroundWorker.ReportProgress(100, "Complete!")
    End Sub
   
   
   Delegate Sub AppendNumberDelegate(number As [Decimal])
   
   Private Sub AppendNumber(number As [Decimal])
      If outputTextBox.InvokeRequired Then
         outputTextBox.Invoke(New AppendNumberDelegate(AddressOf AppendNumber), number)
      Else
         outputTextBox.AppendText((number.ToString("N0") + Environment.NewLine))
      End If
   End Sub 
   Private Sub backgroundWorker1_ProgressChanged(sender As Object, e As ProgressChangedEventArgs)
      toolStripProgressBar.Value = e.ProgressPercentage
      toolStripStatusLabel.Text = e.UserState '
   End Sub 
   
   
   Private Sub backgroundWorker1_RunWorkerCompleted(sender As Object, e As RunWorkerCompletedEventArgs)
      If TypeOf e.Error Is OverflowException Then
         outputTextBox.AppendText((Environment.NewLine + "**OVERFLOW ERROR, number is too large to be represented by the decimal data type**"))
      End If
      toolStripProgressBar.Enabled = False
      requestedCountControl.Enabled = True
      goButton.Enabled = True
   End Sub 
    
   
   Private Sub button1_Click(sender As Object, e As EventArgs)
      goButton.Enabled = False
      toolStripProgressBar.Enabled = True
      requestedCount = Fix(requestedCountControl.Value)
      requestedCountControl.Enabled = False
      outputTextBox.Clear()
      backgroundWorker.RunWorkerAsync()
   End Sub 
End Class 

Комментарии

ToolStripProgressBar — это ProgressBar, оптимизированный для размещения в ToolStrip.ToolStripProgressBar is the ProgressBar optimized for hosting in a ToolStrip. Подмножество свойств и событий размещаемого элемента управления предоставляется на уровне ToolStripProgressBar, но базовый элемент управления ProgressBar полностью доступен через свойство ProgressBar.A subset of the hosted control's properties and events are exposed at the ToolStripProgressBar level, but the underlying ProgressBar control is fully accessible through the ProgressBar property.

Элемент управления ToolStripProgressBar визуально показывает ход выполнения длительной операции.A ToolStripProgressBar control visually indicates the progress of a lengthy operation. Элемент управления ToolStripProgressBar отображает панель, которая заполняется слева направо цветом выделения системы по мере выполнения операции.The ToolStripProgressBar control displays a bar that fills in from left to right with the system highlight color as an operation progresses.

Примечание

Элемент управления ToolStripProgressBar может быть ориентирован только горизонтально.The ToolStripProgressBar control can only be oriented horizontally.

Элемент управления ToolStripProgressBar обычно используется, когда приложение выполняет такие задачи, как копирование файлов или печать документов.The ToolStripProgressBar control is typically used when an application performs tasks such as copying files or printing documents. Пользователи приложения могут считать, что приложение не отвечает, если визуальные подсказки отсутствуют.Users of an application might consider an application unresponsive if there is no visual cue. Используйте ToolStripProgressBar, чтобы уведомить пользователя о выполнении длительной задачи, а также о том, что приложение по-прежнему отвечает.Use the ToolStripProgressBar to notify the user that the application is performing a lengthy task and that the application is still responding.

Свойства Maximum и Minimum определяют диапазон значений, представляющих ход выполнения задачи.The Maximum and Minimum properties define the range of values to represent the progress of a task. Свойству Minimum обычно присваивается нулевое значение, а свойству Maximum обычно присваивается значение, указывающее на завершение задачи.The Minimum property is typically set to a value of zero, and the Maximum property is typically set to a value indicating the completion of a task. Например, чтобы правильно отобразить ход выполнения при копировании группы файлов, свойству Maximum может быть присвоено общее число копируемых файлов.For example, to display the progress properly when copying a group of files, the Maximum property could be set to the total number of files to be copied. Свойство Value представляет ход выполнения, выполняемый приложением для завершения операции.The Value property represents the progress that the application has made toward completing the operation. Так как панель, отображаемая в элементе управления, является коллекцией блоков, значение, отображаемое ToolStripProgressBar, лишь приблизительно отражает текущее значение свойства Value.Because the bar displayed in the control is a collection of blocks, the value displayed by the ToolStripProgressBar only approximates the Value property's current value. В зависимости от размера ToolStripProgressBarсвойство Value определяет, когда следует отображать следующий блок.Based on the size of the ToolStripProgressBar, the Value property determines when to display the next block.

Существует несколько способов изменения значения, отображаемого ToolStripProgressBar, отличного от прямого изменения свойства Value.There are a number of ways to modify the value displayed by the ToolStripProgressBar other than changing the Value property directly. Можно использовать свойство Step, чтобы указать конкретное значение, увеличивающее Value свойство по, а затем вызвать метод PerformStep, чтобы увеличить значение.You can use the Step property to specify a specific value to increment the Value property by, and then call the PerformStep method to increment the value. Чтобы изменить значение приращения, можно использовать метод Increment и указать значение, по которому нужно увеличить свойство Value.To vary the increment value, you can use the Increment method and specify a value by which to increment the Value property.

ToolStripProgressBar заменяет старый элемент управления ProgressBar, который, тем не менее, сохраняется для обеспечения обратной совместимости.ToolStripProgressBar replaces the older ProgressBar control, which is nevertheless retained for backward compatibility.

Конструкторы

ToolStripProgressBar()

Инициализация нового экземпляра класса ToolStripProgressBar.Initializes a new instance of the ToolStripProgressBar class.

ToolStripProgressBar(String)

Инициализирует новый экземпляр класса ToolStripProgressBar с указанным именем.Initializes a new instance of the ToolStripProgressBar class with specified name.

Свойства

AccessibilityObject

Получает объект AccessibleObject, назначенный элементу управления.Gets the AccessibleObject assigned to the control.

(Унаследовано от ToolStripItem)
AccessibleDefaultActionDescription

Возвращает или задает описание выполняемого по умолчанию действия элемента управления для использования клиентскими приложениями со специальными возможностями.Gets or sets the default action description of the control for use by accessibility client applications.

(Унаследовано от ToolStripItem)
AccessibleDescription

Возвращает или задает описание, которое будет сообщено клиентским приложениям со специальными возможностями.Gets or sets the description that will be reported to accessibility client applications.

(Унаследовано от ToolStripItem)
AccessibleName

Возвращает или задает имя элемента управления, используемого клиентскими приложениями со специальными возможностями.Gets or sets the name of the control for use by accessibility client applications.

(Унаследовано от ToolStripItem)
AccessibleRole

Возвращает или задает роль элемента управления в поддержке специальных возможностей, которая указывает тип элемента пользовательского интерфейса для данного элемента управления.Gets or sets the accessible role of the control, which specifies the type of user interface element of the control.

(Унаследовано от ToolStripItem)
Alignment

Получает или задает значение, указывающее, выравнивается ли элемент по началу или по концу элемента ToolStrip.Gets or sets a value indicating whether the item aligns towards the beginning or end of the ToolStrip.

(Унаследовано от ToolStripItem)
AllowDrop

Возвращает или задает значение, указывающее, будут ли операции перетаскивания и переупорядочения элементов обрабатываться с помощью событий, реализованных пользователем.Gets or sets a value indicating whether drag-and-drop and item reordering are handled through events that you implement.

(Унаследовано от ToolStripItem)
Anchor

Возвращает или задает границы контейнера, с которым связан объект ToolStripItem, и определяет, как изменяются размеры объекта ToolStripItem вместе с родительским объектом.Gets or sets the edges of the container to which a ToolStripItem is bound and determines how a ToolStripItem is resized with its parent.

(Унаследовано от ToolStripItem)
AutoSize

Возвращает или задает значение, указывающее, производится ли автоматическое изменение размеров элемента.Gets or sets a value indicating whether the item is automatically sized.

(Унаследовано от ToolStripItem)
AutoToolTip

Получает или задает значение, указывающее, следует ли использовать свойство Text или свойство ToolTipText для подсказки ToolStripItem.Gets or sets a value indicating whether to use the Text property or the ToolTipText property for the ToolStripItem ToolTip.

(Унаследовано от ToolStripItem)
Available

Получает или задает значение, указывающее, нужно ли помещать ToolStripItem в ToolStrip.Gets or sets a value indicating whether the ToolStripItem should be placed on a ToolStrip.

(Унаследовано от ToolStripItem)
BackColor

Возвращает или задает цвет фона для элемента управления.Gets or sets the background color for the control.

(Унаследовано от ToolStripControlHost)
BackgroundImage

Данное свойство не применимо к этому классу.This property is not relevant to this class.

BackgroundImageLayout

Данное свойство не применимо к этому классу.This property is not relevant to this class.

Bounds

Возвращает размер и расположение элемента.Gets the size and location of the item.

(Унаследовано от ToolStripItem)
CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.Gets a value indicating whether the component can raise an event.

(Унаследовано от Component)
CanSelect

Возвращает значение, указывающее, доступен ли элемент управления для выбора.Gets a value indicating whether the control can be selected.

(Унаследовано от ToolStripControlHost)
CausesValidation

Получает или задает значение, показывающее, вызывает ли размещенный элемент управления события проверки для других элементов управления при получении фокуса этим размещенным элементом управления.Gets or sets a value indicating whether the hosted control causes and raises validation events on other controls when the hosted control receives focus.

(Унаследовано от ToolStripControlHost)
Container

Возвращает контейнер IContainer, содержащий компонент Component.Gets the IContainer that contains the Component.

(Унаследовано от Component)
ContentRectangle

Получает область, в которой содержимое, например текст и значки, могут быть помещены в ToolStripItem без перезаписи границ фона.Gets the area where content, such as text and icons, can be placed within a ToolStripItem without overwriting background borders.

(Унаследовано от ToolStripItem)
Control

Получает класс Control, размещенный в данном классе ToolStripControlHost.Gets the Control that this ToolStripControlHost is hosting.

(Унаследовано от ToolStripControlHost)
ControlAlign

Возвращает или задает выравнивание элемента управления в форме.Gets or sets the alignment of the control on the form.

(Унаследовано от ToolStripControlHost)
DefaultAutoToolTip

Получает значение, указывающее, должен ли отображаться объект ToolTip, который определен по умолчанию.Gets a value indicating whether to display the ToolTip that is defined as the default.

(Унаследовано от ToolStripItem)
DefaultDisplayStyle

Получает значение, указывающее, что отображается в ToolStripItem.Gets a value indicating what is displayed on the ToolStripItem.

(Унаследовано от ToolStripItem)
DefaultMargin

Получает расстояние между объектом ToolStripProgressBar и прилегающими элементами.Gets the spacing between the ToolStripProgressBar and adjacent items.

DefaultPadding

Возвращает параметры внутренних интервалов элемента.Gets the internal spacing characteristics of the item.

(Унаследовано от ToolStripItem)
DefaultSize

Получает высоту и ширину объекта ToolStripProgressBar в пикселях.Gets the height and width of the ToolStripProgressBar in pixels.

DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.Gets a value that indicates whether the Component is currently in design mode.

(Унаследовано от Component)
DismissWhenClicked

Получает значение, указывающее, скрываются ли элементы на объекте ToolStripDropDown после того как их щелкнули.Gets a value indicating whether items on a ToolStripDropDown are hidden after they are clicked.

(Унаследовано от ToolStripItem)
DisplayStyle

Данное свойство не применимо к этому классу.This property is not relevant to this class.

(Унаследовано от ToolStripControlHost)
Dock

Возвращает или задает границы объекта ToolStripItem, которые прикрепляются к его родительскому элементу управления, и определяет способ изменения размеров объекта ToolStripItem при изменении размеров его родительского элемента управления.Gets or sets which ToolStripItem borders are docked to its parent control and determines how a ToolStripItem is resized with its parent.

(Унаследовано от ToolStripItem)
DoubleClickEnabled

Данное свойство не применимо к этому классу.This property is not relevant to this class.

(Унаследовано от ToolStripControlHost)
Enabled

Получает или задает значение показывающее, активизирован ли родительский элемент управления для объекта ToolStripItem.Gets or sets a value indicating whether the parent control of the ToolStripItem is enabled.

(Унаследовано от ToolStripControlHost)
Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.Gets the list of event handlers that are attached to this Component.

(Унаследовано от Component)
Focused

Возвращает значение, указывающее, имеется ли на элементе управления фокус ввода.Gets a value indicating whether the control has input focus.

(Унаследовано от ToolStripControlHost)
Font

Получает или задает шрифт, используемый размещенным элементом управления.Gets or sets the font to be used on the hosted control.

(Унаследовано от ToolStripControlHost)
ForeColor

Возвращает или задает цвет размещаемого элемента управления.Gets or sets the foreground color of the hosted control.

(Унаследовано от ToolStripControlHost)
Height

Получает или задает высоту объекта ToolStripItem в пикселях.Gets or sets the height, in pixels, of a ToolStripItem.

(Унаследовано от ToolStripItem)
Image

Изображение, связанное с объектом.The image associated with the object.

(Унаследовано от ToolStripControlHost)
ImageAlign

Данное свойство не применимо к этому классу.This property is not relevant to this class.

(Унаследовано от ToolStripControlHost)
ImageIndex

Возвращает или задает значение индекса изображения, отображаемого на данном элементе.Gets or sets the index value of the image that is displayed on the item.

(Унаследовано от ToolStripItem)
ImageKey

Получает или задает средство доступа к ключу для изображения в ImageList, отображаемого в элементе ToolStripItem.Gets or sets the key accessor for the image in the ImageList that is displayed on a ToolStripItem.

(Унаследовано от ToolStripItem)
ImageScaling

Данное свойство не применимо к этому классу.This property is not relevant to this class.

(Унаследовано от ToolStripControlHost)
ImageTransparentColor

Данное свойство не применимо к этому классу.This property is not relevant to this class.

(Унаследовано от ToolStripControlHost)
IsDisposed

Возвращает значение, указывающее, был ли удален объект.Gets a value indicating whether the object has been disposed of.

(Унаследовано от ToolStripItem)
IsOnDropDown

Получает значение, определяющее, является ли контейнер текущего Control элементом ToolStripDropDown.Gets a value indicating whether the container of the current Control is a ToolStripDropDown.

(Унаследовано от ToolStripItem)
IsOnOverflow

Получает значение, указывающее, установлено ли для свойства Placement значение Overflow.Gets a value indicating whether the Placement property is set to Overflow.

(Унаследовано от ToolStripItem)
Margin

Возвращает или задает расстояние между элементом и соседними элементами.Gets or sets the space between the item and adjacent items.

(Унаследовано от ToolStripItem)
MarqueeAnimationSpeed

Получает или задает значение задержки между обновлениями отображения Marquee в миллисекундах.Gets or sets a value representing the delay between each Marquee display update, in milliseconds.

Maximum

Получает или задает верхнюю границу диапазона, устанавливаемого для данного элемента управления ToolStripProgressBar.Gets or sets the upper bound of the range that is defined for this ToolStripProgressBar.

MergeAction

Получает или задает способ слияния дочерних меню с родительскими меню.Gets or sets how child menus are merged with parent menus.

(Унаследовано от ToolStripItem)
MergeIndex

Получает или задает положение элемента при слиянии в текущем ToolStrip.Gets or sets the position of a merged item within the current ToolStrip.

(Унаследовано от ToolStripItem)
Minimum

Получает или задает нижнюю границу диапазона, устанавливаемого для данного элемента управления ToolStripProgressBar.Gets or sets the lower bound of the range that is defined for this ToolStripProgressBar.

Name

Возвращает или задает имя элемента.Gets or sets the name of the item.

(Унаследовано от ToolStripItem)
Overflow

Получает или задает значение, указывающее, присоединен ли элемент к элементу ToolStrip или ToolStripOverflowButton или он может перемещаться между ними.Gets or sets whether the item is attached to the ToolStrip or ToolStripOverflowButton or can float between the two.

(Унаследовано от ToolStripItem)
Owner

Возвращает или задает владельца данного элемента.Gets or sets the owner of this item.

(Унаследовано от ToolStripItem)
OwnerItem

Возвращает родительский объект ToolStripItem этого объекта ToolStripItem.Gets the parent ToolStripItem of this ToolStripItem.

(Унаследовано от ToolStripItem)
Padding

Возвращает или задает внутренний интервал в пикселях между краями элемента и его содержимым.Gets or sets the internal spacing, in pixels, between the item's contents and its edges.

(Унаследовано от ToolStripItem)
Parent

Получает или задает родительский контейнер ToolStripItem.Gets or sets the parent container of the ToolStripItem.

(Унаследовано от ToolStripItem)
Placement

Возвращает текущую структуру элемента.Gets the current layout of the item.

(Унаследовано от ToolStripItem)
Pressed

Получает значение, показывающее, нажат ли элемент.Gets a value indicating whether the state of the item is pressed.

(Унаследовано от ToolStripItem)
ProgressBar

Получает ProgressBar.Gets the ProgressBar.

RightToLeft

Возвращает или задает значение, указывающее, выровнены ли компоненты элемента управления для поддержки языков, использующих шрифты с написанием справа налево.Gets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts.

(Унаследовано от ToolStripControlHost)
RightToLeftAutoMirrorImage

Данное свойство не применимо к этому классу.This property is not relevant to this class.

(Унаследовано от ToolStripControlHost)
RightToLeftLayout

Получает или задает значение, указывающее, является ли направление индикатора хода выполнения ToolStripProgressBar справа налево или слева направо, если свойство RightToLeft имеет значение Yes.Gets or sets a value indicating whether the ToolStripProgressBar layout is right-to-left or left-to-right when the RightToLeft property is set to Yes.

Selected

Возвращает значение, указывающее, выбран ли элемент.Gets a value indicating whether the item is selected.

(Унаследовано от ToolStripControlHost)
ShowKeyboardCues

Возвращает значение, определяющее, должны сочетания клавиш отображаться или нет.Gets a value indicating whether to show or hide shortcut keys.

(Унаследовано от ToolStripItem)
Site

Получает или задает узел размещенного элемента управления.Gets or sets the site of the hosted control.

(Унаследовано от ToolStripControlHost)
Size

Получает или задает размер объекта ToolStripItem.Gets or sets the size of the ToolStripItem.

(Унаследовано от ToolStripControlHost)
Step

Получает или задает число, на которое следует увеличить текущее значение объекта ToolStripProgressBar при вызове метода PerformStep().Gets or sets the amount by which to increment the current value of the ToolStripProgressBar when the PerformStep() method is called.

Style

Получает или задает стиль этого объекта ToolStripProgressBar.Gets or sets the style of the ToolStripProgressBar.

Tag

Возвращает или задает объект, который содержит данные об элементе.Gets or sets the object that contains data about the item.

(Унаследовано от ToolStripItem)
Text

Получает или задает текст, отображаемый в объекте ToolStripProgressBar.Gets or sets the text displayed on the ToolStripProgressBar.

TextAlign

Данное свойство не применимо к этому классу.This property is not relevant to this class.

(Унаследовано от ToolStripControlHost)
TextDirection

Данное свойство не применимо к этому классу.This property is not relevant to this class.

(Унаследовано от ToolStripControlHost)
TextImageRelation

Данное свойство не применимо к этому классу.This property is not relevant to this class.

(Унаследовано от ToolStripControlHost)
ToolTipText

Получает или задает текст, который появляется как ToolTip для элемента управления.Gets or sets the text that appears as a ToolTip for a control.

(Унаследовано от ToolStripItem)
Value

Получает или устанавливает текущее значение ToolStripProgressBar.Gets or sets the current value of the ToolStripProgressBar.

Visible

Возвращает или задает значение, указывающее, отображается ли элемент.Gets or sets a value indicating whether the item is displayed.

(Унаследовано от ToolStripItem)
Width

Получает или задает ширину объекта ToolStripItem в пикселях.Gets or sets the width in pixels of a ToolStripItem.

(Унаследовано от ToolStripItem)

Методы

CreateAccessibilityInstance()

Создает новый объект специальных возможностей для элемента управления.Creates a new accessibility object for the control.

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Унаследовано от MarshalByRefObject)
Dispose()

Освобождает все ресурсы, занятые модулем Component.Releases all resources used by the Component.

(Унаследовано от Component)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом ToolStripControlHost, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the ToolStripControlHost and optionally releases the managed resources.

(Унаследовано от ToolStripControlHost)
DoDragDrop(Object, DragDropEffects)

Начинает операцию перетаскивания.Begins a drag-and-drop operation.

(Унаследовано от ToolStripItem)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
Focus()

Передает фокус элементу управления.Gives the focus to a control.

(Унаследовано от ToolStripControlHost)
GetCurrentParent()

Извлекает ToolStrip, который является контейнером текущего ToolStripItem.Retrieves the ToolStrip that is the container of the current ToolStripItem.

(Унаследовано от ToolStripItem)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
GetPreferredSize(Size)

Вычисляет размер прямоугольной области, в которую помещается элемент управления.Retrieves the size of a rectangular area into which a control can be fitted.

(Унаследовано от ToolStripControlHost)
GetService(Type)

Возвращает объект, представляющий службу, обеспечиваемую компонентом Component или его контейнером Container.Returns an object that represents a service provided by the Component or by its Container.

(Унаследовано от Component)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
Increment(Int32)

Увеличивает текущую позицию индикатора выполнения на заданную величину.Advances the current position of the progress bar by the specified amount.

InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
Invalidate()

Делает недействительной всю поверхность элемента ToolStripItemи вызывает его перерисовку.Invalidates the entire surface of the ToolStripItem and causes it to be redrawn.

(Унаследовано от ToolStripItem)
Invalidate(Rectangle)

Делает недействительной указанную область элемента ToolStripItem путем добавления ее к области обновления элемента ToolStripItem, которая будет перерисована при следующей операции рисования, и вызывает отправку сообщения изображения элементу ToolStripItem.Invalidates the specified region of the ToolStripItem by adding it to the update region of the ToolStripItem, which is the area that will be repainted at the next paint operation, and causes a paint message to be sent to the ToolStripItem.

(Унаследовано от ToolStripItem)
IsInputChar(Char)

Определяет, является ли символ входным символом, который распознается элементом.Determines whether a character is an input character that the item recognizes.

(Унаследовано от ToolStripItem)
IsInputKey(Keys)

Определяет, является ли указанный ключ стандартным ключом ввода или специальным ключом, которому требуется обработка.Determines whether the specified key is a regular input key or a special key that requires preprocessing.

(Унаследовано от ToolStripItem)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Унаследовано от MarshalByRefObject)
OnAvailableChanged(EventArgs)

Вызывает событие AvailableChanged.Raises the AvailableChanged event.

(Унаследовано от ToolStripItem)
OnBackColorChanged(EventArgs)

Порождает событие BackColorChanged.Raises the BackColorChanged event.

(Унаследовано от ToolStripItem)
OnBoundsChanged()

Происходит при изменении свойства Bounds.Occurs when the Bounds property changes.

(Унаследовано от ToolStripControlHost)
OnClick(EventArgs)

Порождает событие Click.Raises the Click event.

(Унаследовано от ToolStripItem)
OnDisplayStyleChanged(EventArgs)

Порождает событие DisplayStyleChanged.Raises the DisplayStyleChanged event.

(Унаследовано от ToolStripItem)
OnDoubleClick(EventArgs)

Порождает событие DoubleClick.Raises the DoubleClick event.

(Унаследовано от ToolStripItem)
OnDragDrop(DragEventArgs)

Порождает событие DragDrop.Raises the DragDrop event.

(Унаследовано от ToolStripItem)
OnDragEnter(DragEventArgs)

Порождает событие DragEnter.Raises the DragEnter event.

(Унаследовано от ToolStripItem)
OnDragLeave(EventArgs)

Порождает событие DragLeave.Raises the DragLeave event.

(Унаследовано от ToolStripItem)
OnDragOver(DragEventArgs)

Порождает событие DragOver.Raises the DragOver event.

(Унаследовано от ToolStripItem)
OnEnabledChanged(EventArgs)

Порождает событие EnabledChanged.Raises the EnabledChanged event.

(Унаследовано от ToolStripItem)
OnEnter(EventArgs)

Вызывает событие Enter.Raises the Enter event.

(Унаследовано от ToolStripControlHost)
OnFontChanged(EventArgs)

Порождает событие FontChanged.Raises the FontChanged event.

(Унаследовано от ToolStripItem)
OnForeColorChanged(EventArgs)

Порождает событие ForeColorChanged.Raises the ForeColorChanged event.

(Унаследовано от ToolStripItem)
OnGiveFeedback(GiveFeedbackEventArgs)

Порождает событие GiveFeedback.Raises the GiveFeedback event.

(Унаследовано от ToolStripItem)
OnGotFocus(EventArgs)

Вызывает событие GotFocus.Raises the GotFocus event.

(Унаследовано от ToolStripControlHost)
OnHostedControlResize(EventArgs)

Синхронизирует изменение размеров объекта, в котором размещается элемент управления, с изменением размеров размещенного элемента управления.Synchronizes the resizing of the control host with the resizing of the hosted control.

(Унаследовано от ToolStripControlHost)
OnKeyDown(KeyEventArgs)

Вызывает событие KeyDown.Raises the KeyDown event.

(Унаследовано от ToolStripControlHost)
OnKeyPress(KeyPressEventArgs)

Вызывает событие KeyPress.Raises the KeyPress event.

(Унаследовано от ToolStripControlHost)
OnKeyUp(KeyEventArgs)

Вызывает событие KeyUp.Raises the KeyUp event.

(Унаследовано от ToolStripControlHost)
OnLayout(LayoutEventArgs)

Вызывает событие Layout.Raises the Layout event.

(Унаследовано от ToolStripControlHost)
OnLeave(EventArgs)

Вызывает событие Leave.Raises the Leave event.

(Унаследовано от ToolStripControlHost)
OnLocationChanged(EventArgs)

Порождает событие LocationChanged.Raises the LocationChanged event.

(Унаследовано от ToolStripItem)
OnLostFocus(EventArgs)

Вызывает событие LostFocus.Raises the LostFocus event.

(Унаследовано от ToolStripControlHost)
OnMouseDown(MouseEventArgs)

Порождает событие MouseDown.Raises the MouseDown event.

(Унаследовано от ToolStripItem)
OnMouseEnter(EventArgs)

Порождает событие MouseEnter.Raises the MouseEnter event.

(Унаследовано от ToolStripItem)
OnMouseHover(EventArgs)

Порождает событие MouseHover.Raises the MouseHover event.

(Унаследовано от ToolStripItem)
OnMouseLeave(EventArgs)

Порождает событие MouseLeave.Raises the MouseLeave event.

(Унаследовано от ToolStripItem)
OnMouseMove(MouseEventArgs)

Порождает событие MouseMove.Raises the MouseMove event.

(Унаследовано от ToolStripItem)
OnMouseUp(MouseEventArgs)

Порождает событие MouseUp.Raises the MouseUp event.

(Унаследовано от ToolStripItem)
OnOwnerChanged(EventArgs)

Порождает событие OwnerChanged.Raises the OwnerChanged event.

(Унаследовано от ToolStripItem)
OnOwnerFontChanged(EventArgs)

Вызывает событие FontChanged, когда изменяется свойство Font в родительском элементе элемента ToolStripItem.Raises the FontChanged event when the Font property has changed on the parent of the ToolStripItem.

(Унаследовано от ToolStripItem)
OnPaint(PaintEventArgs)

Вызывает событие Paint.Raises the Paint event.

(Унаследовано от ToolStripControlHost)
OnParentBackColorChanged(EventArgs)

Порождает событие BackColorChanged.Raises the BackColorChanged event.

(Унаследовано от ToolStripItem)
OnParentChanged(ToolStrip, ToolStrip)

Вызывает событие ParentChanged.Raises the ParentChanged event.

(Унаследовано от ToolStripControlHost)
OnParentEnabledChanged(EventArgs)

Вызывает событие EnabledChanged при изменении значения свойства Enabled контейнера элемента.Raises the EnabledChanged event when the Enabled property value of the item's container changes.

(Унаследовано от ToolStripItem)
OnParentForeColorChanged(EventArgs)

Порождает событие ForeColorChanged.Raises the ForeColorChanged event.

(Унаследовано от ToolStripItem)
OnParentRightToLeftChanged(EventArgs)

Порождает событие RightToLeftChanged.Raises the RightToLeftChanged event.

(Унаследовано от ToolStripItem)
OnQueryContinueDrag(QueryContinueDragEventArgs)

Порождает событие QueryContinueDrag.Raises the QueryContinueDrag event.

(Унаследовано от ToolStripItem)
OnRightToLeftChanged(EventArgs)

Порождает событие RightToLeftChanged.Raises the RightToLeftChanged event.

(Унаследовано от ToolStripItem)
OnRightToLeftLayoutChanged(EventArgs)

Порождает событие RightToLeftLayoutChanged.Raises the RightToLeftLayoutChanged event.

OnSubscribeControlEvents(Control)

Подписывает на события, связанные с размещенным элементом управления.Subscribes events from the hosted control.

OnTextChanged(EventArgs)

Порождает событие TextChanged.Raises the TextChanged event.

(Унаследовано от ToolStripItem)
OnUnsubscribeControlEvents(Control)

Отменяет подписку на события, связанные с размещенным элементом управления.Unsubscribes events from the hosted control.

OnValidated(EventArgs)

Вызывает событие Validated.Raises the Validated event.

(Унаследовано от ToolStripControlHost)
OnValidating(CancelEventArgs)

Вызывает событие Validating.Raises the Validating event.

(Унаследовано от ToolStripControlHost)
OnVisibleChanged(EventArgs)

Порождает событие VisibleChanged.Raises the VisibleChanged event.

(Унаследовано от ToolStripItem)
PerformClick()

Создает событие Click для элемента ToolStripItem.Generates a Click event for a ToolStripItem.

(Унаследовано от ToolStripItem)
PerformStep()

Увеличивает текущую позицию индикатора хода выполнения на значение свойства Step.Advances the current position of the progress bar by the amount of the Step property.

ProcessCmdKey(Message, Keys)

Обрабатывает клавишу для команд.Processes a command key.

(Унаследовано от ToolStripControlHost)
ProcessDialogKey(Keys)

Обрабатывает клавишу диалогового окна.Processes a dialog key.

(Унаследовано от ToolStripControlHost)
ProcessMnemonic(Char)

Обрабатывает назначенный символ.Processes a mnemonic character.

(Унаследовано от ToolStripControlHost)
ResetBackColor()

Данный метод не применим к этому классу.This method is not relevant to this class.

(Унаследовано от ToolStripControlHost)
ResetDisplayStyle()

Данный метод не применим к этому классу.This method is not relevant to this class.

(Унаследовано от ToolStripItem)
ResetFont()

Данный метод не применим к этому классу.This method is not relevant to this class.

(Унаследовано от ToolStripItem)
ResetForeColor()

Данный метод не применим к этому классу.This method is not relevant to this class.

(Унаследовано от ToolStripControlHost)
ResetImage()

Данный метод не применим к этому классу.This method is not relevant to this class.

(Унаследовано от ToolStripItem)
ResetMargin()

Данный метод не применим к этому классу.This method is not relevant to this class.

(Унаследовано от ToolStripItem)
ResetPadding()

Данный метод не применим к этому классу.This method is not relevant to this class.

(Унаследовано от ToolStripItem)
ResetRightToLeft()

Данный метод не применим к этому классу.This method is not relevant to this class.

(Унаследовано от ToolStripItem)
ResetTextDirection()

Данный метод не применим к этому классу.This method is not relevant to this class.

(Унаследовано от ToolStripItem)
Select()

Выбирает элемент.Selects the item.

(Унаследовано от ToolStripItem)
SetBounds(Rectangle)

Задает размер и расположение элемента.Sets the size and location of the item.

(Унаследовано от ToolStripItem)
SetVisibleCore(Boolean)

Устанавливает ToolStripItem в указанное видимое состояние.Sets the ToolStripItem to the specified visible state.

(Унаследовано от ToolStripControlHost)
ToString()

Возвращает объект String, содержащий имя Component, если оно есть.Returns a String containing the name of the Component, if any. Этот метод не следует переопределять.This method should not be overridden.

(Унаследовано от ToolStripItem)

События

AvailableChanged

Происходит при изменении значения свойства Available.Occurs when the value of the Available property changes.

(Унаследовано от ToolStripItem)
BackColorChanged

Происходит при изменении значения свойства BackColor.Occurs when the value of the BackColor property changes.

(Унаследовано от ToolStripItem)
Click

Происходит при щелчке объекта ToolStripItem.Occurs when the ToolStripItem is clicked.

(Унаследовано от ToolStripItem)
DisplayStyleChanged

Данное событие не применимо к этому классу.This event is not relevant to this class.

(Унаследовано от ToolStripControlHost)
Disposed

Происходит при удалении компонента вызовом метода Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Унаследовано от Component)
DoubleClick

Происходит при двойном щелчке элемента кнопкой мыши.Occurs when the item is double-clicked with the mouse.

(Унаследовано от ToolStripItem)
DragDrop

Происходит, когда пользователь перетаскивает элемент и отпускает кнопку мыши, указывая, что элемент должен быть перемещен в данный элемент.Occurs when the user drags an item and the user releases the mouse button, indicating that the item should be dropped into this item.

(Унаследовано от ToolStripItem)
DragEnter

Происходит, когда пользователь перетаскивает элемент в клиентскую область данного элемента.Occurs when the user drags an item into the client area of this item.

(Унаследовано от ToolStripItem)
DragLeave

Происходит, когда пользователь перетаскивает элемент и указатель мыши больше не находится в клиентской области данного элемента.Occurs when the user drags an item and the mouse pointer is no longer over the client area of this item.

(Унаследовано от ToolStripItem)
DragOver

Происходит, когда пользователь перетаскивает элемент в клиентскую область данного элемента.Occurs when the user drags an item over the client area of this item.

(Унаследовано от ToolStripItem)
EnabledChanged

Происходит, если значение свойства Enabled было изменено.Occurs when the Enabled property value has changed.

(Унаследовано от ToolStripItem)
Enter

Происходит при входе в размещенный элемент управления.Occurs when the hosted control is entered.

(Унаследовано от ToolStripControlHost)
ForeColorChanged

Происходит при изменении значения свойства ForeColor.Occurs when the ForeColor property value changes.

(Унаследовано от ToolStripItem)
GiveFeedback

Вызывается при выполнении операции перетаскивания.Occurs during a drag operation.

(Унаследовано от ToolStripItem)
GotFocus

Происходит при получении фокуса размещенным элементом управления.Occurs when the hosted control receives focus.

(Унаследовано от ToolStripControlHost)
KeyDown

Данное событие не применимо к этому классу.This event is not relevant for this class.

KeyPress

Данное событие не применимо к этому классу.This event is not relevant for this class.

KeyUp

Данное событие не применимо к этому классу.This event is not relevant for this class.

Leave

Происходит при перемещении фокуса ввода с размещенного элемента управления.Occurs when the input focus leaves the hosted control.

(Унаследовано от ToolStripControlHost)
LocationChanged

Данное событие не применимо к этому классу.This event is not relevant for this class.

LostFocus

Происходит при утрате фокуса размещенным элементом управления.Occurs when the hosted control loses focus.

(Унаследовано от ToolStripControlHost)
MouseDown

Происходит при нажатии кнопки мыши, если указатель мыши находится на элементе.Occurs when the mouse pointer is over the item and a mouse button is pressed.

(Унаследовано от ToolStripItem)
MouseEnter

Происходит, когда указатель мыши оказывается на элементе.Occurs when the mouse pointer enters the item.

(Унаследовано от ToolStripItem)
MouseHover

Происходит, когда указатель мыши наведен на элемент.Occurs when the mouse pointer hovers over the item.

(Унаследовано от ToolStripItem)
MouseLeave

Происходит, когда указатель мыши покидает элемент.Occurs when the mouse pointer leaves the item.

(Унаследовано от ToolStripItem)
MouseMove

Происходит при перемещении указателя мыши по элементу.Occurs when the mouse pointer is moved over the item.

(Унаследовано от ToolStripItem)
MouseUp

Происходит при отпускании кнопки мыши, если указатель мыши находится на элементе.Occurs when the mouse pointer is over the item and a mouse button is released.

(Унаследовано от ToolStripItem)
OwnerChanged

Данное событие не применимо к этому классу.This event is not relevant for this class.

Paint

Происходит при перерисовке элемента.Occurs when the item is redrawn.

(Унаследовано от ToolStripItem)
QueryAccessibilityHelp

Происходит, когда приложение со специальными возможностями вызывает справку для ToolStripItem.Occurs when an accessibility client application invokes help for the ToolStripItem.

(Унаследовано от ToolStripItem)
QueryContinueDrag

Происходит во время операции перетаскивания и позволяет источнику перетаскивания определить, следует ли отменить эту операцию.Occurs during a drag-and-drop operation and allows the drag source to determine whether the drag-and-drop operation should be canceled.

(Унаследовано от ToolStripItem)
RightToLeftChanged

Происходит при изменении значения свойства RightToLeft.Occurs when the RightToLeft property value changes.

(Унаследовано от ToolStripItem)
RightToLeftLayoutChanged

Происходит при изменении значения свойства RightToLeftLayout.Occurs when the value of the RightToLeftLayout property changes.

TextChanged

Данное событие не применимо к этому классу.This event is not relevant for this class.

Validated

Данное событие не применимо к этому классу.This event is not relevant to this class.

Validating

Данное событие не применимо к этому классу.This event is not relevant to this class.

VisibleChanged

Происходит при изменении значения свойства Visible.Occurs when the value of the Visible property changes.

(Унаследовано от ToolStripItem)

Явные реализации интерфейса

IDropTarget.OnDragDrop(DragEventArgs)

Порождает событие DragDrop.Raises the DragDrop event.

(Унаследовано от ToolStripItem)
IDropTarget.OnDragEnter(DragEventArgs)

Порождает событие DragEnter.Raises the DragEnter event.

(Унаследовано от ToolStripItem)
IDropTarget.OnDragLeave(EventArgs)

Порождает событие DragLeave.Raises the DragLeave event.

(Унаследовано от ToolStripItem)
IDropTarget.OnDragOver(DragEventArgs)

Порождает событие DragOver.Raises the DragOver event.

(Унаследовано от ToolStripItem)

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

Дополнительно