ControlExtensions.AddComboBox 方法 (ControlCollection, Double, Double, Double, Double, String)
將新的 ComboBox 控制項依指定大小和位置加入至工作表。
命名空間: Microsoft.Office.Tools.Excel
組件: Microsoft.Office.Tools.Excel.v4.0.Utilities (在 Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 中)
語法
'宣告
<ExtensionAttribute> _
Public Shared Function AddComboBox ( _
controls As ControlCollection, _
left As Double, _
top As Double, _
width As Double, _
height As Double, _
name As String _
) As ComboBox
public static ComboBox AddComboBox(
this ControlCollection controls,
double left,
double top,
double width,
double height,
string name
)
參數
- controls
型別:Microsoft.Office.Tools.Excel.ControlCollection
要加入控制項的集合。請勿自行提供此參數。當您在 Worksheet.Controls 屬性 (在應用程式層級的專案中) 或 WorksheetBase.Controls 屬性 (在文件層級的專案中) 所傳回的集合上呼叫這個方法時,會自動提供這個參數。
- left
型別:System.Double
控制項左邊緣和工作表左邊緣之間的距離 (以點為單位)。
- top
型別:System.Double
控制項上邊緣和工作表上邊緣之間的距離 (以點為單位)。
- width
型別:System.Double
控制項的寬度 (以點為單位)。
- height
型別:System.Double
控制項的高度 (以點為單位)。
- name
型別:System.String
控制項的名稱。
傳回值
型別:Microsoft.Office.Tools.Excel.Controls.ComboBox
加入 ControlCollection 執行個體的 ComboBox 控制項中。
使用注意事項
在 Visual Basic 和 C# 中,您可以在任何 ControlCollection 型別物件中呼叫這個方法以做為執行個體。使用執行個體方法語法呼叫這個方法時,請省略第一個參數。如需詳細資訊,請參閱擴充方法 (Visual Basic)或擴充方法 (C# 程式設計手冊)。
例外狀況
例外狀況 | 條件 |
---|---|
ArgumentNullException | 名稱引數為 nullnull 參考 (即 Visual Basic 中的 Nothing),或者長度為 0。 |
ControlNameAlreadyExistsException | 具有相同名稱的控制項已經存在於 ControlCollection 執行個體中。 |
備註
AddComboBox 方法可以用來將 ComboBox 物件加入至 ControlCollection 的結尾。 若要移除先前以程式設計方式加入的 ComboBox 控制項,請使用 Remove 方法。
範例
下列程式碼範例會將 ComboBox 控制項加入至工作表的頂端、將兩個項目加入至下拉式方塊中,然後選取第一個項目。 若要使用這個範例,請在文件層級專案中的 Sheet1 類別執行。
Private Sub ExcelAddComboBox()
Dim ComboBox1 As Microsoft.Office.Tools.Excel. _
Controls.ComboBox = Me.Controls.AddComboBox( _
0, 0, 90.75, 15.75, "ComboBox1")
ComboBox1.Items.Add("First Item")
ComboBox1.Items.Add("Second Item")
ComboBox1.SelectedIndex = 0
End Sub
private void ExcelAddComboBox()
{
Microsoft.Office.Tools.Excel.Controls.ComboBox
comboBox1 = this.Controls.AddComboBox(0, 0,
90.75, 15.75, "comboBox1");
comboBox1.Items.Add("First Item");
comboBox1.Items.Add("Second Item");
comboBox1.SelectedIndex = 0;
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。