How to Determine If a Workbook or a Worksheet Is Protected (161245)



The information in this article applies to:

  • Microsoft Excel 97 for Windows
  • Microsoft Excel for Windows 95
  • Microsoft Excel for Windows 5.0
  • Microsoft Excel 98 Macintosh Edition

This article was previously published under Q161245

SUMMARY

This article provides Visual Basic for Applications sample macros that determine whether a workbook or a worksheet is protected.

MORE INFORMATION

Microsoft provides programming examples for illustration only, without warranty either expressed or implied. This includes, but is not limited to, the implied warranties of merchantability or fitness for a particular purpose. This article assumes that you are familiar with the programming language that is being demonstrated and with the tools that are used to create and to debug procedures. Microsoft support engineers can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific requirements.

Example 1: Determining Whether a Workbook Is Protected

   Dim X As Boolean

   Sub Test_Workbook_Protection()

       X = False

       If ActiveWorkbook.ProtectWindows Then X = True
       If ActiveWorkbook.ProtectStructure Then X = True

       If X = False Then
           MsgBox "The workbook is not protected."
       Else
           MsgBox "The workbook is protected."
       End If

   End Sub
				

Example 2: Determining Whether a Worksheet Is Protected

   Sub Test_Worksheet_Protection()

       X = False

       If ActiveSheet.ProtectContents Then X = True
       If ActiveSheet.ProtectDrawingObjects Then X = True
       If ActiveSheet.ProtectScenarios Then X = True

       If X = False Then
           MsgBox "The worksheet is not protected."
       Else
           MsgBox "The worksheet is protected."
       End If

   End Sub
				

REFERENCES

For additional information about getting help with Visual Basic for Applications, please see the following article in the Microsoft Knowledge Base:

163435 VBA: Programming Resources for Visual Basic for Applications

Microsoft Excel 97

For more information about protection in Microsoft Excel, click the Index tab in Microsoft Excel Help, type the following text

protecting, worksheets and workbooks

and then double-click the selected text to go to the "Control access to workbooks and worksheets" topic.

Microsoft Excel 5.0

For more information about protection in Microsoft Excel, click the Search button in Help and type:

protecting documents


Modification Type:MinorLast Reviewed:10/11/2006
Keywords:kbdtacode kbProgramming KB161245