Share via


ControlExtensions.AddDomainUpDown 方法 (ControlCollection, Double, Double, Double, Double, String)

將新的 DomainUpDown 控制項依指定大小和位置加入至工作表。

命名空間:  Microsoft.Office.Tools.Excel
組件:  Microsoft.Office.Tools.Excel.v4.0.Utilities (在 Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 中)

語法

'宣告
<ExtensionAttribute> _
Public Shared Function AddDomainUpDown ( _
    controls As ControlCollection, _
    left As Double, _
    top As Double, _
    width As Double, _
    height As Double, _
    name As String _
) As DomainUpDown
public static DomainUpDown AddDomainUpDown(
    this ControlCollection controls,
    double left,
    double top,
    double width,
    double height,
    string name
)

參數

  • left
    型別:System.Double
    控制項左邊緣和工作表左邊緣之間的距離 (以點為單位)。
  • top
    型別:System.Double
    控制項上邊緣和工作表上邊緣之間的距離 (以點為單位)。
  • width
    型別:System.Double
    控制項的寬度 (以點為單位)。
  • height
    型別:System.Double
    控制項的高度 (以點為單位)。

傳回值

型別:Microsoft.Office.Tools.Excel.Controls.DomainUpDown
加入 ControlCollection 執行個體的 DomainUpDown 控制項中。

使用注意事項

在 Visual Basic 和 C# 中,您可以在任何 ControlCollection 型別物件中呼叫這個方法以做為執行個體。使用執行個體方法語法呼叫這個方法時,請省略第一個參數。如需詳細資訊,請參閱擴充方法 (Visual Basic)擴充方法 (C# 程式設計手冊)

例外狀況

例外狀況 條件
ArgumentNullException

名稱引數為 nullnull 參考 (即 Visual Basic 中的 Nothing),或者長度為 0。

ControlNameAlreadyExistsException

具有相同名稱的控制項已經存在於 ControlCollection 執行個體中。

備註

AddDomainUpDown 方法可以用來將 DomainUpDown 物件加入至 ControlCollection 的結尾。 若要移除先前以程式設計方式加入的 DomainUpDown 控制項,請使用 Remove 方法。

範例

下列程式碼範例會將 DomainUpDown 控制項加入至工作表的頂端,然後將控制項的背景設定為黃色。 若要使用這個範例,請在文件層級專案中的 Sheet1 類別執行。

    Private Sub ExcelAddDomainUpDown()

        Dim DomainUpDown1 As Microsoft.Office.Tools. _
            Excel.Controls.DomainUpDown = Me.Controls. _
            AddDomainUpDown(0, 0, 90, 15, "DomainUpDown1")
        DomainUpDown1.BackColor = Color.Yellow

    End Sub

private void ExcelAddDomainUpDown()
{

    Microsoft.Office.Tools.Excel.Controls.DomainUpDown
        domainUpDown1 = this.Controls.AddDomainUpDown(
        0, 0, 90, 15, "domainUpDown1");
    domainUpDown1.BackColor = Color.Yellow;
}

.NET Framework 安全性

請參閱

參考

ControlExtensions 類別

AddDomainUpDown 多載

Microsoft.Office.Tools.Excel 命名空間