Worksheet.Controls 속성 (2007 시스템)

업데이트: 2008년 7월

워크시트 내에 포함된 컨트롤의 컬렉션을 가져옵니다.

네임스페이스:  Microsoft.Office.Tools.Excel
어셈블리:  Microsoft.Office.Tools.Excel.v9.0(Microsoft.Office.Tools.Excel.v9.0.dll)

구문

<BrowsableAttribute(False)> _
Public Overridable ReadOnly Property Controls As ControlCollection

Dim instance As Worksheet
Dim value As ControlCollection

value = instance.Controls
[BrowsableAttribute(false)]
public virtual ControlCollection Controls { get; }

속성 값

형식: Microsoft.Office.Tools.Excel.ControlCollection

워크시트의 모든 컨트롤을 포함하는 ControlCollection입니다.

설명

워크시트는 컨트롤 컬렉션의 부모 역할을 합니다. 워크시트에 여러 컨트롤이 추가된 경우 각 컨트롤은 워크시트의 ControlCollection 멤버가 됩니다.

ControlCollection 클래스에서 사용할 수 있는 메서드를 사용하여 ControlCollection에서 컨트롤을 추가하거나 제거할 수 있습니다.

예제

다음 코드 예제에서는 Controls 속성을 사용하여 현재 워크시트에 Button을 추가합니다.

이 버전은 문서 수준 사용자 지정을 위한 것입니다.

Private Sub AddButton()
    Dim button1 As Button = _
        Me.Controls.AddButton(50, 50, 150, 50, "button1")
End Sub 'AddButton
private void AddButton()
{
    Button button1 = this.Controls.AddButton(50, 50, 150, 50, "button1");
}

이 버전은 응용 프로그램 수준 추가 기능을 위한 것입니다.

Private Sub AddButton()
    Dim vstoWorksheet As Worksheet = _
        CType(Me.Application.ActiveWorkbook.Worksheets(1), Excel.Worksheet) _
        .GetVstoObject()
    Dim button1 As System.Windows.Forms.Button = _
        vstoWorksheet.Controls.AddButton(50, 50, 150, 50, "button1")
End Sub 'AddButton
private void AddButton()
{
    Worksheet vstoWorksheet = ((Excel.Worksheet)
        this.Application.ActiveWorkbook.Worksheets[1]).GetVstoObject();
    System.Windows.Forms.Button button1 = 
        vstoWorksheet.Controls.AddButton(50, 50, 150, 50, "button1");
}

권한

  • 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

Worksheet 클래스

Worksheet 멤버

Microsoft.Office.Tools.Excel 네임스페이스

변경 기록

날짜

변경 내용

이유

2008년 7월

응용 프로그램 수준 추가 기능의 코드 예제 버전이 추가되었습니다.

SP1 기능 변경