StatusBar.PanelClick イベント

.NET Framework クラス ライブラリ リファレンス

StatusBar.PanelClick イベント

StatusBar コントロールの StatusBarPanel オブジェクトがクリックされると発生します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Event PanelClick As
 StatusBarPanelClickEventHandler

Visual Basic (使用法)

Dim instance As StatusBar
Dim handler As StatusBarPanelClickEventHandler

AddHandler instance.PanelClick, handler

C#

public event StatusBarPanelClickEventHandler PanelClick

C++

public:
event StatusBarPanelClickEventHandler^ PanelClick {
    void add (StatusBarPanelClickEventHandler^ value);
    void remove (StatusBarPanelClickEventHandler^ value);
}

J#

/** @event */
public void add_PanelClick (StatusBarPanelClickEventHandler
 value)

/** @event */
public void remove_PanelClick (StatusBarPanelClickEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

このイベントを使用して、StatusBar コントロール内のパネルがクリックされたときにタスクを実行できます。パラメータとしてイベント ハンドラに渡された StatusBarPanelClickEventArgs を通じてイベントに提供されたデータを使用すると、選択したパネル上でタスクを実行するためにユーザーによってクリックされた StatusBarPanel を確認できます。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

SizingGrip、StatusBarPanel.Alignment、StatusBarPanel.Width、StatusBarPanel.AutoSize、StatusBarPanel.BorderStyle の各メンバの使用方法、および PanelClick イベントの処理方法を示すコード例を次に示します。

この例を実行するには、次のコードをフォームに貼り付けます。そして、フォームのコンストラクタまたは Load メソッドで InitializeStatusBarPanels メソッドを呼び出します。

Visual Basic

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

C#

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();
    }
}

C++

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();
      }
   }

J#

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 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

参照

関連項目
StatusBar クラス
StatusBar メンバ
System.Windows.Forms 名前空間
OnPanelClick
StatusBarPanelClickEventArgs
StatusBarPanelClickEventHandler