LockControls Property | ActiveReports 19 .NET Edition

LockControls Property

In This Topic

Syntax
Remarks
Example
See Also

Specifies whether the controls are locked in place.

Syntax

Visual Basic
C#

public bool LockControls {get; set;}

'Declaration
 
Public Property LockControls As Boolean

Property Value

Boolean value. If True, the controls cannot be moved or sized. If False, the controls can be moved or sized.

Remarks

When set to true, this property prevents any modifications to the controls' properties, size, or position within the designer, effectively making the design surface read-only. This is useful in scenarios where the design of the report is finalized and should not be altered.

Example

The sample below opens a Windows Form with the designer, featuring a pre-built report. Users can modify certain properties of existing controls, but changing the report layout-specifically the position or size of report items-is not possible.

private void designer1_Load(object sender, System.EventArgs e)
{
    this.designer1.DrawGrid = true;
    this.designer1.GridX = 16;
    this.designer1.GridY = 16;
    this.designer1.LockControls = false;
    this.designer1.ShowDataSourceIcon = true;
    this.designer1.ToolBoxItem = null;
}

Visual Basic

Private Sub Designer1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Designer1.Load
    Me.Designer1.DrawGrid = True
    Me.Designer1.GridX = 16
    Me.Designer1.GridY = 16
    Me.Designer1.LockControls = False
    Me.Designer1.ShowDataSourceIcon = True
    Me.Designer1.ToolBoxItem = Nothing
End Sub

Reference

Designer Class
Designer Members

Product Support Forum | Print this page