/// <summary>
/// Creates a binding between a dependency property and a network table entry
/// </summary>
/// <typeparam name="TLocal">The type of the entry in the dashboard</typeparam>
/// <typeparam name="TNetwork">The type of the entry in the network table</typeparam>
/// <param name="source">The object to bind to</param>
/// <param name="property">The property to bind. Attached properties will throw an exception</param>
/// <param name="networkPath">The full path of the entry in the network table</param>
/// <param name="converter">The conversion mapping between the network values and local values</param>
/// <param name="localOverride">Whether the local dashboard values should take precedence when the binding occurs</param>
public static void Create <TLocal, TNetwork>(DependencyObject source, DependencyProperty property, string networkPath,
NTConverter <TLocal, TNetwork> converter, bool localOverride = false)
{
if (!IsRunning)
{
throw new InvalidOperationException("Can only create bindings while the network table is running");
}
Tuple <ITable, string> networkSource = NormalizeKey(networkPath);
networkPath = networkSource.Item2;
//because of additional work that needs to be done to bind the value, simpler to reimplement
DependencyNotifyListener listener = new DependencyNotifyListener(source);
if (!propertyLookup.ContainsKey(listener))
{
propertyLookup[listener] = new OneToOneConversionMap <string, string>();
//this is a new item being bound, have it notify us of updates
listener.PropertyChanged += OnLocalValueChange;
}
if (propertyLookup[listener].TryAdd(property.Name, networkPath))
{
customTables[listener] = networkSource.Item1;
//this means there were no binding conflicts
//bind the dependency property to be notified of changes to it
listener.BindProperty(property);
//map a conversion if needed; null is valid
propertyLookup[listener].MapConversionByFirst(property.Name, converter);
//make the values consistent by forcing an update.
//first check if the dashboard has a value at all
Value data = networkSource.Item1.GetValue(networkPath, null);
if (data == null || localOverride)
{
//send the local value to the network by "updating" the local value
PropertyChangedEventArgs e = new PropertyChangedEventArgs(property.Name);
OnLocalValueChange(listener, e);
}
else
{
//pull the dashboard from the local value by "updating" the network value
OnNetworkTableChange(networkSource.Item1, networkPath, data, NotifyFlags.NotifyUpdate);
}
}
}
/// <summary>
/// Creates a binding between an observable object property and a network table entry of a different type
/// </summary>
/// <typeparam name="TLocal">The type of the entry in the dashboard</typeparam>
/// <typeparam name="TNetwork">The type of the entry in the network table</typeparam>
/// <param name="source">The object to bind to</param>
/// <param name="property">The case-sensitive name of the property to bind</param>
/// <param name="networkPath">The full path of the entry in the network table</param>
/// <param name="converter">The conversion mapping between the network values and local values</param>
/// <param name="localOverride">Whether the local dashboard values should take precedence when the binding occurs</param>
public static void Create <TLocal, TNetwork>(INotifyPropertyChanged source, string property, string networkPath,
NTConverter <TLocal, TNetwork> converter, bool localOverride = false)
{
if (!IsRunning)
{
throw new InvalidOperationException("Can only create bindings while the network table is running");
}
Tuple <ITable, string> networkSource = NormalizeKey(networkPath);
networkPath = networkSource.Item2;
//add these to our dictionary
if (!propertyLookup.ContainsKey(source))
{
propertyLookup[source] = new OneToOneConversionMap <string, string>();
//this is a new item being bound; have it notify us of updates
source.PropertyChanged += OnLocalValueChange;
}
if (propertyLookup[source].TryAdd(property, networkPath))
{
customTables[source] = networkSource.Item1;
//this means there were no binding conflicts
//map a conversion if needed; null is a valid argument
propertyLookup[source].MapConversionByFirst(property, converter);
//make the values consistent by forcing an update.
//first check if the dashboard has a value at all
object data = networkSource.Item1.GetValue(networkPath, null);
if (data == null || localOverride)
{
//send the local value to the network by "updating" the local value
PropertyChangedEventArgs e = new PropertyChangedEventArgs(property);
OnLocalValueChange(source, e);
}
else
{
//pull the dashboard from the local value by "updating" the network value
OnNetworkTableChange(networkSource.Item1, networkPath, Value.MakeValue(data), NotifyFlags.NotifyUpdate);
}
}
}
/// <summary>
/// Updates an existing binding between a dependency property and a network table entry
/// </summary>
/// <typeparam name="TLocal">The type of the entry in the dashboard</typeparam>
/// <typeparam name="TNetwork">The type of the entry in the network table</typeparam>
/// <param name="source">The object to bind to</param>
/// <param name="property">The new property to bind. Attached properties will throw an exception</param>
/// <param name="networkPath">The full path of the new entry in the network table</param>
/// <param name="converter">The conversion mapping between network values and local values</param>
/// <param name="localOverride">Whether the local dashboard values should take precendence when the binding occurs</param>
public static void Update <TLocal, TNetwork>(DependencyObject source, DependencyProperty property, string networkPath,
NTConverter <TLocal, TNetwork> converter, bool localOverride = false)
{
Delete(source, property);
Create(source, property, networkPath, converter, localOverride);
}
/// <summary>
/// Updates an existing binding between an observable object property and a network table entry of a different type
/// </summary>
/// <typeparam name="TLocal">The type of the entry in the dashboard</typeparam>
/// <typeparam name="TNetwork">The type of the entry in the network table</typeparam>
/// <param name="source">The object the binding is on</param>
/// <param name="property">The new property to bind</param>
/// <param name="networkPath">The full path of the new entry in the network table</param>
/// <param name="converter">The conversion mapping between network values and local values</param>
/// <param name="localOverride">Whether the local dashboard values should take precendence when the binding occurs</param>
public static void Update <TLocal, TNetwork>(INotifyPropertyChanged source, string property, string networkPath,
NTConverter <TLocal, TNetwork> converter, bool localOverride = false)
{
Delete(source, property);
Create(source, property, networkPath, converter, localOverride);
}
