ToolStripProgressBar 類別

定義

表示 StatusStrip 中所包含的 Windows 進度列控制項。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 裝載的優化 ToolStripToolStripProgressBar is the ProgressBar optimized for hosting in a ToolStrip. 裝載控制項的屬性和事件的子集會在 ToolStripProgressBar 層級公開,但基礎 ProgressBar 控制項可透過屬性完全存取 ProgressBarA 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.

MaximumMinimum 屬性會定義值的範圍,以代表工作的進度。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. 根據的大小 ToolStripProgressBarValue 屬性會決定何時顯示下一個區塊。Based on the size of the ToolStripProgressBar, the Value property determines when to display the next block.

除了 ToolStripProgressBar 直接變更屬性以外,有許多方法可以修改所顯示的值 ValueThere 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 方法,並指定用來遞增屬性的值 ValueTo 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

取得指定給控制項的 AccessibleObjectGets 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

取得或設定值,這個值指出是否要針對 ToolTipText 工具提示使用 Text 屬性或 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

取得包含 IContainerComponentGets 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 所裝載的 ToolStripControlHostGets the Control that this ToolStripControlHost is hosting.

(繼承來源 ToolStripControlHost)
ControlAlign

取得或設定表單上控制項的對齊方式。Gets or sets the alignment of the control on the form.

(繼承來源 ToolStripControlHost)
DefaultAutoToolTip

取得值,指出是否要顯示定義為預設值的 ToolTipGets 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 上的影像之按鍵存取子 (Accessor)。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 的容器是否為 ToolStripDropDownGets a value indicating whether the container of the current Control is a ToolStripDropDown.

(繼承來源 ToolStripItem)
IsOnOverflow

取得值,指出 Placement 屬性是否設定為 OverflowGets 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

取得或設定此項目是否附加至 ToolStripToolStripOverflowButton,或是可以在這兩者之間浮動的值。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

取得這個 ToolStripItemToolStripItemGets 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

取得 ProgressBarGets 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.

CreateAccessibilityInstance()

為控制項建立新的協助工具物件。Creates a new accessibility object for the control.

(繼承來源 ToolStripControlHost)
CreateObjRef(Type)

建立包含所有相關資訊的物件,這些資訊是產生用來與遠端物件通訊的所需 Proxy。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 所使用的 Unmanaged 資源,並選擇性地釋放 Managed 資源。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()
已過時。

擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。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()

取得目前執行個體的 TypeGets 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 的更新區域的方式使指定區域失效 (更新區域會在下一次繪製作業中重新繪製),並使繪製訊息傳送至 ToolStripItemInvalidates 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)

同步 (Synchronize) 控制項的調整大小作業與裝載控制項的調整大小作業。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()

產生 ToolStripItemClick 事件。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()

傳回任何包含 Component 名稱的 StringReturns 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

發生於使用者將項目拖入這個項目的工作區 (Client Area) 時。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)

適用於

另請參閱