Button.Locked-Eigenschaft

Artikel
08/10/2011

Ruft einen Wert ab, der angibt, ob Button zur Entwurfszeit geändert werden kann, wenn das Blatt geschützt ist, oder legt diesen fest.

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

Syntax

'Declaration
<BrowsableAttribute(False)> _
Public Property Locked As Boolean
    Get
    Set

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

Eigenschaftswert

Typ: System.Boolean
true, wenn Button zur Entwurfszeit nicht geändert werden kann, wenn das Blatt geschützt ist; andernfalls false.

Hinweise

Button kann nur gesperrt werden, wenn das Blatt geschützt ist. Zur Entwurfszeit ist es nicht möglich, gesperrte Button zu verschieben oder deren Größe zu ändern.

Beispiele

Im folgenden Codebeispiel werden dem aktuellen Arbeitsblatt zwei Button-Steuerelemente hinzugefügt, und die Locked-Eigenschaft einer der Schaltflächen wird auf true festgelegt. Anschließend wird das Arbeitsblatt geschützt, und mithilfe der ToggleFormsDesign-Methode wird Microsoft Office Excel in den Entwurfsmodus versetzt. Nun kann die Größe der entsperrten Schaltfläche geändert werden, und sie kann verschoben werden. Die gesperrte Schaltfläche kann hingegen nicht verschoben werden, und ihre Größe kann nicht geändert werden.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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();
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

Button Klasse

Microsoft.Office.Tools.Excel.Controls-Namespace

Freigeben über