LockPicture Property

Summary

Gets or sets the id of the picture used when drawing the locked symbol for locked objects.

Syntax

Objective-C

C++/CLI

Java

Python

public int LockPicture { get; set; }

@property (nonatomic, assign) NSInteger lockPicture;

public int getLockPicture() 
public void setLockPicture(int picture)

public:  
   property Int32 LockPicture 
   { 
      Int32 get() 
      void set(Int32 value) 
   }

LockPicture # get and set (AnnObject)

Property Value

The id of the picture used when drawing the locked symbol for locked objects. The default value is 1.

Remarks

All objects of this type inside the container will use this picture when drawing the object if the object is locked.

The container uses a picture of a "lock" that is created by default. You can change this default picture by using this property.

For more information, refer to Implementing Annotation Security.

Example

using Leadtools.Annotations.Automation; 
using Leadtools.Annotations.Engine; 
using Leadtools.WinForms; 
using Leadtools.Annotations.WinForms; 
 
public void AnnObject_Lock() 
{ 
   double inch = 720.0; 
 
   // Get the container 
   AnnContainer container = _automation.Container; 
 
   // Add the lock picture to the container resources 
 
   // Create a new instance of AnnResources if the container does not already have one 
   AnnResources resources = _automation.Manager.Resources; 
   if (resources == null) 
   { 
      resources = new AnnResources(); 
   } 
 
   // Get the images collection 
   IList<AnnPicture> imagesResources = resources.Images; 
 
   // Add our picture to it 
   imagesResources.Add(new AnnPicture(@"ms-appx:///Assets/Lock.png")); 
   int pictureIndex = imagesResources.Count - 1; 
 
   // Add a blue on yellow rectangle from 3in 3in to 4in 4in 
   AnnRectangleObject rectObj = new AnnRectangleObject(); 
   rectObj.Rect = LeadRectD.Create(3 * inch, 3 * inch, 1 * inch, 1 * inch); 
   rectObj.Stroke = AnnStroke.Create(AnnSolidColorBrush.Create("Blue"), LeadLengthD.Create(1)); 
   rectObj.Fill = AnnSolidColorBrush.Create("Yellow"); 
 
   // Set its lock picture 
   rectObj.LockPicture = pictureIndex; 
 
   // Add it to the container 
   container.Children.Add(rectObj); 
 
   // Show the object lock state (default) 
   Debug.WriteLine("1. Default lock state"); 
   ShowLockedState(rectObj); 
 
   // Lock it with a password 
   Debug.WriteLine("2. Locking now with a password"); 
   rectObj.Lock("secret"); 
 
   // Show the object lock state, it should say locked and the object should be painted with the lock picture 
   ShowLockedState(rectObj); 
 
   // Now try to unlock it with a wrong password 
   Debug.WriteLine("3. Unlocking with a wrong password"); 
   rectObj.Unlock("wrong password"); 
 
   // Check, it should be locked 
   ShowLockedState(rectObj); 
 
   // Unlock it with the correct password 
   Debug.WriteLine("4. Unlocking with a correct password"); 
   rectObj.Unlock("secret"); 
 
   // Check lock status 
   ShowLockedState(rectObj); 
 
   //Lock using a new password 
   Debug.WriteLine("5. Locking with a new password"); 
   rectObj.Lock("NewPassword"); 
   ShowLockedState(rectObj); 
 
   //Change the password used in the last lock operation 
   Debug.WriteLine("6. After being locked, change to new password"); 
   rectObj.Password = "secret-again"; 
    ShowLockedState(rectObj); 
} 
 
private void ShowLockedState(AnnObject annObj) 
{ 
   _automation.Invalidate(LeadRectD.Empty); 
 
   // Show the object lock state (default) 
   Debug.WriteLine($"\tLocked: {annObj.IsLocked} | Password: {annObj.Password}"); 
}

Requirements

Target Platforms

Reference

AnnObject Class

AnnObject Members

Download our FREE evaluation

Help Version 23.0.2024.2.29

Leadtools.Annotations.Engine Assembly

Introduction

Getting Started

Namespaces

Leadtools.Annotations.Engine Namespace

Assemblies