Sets all the contained control values using the supplied flat map
the number of control (key, value) pairs that were successfully set
a flat map of control keys and values must not be null