Propriedade Button.Locked

Artigo
01/09/2014

Obtém ou define um valor que indica se Button pode ser alterado em tempo de design quando a folha é protegida.

Namespace: Microsoft.Office.Tools.Excel.Controls
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
<BrowsableAttribute(False)> _
Public Property Locked As Boolean

[BrowsableAttribute(false)]
public bool Locked { get; set; }

Valor de propriedade

Tipo: System.Boolean
true se Button não pode ser modificado em tempo de design quando a folha é protegida; caso contrário, false.

Comentários

Button pode ser bloqueado somente quando a folha é protegida. Button bloqueado não pode ser movido ou redimensionado em tempo de design.

Exemplos

O exemplo de código a seguir adiciona dois controles de Button a planilha atual e defina a propriedade de Locked de um dos botões para true. O exemplo então protege a planilha e usa o método de ToggleFormsDesign para colocar o Microsoft Office Excel no modo de design. Neste ponto, o botão desbloqueado pode ser movido, redimensionado e mas o botão bloqueado não pode ser movido ou redimensionado.

Este exemplo é para uma personalização de um documento nível.

Private Sub TestLockedControl()

    Dim LockedButton As Microsoft.Office.Tools.Excel.Controls.Button = _
        Me.Controls.AddButton(Me.Range("B2", "C3"), "LockedButton")
    LockedButton.Locked = True
    LockedButton.Text = "Locked button"

    Dim UnlockedButton As Microsoft.Office.Tools.Excel.Controls.Button = _
        Me.Controls.AddButton(Me.Range("B6", "C7"), "UnlockedButton")
    UnlockedButton.Locked = False
    UnlockedButton.Text = "Unlocked button"

    Me.Protect()
    Globals.ThisWorkbook.ToggleFormsDesign()
End Sub

private void TestLockedControl()
{
    Microsoft.Office.Tools.Excel.Controls.Button lockedButton =
            this.Controls.AddButton(this.Range["B2", "C3"],
            "lockedButton");
    lockedButton.Locked = true;
    lockedButton.Text = "Locked button";

    Microsoft.Office.Tools.Excel.Controls.Button unlockedButton =
            this.Controls.AddButton(this.Range["B6", "C7"],
            "unlockedButton");
    unlockedButton.Locked = false;
    unlockedButton.Text = "Unlocked button";

    this.Protect();
    Globals.ThisWorkbook.ToggleFormsDesign();
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

Button Classe

Namespace Microsoft.Office.Tools.Excel.Controls

Compartilhar via