Form.ShowInTaskbar Propriété

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit une valeur indiquant si le formulaire est affiché dans la barre des tâches Windows.

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

public bool ShowInTaskbar { get; set; }

member this.ShowInTaskbar : bool with get, set

Public Property ShowInTaskbar As Boolean

Valeur de propriété

Boolean

true pour afficher le formulaire dans la barre des tâches Windows au moment de l'exécution ; sinon, false. La valeur par défaut est true.

Exemples

L’exemple suivant montre comment utiliser la ShowInTaskbar propriété pour créer une boîte de dialogue qui n’est pas affichée dans la barre des tâches Windows.

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

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

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

Remarques

Si un formulaire est parenté dans un autre formulaire, le formulaire parenté n’est pas affiché dans la barre des tâches Windows.

Vous pouvez utiliser cette propriété pour empêcher les utilisateurs de sélectionner votre formulaire via la barre des tâches Windows. Par exemple, si vous affichez une fenêtre outil Rechercher et remplacer dans votre application, vous pouvez empêcher cette fenêtre d’être sélectionnée via la barre des tâches Windows, car vous avez besoin à la fois de la fenêtre principale de l’application et de la fenêtre Outil Rechercher et Remplacer pour traiter les recherches de manière appropriée.

Vous souhaiterez souvent utiliser cette propriété lors de la création d’un formulaire avec le FixedToolWindow style. La définition du FixedToolWindow style ne garantit pas seulement qu’une fenêtre n’apparaîtra pas dans la barre des tâches.

S’applique à

Produit	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop	3.0, 3.1, 5, 6, 7

Partage via