Button.BringToFront 메서드

Button을 z 순서 앞에 놓습니다.

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

구문

‘선언
Public Function BringToFront As Object

public Object BringToFront()

반환 값

형식: System.Object
이 메서드는 null 참조를 반환 합니다. (Nothing Visual Basic); 그렇지 않으면이 메서드는 반환 true.

설명

이 메서드는 Button의 z 순서를 OLEObjects 컬렉션의 마지막 인덱스로 설정합니다. z 순서에 번호를 매기는 순서는 OLEObjects 컬렉션의 인덱스에 번호를 매기는 순서와 반대입니다.OLEObjects 컬렉션에서 인덱스가 커질수록 Button의 z 순서는 작아집니다.

예제

다음 코드 예제에서는 BringToFront와 SendToBack 메서드를 사용하여 워크시트에서 세 Button 컨트롤의 z 순서를 설정합니다.현재 z 순서의 앞에 있는 단추를 클릭하면 해당 단추는 SendToBack을 호출하여 컬렉션의 뒤로 이동합니다.그렇지 않으면 해당 단추는 BringToFront를 호출하여 컬렉션의 앞으로 이동합니다.세 단추의 z 순서는 처음에 2에서 4까지입니다.워크시트의 런타임 저장소 컨트롤은 처음에 z 순서의 위치가 1입니다.

이 예제는 문서 수준 사용자 지정을 위한 것입니다.

Private Sub ToggleZOrder()
    Dim Button1 As Microsoft.Office.Tools.Excel.Controls.Button = _
        Me.Controls.AddButton(Me.Range("A1", "B2"), "Button1")
    Button1.BackColor = Color.Blue

    Dim Button2 As Microsoft.Office.Tools.Excel.Controls.Button = _
        Me.Controls.AddButton(Me.Range("B2", "C3"), "Button2")
    Button2.BackColor = Color.Red

    Dim Button3 As Microsoft.Office.Tools.Excel.Controls.Button = _
        Me.Controls.AddButton(Me.Range("C3", "D4"), "Button3")
    Button3.BackColor = Color.Green

    AddHandler Button1.Click, AddressOf ZOrderButton_Click
    AddHandler Button2.Click, AddressOf ZOrderButton_Click
    AddHandler Button3.Click, AddressOf ZOrderButton_Click
End Sub

Private Sub ZOrderButton_Click(ByVal sender As Object, ByVal e As EventArgs)
    Dim ClickedButton As Microsoft.Office.Tools.Excel.Controls.Button = _
        CType(sender, Microsoft.Office.Tools.Excel.Controls.Button)

    If ClickedButton.ZOrder = 4 Then
        ClickedButton.SendToBack()
    Else
        ClickedButton.BringToFront()
    End If
End Sub

private void ToggleZOrder()
{
    Microsoft.Office.Tools.Excel.Controls.Button button1 =
        this.Controls.AddButton(this.Range["A1", "B2"],
        "button1");
    button1.BackColor = Color.Blue;

    Microsoft.Office.Tools.Excel.Controls.Button button2 =
        this.Controls.AddButton(this.Range["B2", "C3"],
        "button2");
    button2.BackColor = Color.Red;

    Microsoft.Office.Tools.Excel.Controls.Button button3 =
        this.Controls.AddButton(this.Range["C3", "D4"],
        "button3");
    button3.BackColor = Color.Green;

    button1.Click += new EventHandler(zOrderButton_Click);
    button2.Click += new EventHandler(zOrderButton_Click);
    button3.Click += new EventHandler(zOrderButton_Click);
}

void zOrderButton_Click(object sender, EventArgs e)
{
    Microsoft.Office.Tools.Excel.Controls.Button clickedButton =
        (Microsoft.Office.Tools.Excel.Controls.Button)sender;

    if (clickedButton.ZOrder == 4)
    {
        clickedButton.SendToBack();
    }
    else
    {
        clickedButton.BringToFront();
    }
}

.NET Framework 보안

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

참고 항목

참조

Button 클래스

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