WD2000: How to Get FormField CheckBox Value (223272)



The information in this article applies to:

  • Microsoft Word 2000

This article was previously published under Q223272

SUMMARY

When you use the Microsoft Word FormFields collection item with the CheckBox object, the value returned is a Boolean (True/False). To test whether the check box is selected, you can use the If statement.

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.
The following example code displays a message box telling you whether the check box is selected or not selected. This code is designed to run as an On Exit macro assigned to a check box.

Sub GetCheckBoxValue()
   If Selection.FormFields("check1").Result = True Then
      MsgBox "Box Checked"
   '< Type code to execute if box is checked.>
    Else
      MsgBox "Box is Not Checked"
   '< Type code to execute if box is not checked.>
   End If
End Sub
				


NOTE: When using the Result property with the check box, the value returned is a "1" for True and a "0" for False.
    x = ActiveDocument.FormFields("Check1").Result
    MsgBox x
				

As an alternative to the above example code, you can use the Value property to check the result. The following code example uses the Value property:
If ActiveDocument.FormFields("check1").CheckBox.Value = True Then
    MsgBox "Box Checked"
Else
    MsgBox "Box is Not Checked"
End If

				
For more information about how to use the sample code in this article, click the article number below to view the article in the Microsoft Knowledge Base:

212536 OFF2000: How to Run Sample Code from Knowledge Base Articles

REFERENCES

For more information about the FormField CheckBox, in the Visual Basic Editor, click Microsoft Visual Basic Help on the Help menu, type CheckBox Object in the Office Assistant or the Answer Wizard, and then click Search to view the topic.

Modification Type:MinorLast Reviewed:10/11/2006
Keywords:kbhowto kbProgramming KB223272