Freigeben über


Form.ShowInTaskbar Eigenschaft

Definition

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Formular in der Windows-Taskleiste angezeigt wird.

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

trueum das Formular zur Laufzeit in der Windows-Taskleiste anzuzeigen; andernfalls . false Der Standardwert lautet true.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Die ShowInTaskbar Eigenschaft verwendet wird, um ein Dialogfeld zu 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 übergeordnet ist, 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 beispielsweise ein Toolfenster "Suchen und Ersetzen" 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, um Suchvorgänge entsprechend zu verarbeiten.

Sie möchten diese Eigenschaft häufig verwenden, wenn Sie ein Formular mit der FixedToolWindow Formatvorlage erstellen. Das Festlegen der FixedToolWindow Formatvorlage garantiert nicht allein, dass ein Fenster nicht in der Taskleiste angezeigt wird.

Gilt für: