StatusBarPanel.Width 属性
获取或设置 StatusBar 控件中状态栏面板的宽度。
**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）
语法
声明
<LocalizableAttribute(True)> _
Public Property Width As Integer
用法
Dim instance As StatusBarPanel
Dim value As Integer
value = instance.Width
instance.Width = value
[LocalizableAttribute(true)]
public int Width { get; set; }
[LocalizableAttribute(true)]
public:
property int Width {
int get ();
void set (int value);
}
/** @property */
public int get_Width ()
/** @property */
public void set_Width (int value)
public function get Width () : int
public function set Width (value : int)
属性值
StatusBarPanel 的宽度（以像素为单位）。
异常
| 异常类型 | 条件 |
|---|---|
指定的宽度小于 MinWidth 属性的值。 |
备注
Width 属性总是反映 StatusBarPanel 的实际宽度，并且不能小于 MinWidth 属性。若要自动调整 StatusBarPanel 的宽度以适合 StatusBarPanel 的内容，可以使用 AutoSize 属性。
示例
下面的代码示例演示如何使用 StatusBar.SizingGrip、Alignment、Width、AutoSize 和 BorderStyle 属性以及如何处理 StatusBar.PanelClick 事件。
若要运行该示例，请将下面的代码粘贴到一个窗体中。在窗体的构造函数或 Load 事件处理方法中调用 InitializeStatusBarPanels 方法。
Friend WithEvents statusBar1 As System.Windows.Forms.StatusBar
Private Sub InitializeStatusBarPanels()
' Create a StatusBar control.
statusBar1 = New StatusBar
' Dock the status bar at the top of the form.
statusBar1.Dock = DockStyle.Top
' Set the SizingGrip property to false so the user cannot
' resize the status bar.
statusBar1.SizingGrip = False
' Create two StatusBarPanel objects to display in statusBar1.
Dim panel1 As New StatusBarPanel
Dim panel2 As New StatusBarPanel
' Set the width of panel2 explicitly and set
' panel1 to fill in the remaining space.
panel2.Width = 80
panel1.AutoSize = StatusBarPanelAutoSize.Spring
' Set the text alignment within each panel.
panel1.Alignment = HorizontalAlignment.Left
panel2.Alignment = HorizontalAlignment.Right
' Display the first panel without a border and the second
' with a raised border.
panel1.BorderStyle = StatusBarPanelBorderStyle.None
panel2.BorderStyle = StatusBarPanelBorderStyle.Raised
' Set the text of the panels. The panel1 object is reserved
' for line numbers, while panel2 is set to the current time.
panel1.Text = "Reserved for important information."
panel2.Text = System.DateTime.Now.ToShortTimeString
' Set a tooltip for panel2
panel2.ToolTipText = "Click time to display seconds"
' Display panels in statusBar1 and add them to the
' status bar's StatusBarPanelCollection.
statusBar1.ShowPanels = True
statusBar1.Panels.Add(panel1)
statusBar1.Panels.Add(panel2)
' Add the StatusBar to the form.
Me.Controls.Add(statusBar1)
End Sub
' If the user clicks the status bar, check the text of the
' StatusBarPanel. If the text equals a short time string,
' change it to long time display.
Private Sub statusBar1_PanelClick(ByVal sender As Object, _
ByVal e As StatusBarPanelClickEventArgs) _
Handles statusBar1.PanelClick
If (e.StatusBarPanel.Text = _
System.DateTime.Now.ToShortTimeString) Then
e.StatusBarPanel.Text = System.DateTime.Now.ToLongTimeString
End If
End Sub
internal System.Windows.Forms.StatusBar statusBar1;
private void InitializeStatusBarPanels()
{
// Create a StatusBar control.
statusBar1 = new StatusBar();
// Dock the status bar at the top of the form.
statusBar1.Dock = DockStyle.Top;
// Set the SizingGrip property to false so the user cannot
// resize the status bar.
statusBar1.SizingGrip = false;
// Associate the event-handling method with the
// PanelClick event.
statusBar1.PanelClick +=
new StatusBarPanelClickEventHandler(statusBar1_PanelClick);
// Create two StatusBarPanel objects to display in statusBar1.
StatusBarPanel panel1 = new StatusBarPanel();
StatusBarPanel panel2 = new StatusBarPanel();
// Set the width of panel2 explicitly and set
// panel1 to fill in the remaining space.
panel2.Width = 80;
panel1.AutoSize = StatusBarPanelAutoSize.Spring;
// Set the text alignment within each panel.
panel1.Alignment = HorizontalAlignment.Left;
panel2.Alignment = HorizontalAlignment.Right;
// Display the first panel without a border and the second
// with a raised border.
panel1.BorderStyle = StatusBarPanelBorderStyle.None;
panel2.BorderStyle = StatusBarPanelBorderStyle.Raised;
// Set the text of the panels. The panel1 object is reserved
// for line numbers, while panel2 is set to the current time.
panel1.Text = "Reserved for important information.";
panel2.Text = System.DateTime.Now.ToShortTimeString();
// Set a tooltip for panel2
panel2.ToolTipText = "Click time to display seconds";
// Display panels in statusBar1 and add them to the
// status bar's StatusBarPanelCollection.
statusBar1.ShowPanels = true;
statusBar1.Panels.Add(panel1);
statusBar1.Panels.Add(panel2);
// Add the StatusBar to the form.
this.Controls.Add(statusBar1);
}
// If the user clicks the status bar, check the text of the
// StatusBarPanel. If the text equals a short time string,
// change it to long time display.
private void statusBar1_PanelClick(object sender,
StatusBarPanelClickEventArgs e)
{
if (e.StatusBarPanel.Text ==
System.DateTime.Now.ToShortTimeString())
{
e.StatusBarPanel.Text =
System.DateTime.Now.ToLongTimeString();
}
}
internal:
System::Windows::Forms::StatusBar^ statusBar1;
private:
void InitializeStatusBarPanels()
{
// Create a StatusBar control.
statusBar1 = gcnew StatusBar;
// Dock the status bar at the top of the form.
statusBar1->Dock = DockStyle::Top;
// Set the SizingGrip property to false so the user cannot
// resize the status bar.
statusBar1->SizingGrip = false;
// Associate the event-handling method with the
// PanelClick event.
statusBar1->PanelClick += gcnew StatusBarPanelClickEventHandler( this, &Form1::statusBar1_PanelClick );
// Create two StatusBarPanel objects to display in statusBar1.
StatusBarPanel^ panel1 = gcnew StatusBarPanel;
StatusBarPanel^ panel2 = gcnew StatusBarPanel;
// Set the width of panel2 explicitly and set
// panel1 to fill in the remaining space.
panel2->Width = 80;
panel1->AutoSize = StatusBarPanelAutoSize::Spring;
// Set the text alignment within each panel.
panel1->Alignment = HorizontalAlignment::Left;
panel2->Alignment = HorizontalAlignment::Right;
// Display the first panel without a border and the second
// with a raised border.
panel1->BorderStyle = StatusBarPanelBorderStyle::None;
panel2->BorderStyle = StatusBarPanelBorderStyle::Raised;
// Set the text of the panels. The panel1 object is reserved
// for line numbers, while panel2 is set to the current time.
panel1->Text = "Reserved for important information.";
panel2->Text = System::DateTime::Now.ToShortTimeString();
// Set a tooltip for panel2
panel2->ToolTipText = "Click time to display seconds";
// Display panels in statusBar1 and add them to the
// status bar's StatusBarPanelCollection.
statusBar1->ShowPanels = true;
statusBar1->Panels->Add( panel1 );
statusBar1->Panels->Add( panel2 );
// Add the StatusBar to the form.
this->Controls->Add( statusBar1 );
}
// If the user clicks the status bar, check the text of the
// StatusBarPanel. If the text equals a short time string,
// change it to long time display.
void statusBar1_PanelClick( Object^ /*sender*/, StatusBarPanelClickEventArgs^ e )
{
if ( e->StatusBarPanel->Text == System::DateTime::Now.ToShortTimeString() )
{
e->StatusBarPanel->Text = System::DateTime::Now.ToLongTimeString();
}
}
System.Windows.Forms.StatusBar statusBar1;
private void InitializeStatusBarPanels()
{
// Create a StatusBar control.
statusBar1 = new StatusBar();
// Dock the status bar at the top of the form.
statusBar1.set_Dock(DockStyle.Top);
// Set the SizingGrip property to false so the user cannot
// resize the status bar.
statusBar1.set_SizingGrip(false);
// Associate the event-handling method with the
// PanelClick event.
statusBar1.add_PanelClick(new StatusBarPanelClickEventHandler(
statusBar1_PanelClick));
// Create two StatusBarPanel objects to display in statusBar1.
StatusBarPanel panel1 = new StatusBarPanel();
StatusBarPanel panel2 = new StatusBarPanel();
// Set the width of panel2 explicitly and set
// panel1 to fill in the remaining space.
panel2.set_Width(80);
panel1.set_AutoSize(StatusBarPanelAutoSize.Spring);
// Set the text alignment within each panel.
panel1.set_Alignment(HorizontalAlignment.Left);
panel2.set_Alignment(HorizontalAlignment.Right);
// Display the first panel without a border and the second
// with a raised border.
panel1.set_BorderStyle(StatusBarPanelBorderStyle.None);
panel2.set_BorderStyle(StatusBarPanelBorderStyle.Raised);
// Set the text of the panels. The panel1 object is reserved
// for line numbers, while panel2 is set to the current time.
panel1.set_Text("Reserved for important information.");
panel2.set_Text(System.DateTime.get_Now().ToShortTimeString());
// Set a tooltip for panel2
panel2.set_ToolTipText("Click time to display seconds");
// Display panels in statusBar1 and add them to the
// status bar's StatusBarPanelCollection.
statusBar1.set_ShowPanels(true);
statusBar1.get_Panels().Add(panel1);
statusBar1.get_Panels().Add(panel2);
// Add the StatusBar to the form.
this.get_Controls().Add(statusBar1);
} //InitializeStatusBarPanels
// If the user clicks the status bar, check the text of the
// StatusBarPanel. If the text equals a short time string,
// change it to long time display.
private void statusBar1_PanelClick(Object sender,
StatusBarPanelClickEventArgs e)
{
if (e.get_StatusBarPanel().get_Text().Equals(
System.DateTime.get_Now().ToShortTimeString())) {
e.get_StatusBarPanel().set_Text(System.DateTime.get_Now().
ToLongTimeString());
}
} //statusBar1_PanelClick
平台
Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
版本信息
.NET Framework
受以下版本支持：2.0、1.1、1.0
请参见
参考
StatusBarPanel 类
StatusBarPanel 成员
System.Windows.Forms 命名空间
StatusBarPanel.MinWidth 属性
StatusBarPanel.AutoSize 属性