Propriedade Button.Locked

Artigo
08/01/2011

Obtém ou define um valor que indica se a Button pode ser modificado em tempo de design quando a planilha estiver 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
    Get
    Set

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

Valor de propriedade

Tipo: System.Boolean
true Se a Button não pode ser modificado em tempo de design quando a planilha estiver protegida; Caso contrário, false.

Comentários

A Button somente podem ser bloqueados quando a planilha estiver protegida. Um bloqueada Button não pode ser movida ou redimensionada em tempo de design.

Exemplos

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

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

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(missing, missing, missing, missing, missing,
         missing, missing, missing, missing, missing, missing, 
         missing, missing, missing, missing, missing);
    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áveis.

Consulte também

Referência

Button Classe

Namespace Microsoft.Office.Tools.Excel.Controls

Partilhar via