StatusBar.StatusBarPanelCollection.Insert(Int32, StatusBarPanel) Methode

Definition

Fügt die angegebene StatusBarPanel-Klasse am angegebenen Index in die Auflistung ein.Inserts the specified StatusBarPanel into the collection at the specified index.

public:
 virtual void Insert(int index, System::Windows::Forms::StatusBarPanel ^ value);
public virtual void Insert (int index, System.Windows.Forms.StatusBarPanel value);
abstract member Insert : int * System.Windows.Forms.StatusBarPanel -> unit
override this.Insert : int * System.Windows.Forms.StatusBarPanel -> unit
Public Overridable Sub Insert (index As Integer, value As StatusBarPanel)

Parameter

index
Int32

Die nullbasierte Indexposition, an der der Bereich eingefügt wird.The zero-based index location where the panel is inserted.

value
StatusBarPanel

Ein StatusBarPanel, das den einzufügenden Bereich darstellt.A StatusBarPanel representing the panel to insert.

Ausnahmen

Der value-Parameter ist null.The value parameter is null.

Das übergeordnete Element des value-Parameters ist nicht null.The value parameter's parent is not null.

Der index-Parameter ist kleiner als 0 oder größer als der Wert der Count-Eigenschaft der StatusBar.StatusBarPanelCollection-Klasse.The index parameter is less than zero or greater than the value of the Count property of the StatusBar.StatusBarPanelCollection class.

Die AutoSize-Eigenschaft des Bereichs des value-Parameters ist kein gültiger StatusBarPanelAutoSize-Wert.The AutoSize property of the value parameter's panel is not a valid StatusBarPanelAutoSize value.

Hinweise

Sie können einem StatusBar Steuerelement Panels hinzufügen, um mehr als eine Art von Informationen anzuzeigen.You can add panels to a StatusBar control to display more than one type of information. Die Insert -Methode ermöglicht es Ihnen, ein StatusBarPanel neues zu erstellen und es an einer bestimmten Position in der Auflistung einzufügen.The Insert method enables you to create a new StatusBarPanel and insert it at a specific location within the collection. Die Reihenfolge, in der sich die Bereiche StatusBar.StatusBarPanelCollection im befinden, stellt die Reihenfolge dar, StatusBar in der die Bereiche im Steuerelement angezeigt werden.The order in which panels are located in the StatusBar.StatusBarPanelCollection represents the order that panels are displayed within the StatusBar control. Panels werden von links nach rechts beginnend mit dem ersten Panel in der Auflistung angezeigt.Panels are displayed from left to right starting with the first panel in the collection. Die RightToLeft -Eigenschaft StatusBar des-Steuer Elements ändert nicht die Reihenfolge, in der Panels in StatusBarder angezeigt werden.The RightToLeft property of the StatusBar control does not change the order in which panels are displayed in the StatusBar. Verwenden Sie die Add -Methode, um ein Panel am Ende der Auflistung hinzuzufügen.To add a panel to the end of the collection, use the Add method. Verwenden Sie die AddRange -Methode, um der Auflistung in einem einzelnen Vorgang einen Satz von Panels hinzuzufügen.To add a set of panels to the collection in a single operation, use the AddRange method.

Gilt für:

Siehe auch