Form.ShowInTaskbar Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, der angibt, ob das Formular auf der Windows-Taskleiste angezeigt wird, oder legt diesen fest.

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

Eigenschaftswert

Boolean

true, um das Formular zur Laufzeit auf der Windows-Taskleiste anzuzeigen, andernfalls false. Der Standardwert ist true.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe der ShowInTaskbar Eigenschaft ein Dialogfeld erstellen, das nicht in der Windows-Taskleiste angezeigt wird.

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

Hinweise

Wenn ein Formular innerhalb eines anderen Formulars klammert wird, wird das übergeordnete Formular nicht in der Windows-Taskleiste angezeigt.

Sie können diese Eigenschaft verwenden, um zu verhindern, dass Benutzer Ihr Formular über die Windows-Taskleiste auswählen. Wenn Sie z. B. ein Such- und Ersetzen-Toolfenster in Ihrer Anwendung anzeigen, sollten Sie verhindern, dass dieses Fenster über die Windows-Taskleiste ausgewählt wird, da Sie sowohl das Hauptfenster der Anwendung als auch das Toolfenster "Suchen und Ersetzen" benötigen, das entsprechend verarbeitet werden kann.

Beim Erstellen eines Formulars mit der FixedToolWindow Formatvorlage möchten Sie diese Eigenschaft häufig verwenden. Durch festlegen der FixedToolWindow Formatvorlage wird nicht allein sichergestellt, dass ein Fenster nicht in der Taskleiste angezeigt wird.

Gilt für

Freigeben über