ComboBox.ObjectCollection.Add(Object) 메서드

정의

ComboBox의 항목 목록에 항목을 추가합니다.Adds an item to the list of items for a ComboBox.

public:
 int Add(System::Object ^ item);
public int Add (object item);
member this.Add : obj -> int
Public Function Add (item As Object) As Integer

매개 변수

item
Object

컬렉션에 추가할 항목을 나타내는 개체입니다.An object representing the item to add to the collection.

반환

컬렉션 항목의 0부터 시작하는 인덱스입니다.The zero-based index of the item in the collection.

구현

예외

item 매개 변수가 null입니다.The item parameter was null.

설명

이 메서드는 콤보 상자에 항목을 추가합니다.This method adds an item to the combo box. ComboBoxSorted 속성이 true로 설정 되어 있으면 항목이 목록에 사전순으로 삽입 됩니다.If the Sorted property of the ComboBox is set to true, the item is inserted into the list alphabetically. 그렇지 않으면 항목 목록의 끝에 삽입 됩니다.Otherwise, the item is inserted at the end of the list.

항목의 시각적 표현은 콤보 상자에 표시 됩니다.A visual representation of the item is displayed in the combo box. 이 콘텐츠 표현은 DisplayMember 속성에 의해 지정 됩니다.This content representation is specified by the DisplayMember property. DisplayMember 속성이 null되는 경우 항목의 ToString 메서드를 호출 하 여 콤보 상자에 표시 되는 문자열을 가져옵니다. 그렇지 않으면 DisplayMember 속성에 지정 된 대로 저장 된 개체의 속성이 표시 됩니다.If the DisplayMember property is null, the item's ToString method is called to obtain the string that is displayed in the combo box; otherwise, the property of the stored object as specified by the DisplayMember property is displayed. SystemException 새 항목을 저장할 사용 가능한 공간이 부족 한 경우에 발생 합니다.A SystemException occurs if there is insufficient space available to store the new item. 콤보 상자에 항목 집합을 추가 하려면 AddRange 메서드를 사용 하는 것이 가장 좋습니다.To add a set of items to the combo box it is best to use the AddRange method. Add 메서드를 사용 하 여 콤보 상자에 많은 항목을 추가 하도록 선택 하는 경우 BeginUpdate 메서드를 사용 하 여 추가 하는 동안 다시 그리기를 일시 중단 하 고 EndUpdate 메서드가 다시 그리기를 다시 시작 합니다.If you choose to use the Add method to add a number of items to the combo box, use the BeginUpdate method to suspend repainting during your add and the EndUpdate method to resume repainting. Insert 메서드를 사용 하 여 목록에서 항목이 추가 되는 위치를 지정할 수 있습니다.You can use the Insert method to specify the location in the list where an item is added. 개체를 컬렉션에 추가 하면 ComboBox는 개체의 ToString 메서드를 호출 하 여 목록에 표시할 문자열을 가져옵니다.When an object is added to the collection, the ComboBox calls the object's ToString method to obtain the string to display in the list.

적용 대상

추가 정보