KnowledgeBase Archive

An Archive of Early Microsoft KnowledgeBase Articles

View on GitHub

Q159612: WD: Creating a Password-Style Macro Dialog Text Box

Article: Q159612
Product(s): Word 97 for Windows
Version(s): WINDOWS:97
Operating System(s): 
Keyword(s): kbmacro kbusage kbdta word8 kbwordvba word97
Last Modified: 13-MAY-2002

-------------------------------------------------------------------------------
The information in this article applies to:

- Microsoft Word 97 for Windows 
-------------------------------------------------------------------------------


SUMMARY
=======

You can use Microsoft Visual Basic for Applications to create a dialog box that
prompts a user for a password. Using the PasswordChar property, you can display
"placeholder" characters, such as asterisks, that appear when a user types the
password.

MORE INFORMATION
================

Microsoft provides programming examples for illustration only, without warranty
either expressed or implied, including, but not limited to, the implied
warranties of merchantability and/or fitness for a particular purpose. This
article assumes that you are familiar with the programming language being
demonstrated and the tools used to create and debug procedures. Microsoft
support professionals 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 needs. If you have
limited programming experience, you may want to contact a Microsoft Certified
Partner or the Microsoft fee-based consulting line at (800) 936-5200. For more
information about Microsoft Certified Partners, please visit the following
Microsoft Web site:

  http://www.microsoft.com/partner/referral/

For more information about the support options that are available and about how
to contact Microsoft, visit the following Microsoft Web site:

  http://support.microsoft.com/default.aspx?scid=fh;EN-US;CNTACTMS

You can use the PasswordChar property of the TextBox control to protect sensitive
information, such as passwords or security codes. The value of PasswordChar is
the character that appears in a control instead of the actual characters that
the user types. If you do not specify a character, the control displays the
characters that the user types.

In the following example, the user form contains a TextBox control that uses the
PasswordChar property to display asterisks instead of the password that the user
types.

Creating the User Form
----------------------

Create the form using the following steps:

1. On the Tools menu, point to Macro, and then click Visual Basic Editor.

2. In the Visual Basic project window, click Normal.

  The form will be available to all documents.

3. On the Insert menu, click UserForm.

4. Click the TextBox control on the Toolbox toolbar and then click the form.

  The TextBox control appears in the default size. Drag a sizing handle to
  resize the control or drag the control to move it to a new location.

5. Select the TextBox control and press F4.

  The Properties window appears.

6. In the Properties window, type an "*" (without the quotation marks) for the
  value of the PasswordChar property.

7. Click the CommandButton control on the Toolbox toolbar and then click the
  form.

  The CommandButton control appears in the default size. Drag a sizing handle to
  resize the control or drag the control to move it to a new location.

  Repeat this step to add a second CommandButton control.

8. Select the first CommandButton control and then click Code on the View menu.

9. In the Code window, type "MsgBox TextBox1.Text" (without the quotation
  marks), so that your code looks like this:

  Private Sub CommandButton1_Click ()
     ' When you click this button on the form,
     ' the contents of the text
     ' box appear in a message box.
     MsgBox TextBox1.Text
  End sub

10. On the View menu, click Object to return to the form.

11. Select the second command button control and then click Code on the View
  menu.

12. In the Code window, type "End" (without the quotation marks), so that your
  code looks like this:

  Private Sub CommandButton2_Click ()
     ' When this button is clicked, the form is closed
     ' and the program ends.
     End
  End sub

13. On the File menu, click Save Normal.

Displaying the User Form
------------------------

To display the form, switch to Word, and then do the following:

1. On the Tools menu, point to Macro, and then click Macros.

2. In the Macro Name box, type "FillInForm" (without the quotation marks), and
  then click Create.

3. In the Code window, type "UserForm1.Show" (without the quotation marks), so
  that your code looks like this:

  Sub FillInForm()
  'This macro displays the user form.
     UserForm1.Show
  End Sub

4. Save and close the macro.

5. Close the Visual Basic Editor.

6. You can now run the macro from Word to display the form.

For information about how to do this in earlier versions of Word, please see the
following article in the Microsoft Knowledge Base:

  

  Q114299 Creating a Password-Style Macro Dialog Text Box

For additional information, please see the following article in the Microsoft
Knowledge Base:

  

  Q173707 OFF97: How to Run Sample Code from Knowledge Base Articles


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

  

  Q163435 VBA: Programming Resources for Visual Basic for Applications

Additional query words: wordcon vb vba vbe

======================================================================
Keywords          : kbmacro kbusage kbdta word8 kbwordvba word97 
Technology        : kbWordSearch kbWord97 kbWord97Search kbZNotKeyword2
Version           : WINDOWS:97
Issue type        : kbhowto

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 1986-2002.