Form.ShowInTaskbar プロパティ

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

Form.ShowInTaskbar プロパティ

フォームを Windows タスク バーに表示するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property ShowInTaskbar As
 Boolean

Visual Basic (使用法)

Dim instance As Form
Dim value As Boolean

value = instance.ShowInTaskbar

instance.ShowInTaskbar = value

C#

public bool ShowInTaskbar { get;
 set; }

C++

public:
property bool ShowInTaskbar {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_ShowInTaskbar ()

/** @property */
public void set_ShowInTaskbar (boolean value)

JScript

public function get ShowInTaskbar
 () : boolean

public function set ShowInTaskbar
 (value : boolean)

プロパティ値
実行時にフォームを Windows タスク バーに表示する場合は true。それ以外の場合は false。既定値は true です。

解説

フォームが別のフォームを親としている場合、そのフォームは Windows タスク バーには表示されません。

このプロパティを使用して、ユーザーが Windows タスク バーを使用してフォームを選択できないようにします。たとえば、アプリケーション内で検索/置換用のウィンドウを表示する場合、検索を適切に処理するためにはアプリケーションのメイン ウィンドウと検索/置換ウィンドウの両方を表示する必要があるため、Windows タスク バーから検索/置換ウィンドウを選択できないようにしておきます。

このプロパティは、FixedToolWindow スタイルのフォームを作成するときに、しばしば必要になります。FixedToolWindow スタイルを設定するだけでは、ウィンドウがタスクバーに表示されなくなるわけではありません。

使用例

ShowInTaskbar プロパティを使用して、Windows のタスクバーに表示されないダイアログ ボックスを作成する方法を次のコード例に示します。

Visual Basic

Private Sub ShowInTaskBarEx()
    Dim myForm As New Form()
    myForm.Text = "My Form"
    myForm.SetBounds(10, 10, 200, 200)
    myForm.FormBorderStyle = FormBorderStyle.FixedDialog
    myForm.MinimizeBox = False
    myForm.MaximizeBox = False
    ' Do not allow form to be displayed in taskbar.
    myForm.ShowInTaskbar = False
    myForm.ShowDialog()
End Sub

C#

private void ShowInTaskBarEx()
{
    Form myForm = new Form();
    myForm.Text = "My Form";
    myForm.SetBounds(10,10,200,200);
    myForm.FormBorderStyle = FormBorderStyle.FixedDialog;
    myForm.MinimizeBox = false;
    myForm.MaximizeBox = false;
    // Do not allow form to be displayed in taskbar.
    myForm.ShowInTaskbar = false;
    myForm.ShowDialog();
}

C++

private:
   void ShowInTaskBarEx()
   {
      Form^ myForm = gcnew Form;
      myForm->Text = "My Form";
      myForm->SetBounds( 10, 10, 200, 200 );
      myForm->FormBorderStyle = ::FormBorderStyle::FixedDialog;
      myForm->MinimizeBox = false;
      myForm->MaximizeBox = false;

      // Do not allow form to be displayed in taskbar.
      myForm->ShowInTaskbar = false;
      myForm->ShowDialog();
   }

J#

private void ShowInTaskBarEx()
{
    Form myForm = new Form();
    myForm.set_Text("My Form");
    myForm.SetBounds(10, 10, 200, 200);
    myForm.set_FormBorderStyle(get_FormBorderStyle().FixedDialog);
    myForm.set_MinimizeBox(false);
    myForm.set_MaximizeBox(false);

    // Do not allow form to be displayed in taskbar.
    myForm.set_ShowInTaskbar(false);
    myForm.ShowDialog();
} //ShowInTaskBarEx

プラットフォーム

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

参照

関連項目
Form クラス
Form メンバ
System.Windows.Forms 名前空間