How to programmatically apply conditional formatting settings to all form controls

Article translations Article translations
Article ID: 304104 - View products that this article applies to.
This article was previously published under Q304104
Advanced: Requires expert coding, interoperability, and multiuser skills.

This article applies to a Microsoft Access database (.mdb) and to a Microsoft Access project (.adp).

Expand all | Collapse all

SUMMARY

In Microsoft Access 2000, conditional formatting was added to forms and reports to allow users to format a control based on a particular condition. However, in the Access user interface, you cannot automatically propagate the conditional formatting of one control to all other controls on the form. But you can do this by using the FormatConditions collection of the control on which the initial conditional format has been set. This article shows you how to use code to propagate the conditional formatting of one control to all other controls on the form.

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. For an example of how to propagate the conditional formatting of one control to all other controls on the form, follow these steps.

CAUTION: If you follow the steps in this example, you modify the sample database Northwind.mdb. You may want to back up the Northwind.mdb file and follow these steps on a copy of the database.

  • If you use Access 2002 or Access 2003, follow these steps:
    1. Start Access.
    2. On the Help menu, point to Sample Databases, and then click Northwind Sample Database.
    3. In the Database window, click the Modules under Objects.
    4. Click New to create a new module.
    5. Add the following line to the Declarations section of the module if it is not already there:
      Option Explicit
      					
    6. Type or paste the following code:
      Function AddFormats(ctlSource As Control, frm As Form) As Integer
      
          Dim ctl As Control
          Dim fcdSource As FormatCondition
          Dim fcdDestination As FormatCondition
          Dim varOperator As Variant
          Dim varType As Variant
          Dim varExpression1 As Variant
          Dim varExpression2 As Variant
          Dim intConditionCount As Integer
          Dim intCount As Integer
          
          intConditionCount = ctlSource.FormatConditions.Count
          
          For Each ctl In frm.Controls
              If ctl.Name = ctlSource.Name Then
                  ' This is the source.  Don't apply formatting.
              ElseIf ctl.ControlType = acTextBox Or ctl.ControlType = acComboBox Then
                  intCount = 0
                  
                  ' Bulk remove all current FormatConditions
                  ctl.FormatConditions.Delete
                  
                  Do Until intCount = intConditionCount
                      Set fcdSource = ctlSource.FormatConditions.Item(intCount)
                      
                      varOperator = fcdSource.Operator
                      varType = fcdSource.Type
                      varExpression1 = fcdSource.Expression1
                      varExpression2 = fcdSource.Expression2
                      
                      ' Add the FormatCondition
                      ctl.FormatConditions.Add varType, varOperator, varExpression1, varExpression2
                      
                      ' Reference the FormatCondition to apply formatting.
                      ' Note: The FormatCondition cannot be referenced
                      ' in this manner until it exists.
                      Set fcdDestination = ctl.FormatConditions.Item(intCount)
                      
                      With fcdDestination
                          .BackColor = fcdSource.BackColor
                          .FontBold = fcdSource.FontBold
                          .FontItalic = fcdSource.FontItalic
                          .FontUnderline = fcdSource.FontUnderline
                          .ForeColor = fcdSource.ForeColor
                      End With
                      
                      ' Move to the next FormatCondition
                      intCount = intCount + 1
                  
                  Loop
              End If
          Next ctl
          
          ' Cleanup
          AddFormats = intConditionCount
          MsgBox "There were " & AddFormats & " Conditional Format(s) applied to all text and combo boxes except the source."
          Set ctl = Nothing
          Set fcdSource = Nothing
          Set fcdDestination = Nothing
          Set varOperator = Nothing
          Set varType = Nothing
          Set varExpression1 = Nothing
          Set varExpression2 = Nothing
          intConditionCount = 0
          intCount = 0
      
      End Function
      					
    7. Save the module as Module1.
    8. Open the Orders form in Design view.
    9. Click the Freight text box.
    10. On the Format menu, click Conditional Formatting, and then apply the following conditional formats to the Freight text box:
      • Condition 1 = Field Has Focus, Fill/Back Color = Yellow
      • Condition 2 = Field Value Is Equal To 1, Font/Fore Color = Green
      • Condition 3 = Expression Is 1+1=2, Underline = True

    11. Add a command button named cmdApplyCondFormat to the Orders form.
    12. Set the OnClick property of the command button to the following event procedure:
      Private Sub cmdApplyCondFormat_Click()
          AddFormats Me.Freight, Me
      End Sub
    13. Save the Orders form.
    14. Open the Orders form in Form View. Note the conditional formatting of the Freight text box.
    15. Click the command button to apply the Freight text box conditional formatting to all other text and combo boxes on the main form.
  • If you use Access 2007, follow these steps:
    1. Start Access, and then open sample datebase.
    2. On the Create tab, click Macro in the Other group, and then click Module.
    3. Add the following line to the Declarations section of the module if it is not already there:
      Option Explicit
      					
    4. Type or paste the following code:
      Function AddFormats(ctlSource As Control, frm As Form) As Integer
      
          Dim ctl As Control
          Dim fcdSource As FormatCondition
          Dim fcdDestination As FormatCondition
          Dim varOperator As Variant
          Dim varType As Variant
          Dim varExpression1 As Variant
          Dim varExpression2 As Variant
          Dim intConditionCount As Integer
          Dim intCount As Integer
          
          intConditionCount = ctlSource.FormatConditions.Count
          
          For Each ctl In frm.Controls
              If ctl.Name = ctlSource.Name Then
                  ' This is the source.  Don't apply formatting.
              ElseIf ctl.ControlType = acTextBox Or ctl.ControlType = acComboBox Then
                  intCount = 0
                  
                  ' Bulk remove all current FormatConditions
                  ctl.FormatConditions.Delete
                  
                  Do Until intCount = intConditionCount
                      Set fcdSource = ctlSource.FormatConditions.Item(intCount)
                      
                      varOperator = fcdSource.Operator
                      varType = fcdSource.Type
                      varExpression1 = fcdSource.Expression1
                      varExpression2 = fcdSource.Expression2
                      
                      ' Add the FormatCondition
                      ctl.FormatConditions.Add varType, varOperator, varExpression1, varExpression2
                      
                      ' Reference the FormatCondition to apply formatting.
                      ' Note: The FormatCondition cannot be referenced
                      ' in this manner until it exists.
                      Set fcdDestination = ctl.FormatConditions.Item(intCount)
                      
                      With fcdDestination
                          .BackColor = fcdSource.BackColor
                          .FontBold = fcdSource.FontBold
                          .FontItalic = fcdSource.FontItalic
                          .FontUnderline = fcdSource.FontUnderline
                          .ForeColor = fcdSource.ForeColor
                      End With
                      
                      ' Move to the next FormatCondition
                      intCount = intCount + 1
                  
                  Loop
              End If
          Next ctl
          
          ' Cleanup
          AddFormats = intConditionCount
          MsgBox "There were " & AddFormats & " Conditional Format(s) applied to all text and combo boxes except the source."
          Set ctl = Nothing
          Set fcdSource = Nothing
          Set fcdDestination = Nothing
          Set varOperator = Nothing
          Set varType = Nothing
          Set varExpression1 = Nothing
          Set varExpression2 = Nothing
          intConditionCount = 0
          intCount = 0
      
      End Function
      					
    5. Save the module as Module1.
    6. Open the Orders Details form in Design view.
    7. Click the Customer ID dropdown list, click Conditional, and then apply the following conditional formats to the Customer ID dropdown list:
      • Condition 1 = Field Has Focus, Fill/Back Color = Yellow
      • Condition 2 = Field Value Is Equal To 1, Font/Fore Color = Green
      • Condition 3 = Expression Is 1+1=2, Underline = True
    8. Add a command button named cmdApplyCondFormat to the Order Details form.
    9. Set the OnClick property of the command button to the following event procedure:
      Private Sub cmdApplyCondFormat_Click()
          AddFormats Me.Customer_ID, Me
      End Sub
    10. Save the Order Details form.
    11. Open the Order Details form in Form View. Note the conditional formatting of the Customer ID text box.
    12. Click the command button to apply the Payment Date text box conditional formatting to all other text and combo boxes on the main form.

Properties

Article ID: 304104 - Last Review: April 10, 2007 - Revision: 7.1
APPLIES TO
  • Microsoft Office Access 2007
  • Microsoft Office Access 2003
  • Microsoft Access 2002 Standard Edition
Keywords: 
kbprogramming kbvba kbinfo kbhowto KB304104

Give Feedback

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com