Form.ShowInTaskbar Propriedade

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define um valor que indica se o formulário é exibido na barra de tarefas do 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

Valor da propriedade

Boolean

true para exibir o formulário na barra de tarefas do Windows no tempo de execução; caso contrário, false. O padrão é true.

Exemplos

O exemplo a seguir demonstra como usar a ShowInTaskbar propriedade para criar uma caixa de diálogo que não é exibida na barra de tarefas do 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

Comentários

Se um formulário for pai em outro formulário, o formulário pai não será exibido na barra de tarefas do Windows.

Você pode usar essa propriedade para impedir que os usuários selecionem seu formulário por meio da barra de tarefas do Windows. Por exemplo, se você exibir uma janela de ferramenta Localizar e Substituir em seu aplicativo, convém impedir que essa janela seja selecionada por meio da barra de tarefas do Windows, pois você precisaria da janela principal do aplicativo e da janela da ferramenta Localizar e Substituir exibida para processar pesquisas adequadamente.

Muitas vezes, você desejará usar essa propriedade ao criar um formulário com o FixedToolWindow estilo . Definir o FixedToolWindow estilo não garante apenas que uma janela não será exibida na barra de tarefas.

Aplica-se a

Compartilhar via