LegHumped.com » » Leghumped

Finding Next Available Name in Objective-C

Harry Jennerway — Wed, 11 Jan 2012 20:15:37 +0000

Useful method for finding the next available unique name in a batch of strings.

Eg: give it A list of { “Name”, “Name 1″, “Name 2″ } and it will return “Name 3″.

+(NSString*)getNextAVailableName:(NSString*)name fromNames:(NSMutableArray*)otherNames {
    if ([otherNames indexOfObjectPassingTest:^BOOL(id obj, NSUInteger idx, BOOL *stop) {
        return [[name lowercaseString] isEqualToString:(NSString*)obj];
    }] == NSNotFound) {
        return name;
    }
    bool gotName=false;
    NSString *currentName = name;
    for(int i = 2; !gotName; ) {
        currentName = [NSString stringWithFormat:@"%@ %d", name , i];
        if([otherNames indexOfObjectPassingTest:^BOOL(id obj, NSUInteger idx, BOOL *stop) {
            return [[currentName lowercaseString] isEqualToString:(NSString*)obj];
        }] != NSNotFound) {
            i++;
        } else {
            name = currentName;
            gotName = true;
        }
    }
    return name;
}

Internal Subnav with BlogEngine.NET

Harry Jennerway — Tue, 03 Jan 2012 15:15:39 +0000

One of the great ASP.NET web apps I’ve started using is BlogEngine.NET, a fairly simple yet powerful CMS. While it handles basic CMS type functionality without problems, there are something which it doesn’t make particularly easy, such as displaying navigation trees.

This can be largely overcome by extending some of the controls which BlogEngine ships with, such as the post list. I changed this to display a list of sub pages for the current page. Once you set a page’s parent page, the subnav is rendered on the masterpage.

We just need one control on page.aspx and some code to bind it in the code-behind:

    private void ServePage(Guid id) {
 	...
  	if(pg.Parent == Guid.Empty)
        {
            // root page
            pageList.RootPageID = id;
        } else
        {
            // sub page of root level page
            pageList.RootPageID = pg.Parent;
        }

Out of the box, the html for the tree is generated once which won’t work if it’s different for every page, so you’ll also need to modify PageList.cs in the ~/App_Code/Controls folder. I kept the caching and replaced it with a dictionary for each page to map between page ID and HTML for the page list.

 static PageList()
        {
            BlogEngine.Core.Page.Saved += (sender, args) => PageList.ClearCachedHtml();
            ClearCachedHtml();
        }
 
        private static void ClearCachedHtml()
        {
            HttpContext.Current.Items.Remove("PageList");
        }
 
	//We also need a few more properties:
	#region Properties
        private static Dictionary<Guid,string> HtmlDictionary
        {
            get
            {
                const string cacheKey = "pageListDict";
                var htmlDict = HttpContext.Current.Cache[cacheKey] as Dictionary<Guid, string>;
                if (htmlDict == null)
                {
                    htmlDict = new Dictionary<Guid, string>();
                    HttpContext.Current.Cache[cacheKey] = htmlDict;
                }
                return htmlDict;
            }
        }
 
        private static string GetPageListForPage(Guid pageId)
        {
            string html;
            if (!HtmlDictionary.TryGetValue(pageId, out html))
            {
                html = BlogEngine.Core.Utils.RenderControl(BindPages(pageId));
                HtmlDictionary.Add(pageId, html);
            }
            return html;
        }
 
        public Guid? RootPageID
        {
            get
            {
                return ViewState["RootPageID"] == null
                           ? (Guid?) null
                           : new Guid(Convert.ToString(ViewState["RootPageID"]));
            }
            set { ViewState["RootPageID"] = value; }
        }
        #endregion

The root page ID specifies the parent pages whose children to render.

The final step is some changes to the private methods which render the lists:

public override void RenderControl(HtmlTextWriter writer)
        {
            writer.Write(GetPageListForPage(RootPageID??Guid.Empty));
           // writer.Write(Environment.NewLine);
        }
 
private static HtmlGenericControl BindPages(Guid? pageId)
        {
            //HtmlGenericControl div = new HtmlGenericControl("div");
            var div = new HtmlGenericControl("ul");
            div.Attributes.Add("class","softwareList");
            div.ID = "pagelist";
            foreach (BlogEngine.Core.Page page in BlogEngine.Core.Page.Pages)
            {
                if (page.ShowInList && page.IsVisibleToPublic && ((pageId.HasValue && pageId.Value == page.Parent) || (!pageId.HasValue && page.Parent.ToString() == "00000000-0000-0000-0000-000000000000")))
                {
                    div.Controls.Add(BuildSubPages(div, page));
                }
            }
            return div;
        }
 
        private static HtmlGenericControl BuildSubPages(Control parentElement, BlogEngine.Core.Page page)
        {
            List<BlogEngine.Core.Page> subPages = BlogEngine.Core.Page.Pages.Where(p => p.Parent == page.Id).ToList();
            HtmlGenericControl li = new HtmlGenericControl("li");
            HtmlAnchor anc = new HtmlAnchor();
            anc.HRef = page.RelativeLink.ToString();
            anc.InnerHtml = page.Title;
            anc.Title = page.Description;
            li.Controls.Add(anc);
            if (subPages.Any())
            {
                HtmlGenericControl ul = new HtmlGenericControl("ul");
                li.Controls.Add(ul);
                foreach (BlogEngine.Core.Page p in subPages)
                {
                    HtmlGenericControl innerLi = new HtmlGenericControl("li");
                    ul.Controls.Add(BuildSubPages(innerLi, p));
                }
            }
            parentElement.Controls.Add(li);
            return li;
        }

Though this should work for unlimited navigation levels, I’ve only tested it with two. Ideally, Umbraco is suited excellently to this due to it’s ability to use XSLT for jobs like this.

Improved componentsJoinedByString:

Harry Jennerway — Sun, 25 Dec 2011 15:21:57 +0000

To format list of categories, ingredients etc in a more readable way for ChickenPing, I use a function which joins a list of strings using a separator and a final separator. Eg:

    NSArray *items = [[NSArray alloc] initWithObjects:@"Item1", @"Item2", @"Item3", nil];
    NSString *joined = [Utils implode:items withSeperator:@", " trimStrings:true lastSeparator:@" and "];
    // returns "Item1, Item2 and Item3"

It’s more flexible than NSArraycomponentsJoinedByString: because it includes an optional last separator and the option to trim strings. Code is below.

/// 
/// Joins a list using a separator.
/// 
/// The list to join.
/// The separator to use.
/// If set to true, trims whitespace from each index.
/// A string containing the values separated by the separator
+(NSString*)implode:(NSArray*)items withSeperator:(NSString*)separator trimStrings:(bool)trim {
    return [Utils implode:items withSeperator:separator trimStrings:trim lastSeparator:separator];
}
 
/* 
 *  Joins a list using a separator.
 * 
 * The list to join.
 * The separator to use.
 * If set to true, trims whitespace from each index.
 * The separator to use to join the second to last and last item, or null to use the separator. Eg: Could be "and".
 * A string containing the values separated by the separator
 */
+(NSString*)implode:(NSArray*)items withSeperator:(NSString*)separator trimStrings:(bool)trim lastSeparator:(NSString*)separatorForLastItem {
    NSMutableString *buffer = [[NSMutableString alloc] init];
    int num = [items count],
        added = 0;
    for (NSString *item in items) {
            [buffer appendString:trim ? [item stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]]
                                      : item];
        if (added + 1 < num) {
            if (added == num - 2 && separatorForLastItem != nil) {
                [buffer appendString:separatorForLastItem];
            } else {
                [buffer appendString:separator];
            }
        }
        added++;
    }
    return [buffer copy];
}

jQuery Collapsible Panel Plugin

Harry Jennerway — Sat, 26 Nov 2011 13:43:38 +0000

One of the things I find myself constantly doing with jQuery is making divs expand and collapse based on clicks on other elements. Collapsible panels are a great way of achieving progressive disclosure. I got sick of writing the same code on multiple pages so I wrote a plugin instead.

This creates an accordian style header which expands a linked panel when clicked.

Demo
Download

(function ($) {
    $.fn.extend({
        collapsiblePanel: function () {
            $(this).each(function () {
                var indicator = $(this).find('.ui-expander').first();
                var header = $(this).find('.ui-widget-header').first();
                var content = $(this).find('.ui-widget-content').first();
                if (content.is(':visible')) {
                    indicator.removeClass('ui-icon-triangle-1-e ui-icon-triangle-1-s').addClass('ui-icon-triangle-1-e');
                } else {                                       
                    indicator.removeClass('ui-icon-triangle-1-e ui-icon-triangle-1-s').addClass('ui-icon-triangle-1-s');
                }
 
                header.click(function () {
                    content.slideToggle(500, function () {
                        if (content.is(':visible')) {
                            indicator.removeClass('ui-icon-triangle-1-e ui-icon-triangle-1-s').addClass('ui-icon-triangle-1-e');
                        } else {                                       
                            indicator.removeClass('ui-icon-triangle-1-e ui-icon-triangle-1-s').addClass('ui-icon-triangle-1-s');
                        }
                    });
                });
            });
        }
    });
})(jQuery);

You also need a set structure for your panel (below).


    
        +
        Lime49 Expandy Widgets Inc.
    
    
        Snap! the overstrained line sagged down in one long festoon; the tugging log was gone.
 
	"I crush the quadrant, the thunder turns the needles, and now the mad sea parts the log-line. But Ahab can mend all. Haul in here, Tahitian; reel up, Manxman. And look ye, let the carpenter make another log, and mend thou the line. See to it."
 
	"There he goes now; to him nothing's happened; but to me, the skewer seems loosening out of the middle of the world. Haul in, haul in, Tahitian! These lines run whole, and whirling out: come in broken, and dragging slow. Ha, Pip? come to help; eh, Pip?"

Call it using:

$().ready(function () {
    $('.collapse').collapsiblePanel();
});

Zipcode distance matching with SQL Server

Harry Jennerway — Sun, 06 Nov 2011 16:21:58 +0000

I recently needed to add a nearest postcode/zip lookup using SQL Server based on latitude and longitude. This finally gave me a chance to play around with the Geography datatype in SQL Server 2008.

There are various places to source data from. This usually depends how much information you get, but 10 minutes of googling found me 60000 city/state/zip/lat/long records. For reference, my table looks like this:

CREATE TABLE [dbo].[ZipCodes](
	[Zip] [nvarchar](20) NOT NULL,
	[City] [nvarchar](100) NOT NULL,
	[State] [nvarchar](100) NOT NULL,
	[Latitude] [FLOAT] NOT NULL,
	[Longitude] [FLOAT] NOT NULL,
	[Timezone] [INT] NOT NULL,
	[IsDST] [bit] NOT NULL,
 CONSTRAINT [PK_ZIpCodes] PRIMARY KEY CLUSTERED 
(
	[Zip] ASC
)WITH (PAD_INDEX  = OFF, STATISTICS_NORECOMPUTE  = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS  = ON, ALLOW_PAGE_LOCKS  = ON) ON [PRIMARY]
) ON [PRIMARY]

There are also indexes on city, state, latitude, longitude and latitude/longitude. I’m not an expert with SQL so the last one is just for good measure. This lets me query on any column with half decent results.

Once you’ve got from the CSV or SQL script you found/purchased in to your database you need to add a Geography column.

ALTER TABLE ZipCodes
ADD [GeoLocation] GEOGRAPHY
GO

Then you can build fill the column using the data you have for latitude and longitude:

UPDATE ZipCodes
SET [GeoLocation] = geography::STPointFromText('POINT(' + CAST([Longitude] AS VARCHAR(20)) + ' ' + CAST([Latitude] AS VARCHAR(20)) + ')', 4326)

Now you have to decide whether to build the query using inline SQL in your code or create a stored procedure for it. My instinct says stored procedure but right now inline SQL is fine.

DECLARE @myposition geography;
SELECT @myposition = GeoLocation FROM ZipCodes
WHERE Zip LIKE '10005' ;--OR City LIKE 'New York' OR State LIKE 'NY';  
 
SELECT z.*,z.GeoLocation.STDistance(@myposition) AS Distance FROM ZipCodes z
WHERE z.GeoLocation.STDistance(@myposition) <= 1000
ORDER BY Distance ASC

In this case, the query is built in .NET with certain parts left out depending what the user searched for, but that’s irrelevant. The last part is commented out because you want to get the most precise match, so if you have a zip code, use it. If not you can use the City and State columns.

Zip	City	State	Latitude	Longitude	Timezone	IsDST	GeoLocation					Distance
10005	New York	NY	40.706019	-74.00858	-5	1	0xE6100000010CEE7C3F355E5A4440B8AF03E78C8052C0	0
10270	New York	NY	40.706925	-74.008154	-5	1	0xE6100000010C6DC5FEB27B5A4440F1F44A59868052C0	105.505094488081
10045	New York	NY	40.70859	-74.008687	-5	1	0xE6100000010C09F9A067B35A44406ADE718A8E8052C0	288.849104985383
10271	New York	NY	40.708669	-74.01043	-5	1	0xE6100000010C6D567DAEB65A444038F8C264AA8052C0	336.208294678286
10041	New York	NY	40.703042	-74.01009	-5	1	0xE6100000010C448B6CE7FB594440226C787AA58052C0	356.447222439371
10006	New York	NY	40.707904	-74.01342	-5	1	0xE6100000010C516B9A779C5A44400D71AC8BDB8052C0	457.225354635998
10038	New York	NY	40.709677	-74.00365	-5	1	0xE6100000010C50FC1873D75A444000917EFB3A8052C0	589.364962050259
10048	New York	NY	40.712086	-74.01227	-5	1	0xE6100000010CA5BDC117265B4440696FF085C98052C0	746.071595261018
10250	New York	NY	40.709387	-74.016529	-5	1	0xE6100000010C26E4839ECD5A4440931804560E8152C0	766.967118714565
10279	New York	NY	40.713062	-74.00857	-5	1	0xE6100000010C88635DDC465B4440B8AF03E78C8052C0	788.442916610519
10280	New York	NY	40.707467	-74.0178	-5	1	0xE6100000010CC3F5285C8F5A44409A779CA2238152C0	795.10810871016
10286	New York	NY	40.714231	-74.011895	-5	1	0xE6100000010CCF66D5E76A5B4440A2B437F8C28052C0	952.338009037327
10007	New York	NY	40.714754	-74.00721	-5	1	0xE6100000010C2497FF907E5B4440FF21FDF6758052C0	984.36004707576

These all seem roughly around the same place and are ordered by distance, but what do I know, I’ve never been to New York!

I’ve found it quicker to use a temporary table when doing the actual SELECT, ie:

DECLARE @miles [FLOAT] = 1;
DECLARE @myposition geography;
SELECT @myposition = GeoLocation FROM ZipCodes
WHERE Zip LIKE '11204';
--WHERE City LIKE 'Zionville';-- OR State LIKE 'NY';
 
SELECT z.*,z.GeoLocation.STDistance(@myposition) AS Distance INTO #HASHTABLE FROM ZipCodes z
WHERE z.GeoLocation.STDistance(@myposition) <= (@miles*1609.344)
ORDER BY Distance ASC
 
SELECT z.[Latitude], z.[Longitude], u.*, z.GeoLocation.STDistance(@myposition) AS Distance
FROM Users u INNER JOIN ZipCodes z ON u.PostCode = z.Zip
WHERE u.PostCode IN (SELECT Zip FROM #hashtable) OR u.City IN (SELECT City FROM #hashtable) 
DROP TABLE #Hashtable

Pagination and Delegates in a UITableView

Harry Jennerway — Sun, 16 Oct 2011 18:25:37 +0000

I recently needed to create a table view where the user could scroll to the bottom to load more data, similar to Facebook’s ‘pull to refresh’. This shows a loading indicator while more data is retrieved. To do this I used a delegate which is implemented by a custom table view cell.

The ViewController contains a method to load more data, which might be called when the user scrolls to the bottom. This finds the last cell and calls the toggleLoading method.
CustomTableViewController.h

-(void)toggleTableViewLoading:(bool)isLoading;

CustomTableViewController.m

-(void)toggleTableViewLoading {
    NSIndexPath *lastIndexPath = [NSIndexPath indexPathForRow:[aroundMeArray count]+1 inSection:0];
    CustomTableViewCell *lastCell= [self.aroundMeTableView cellForRowAtIndexPath:lastIndexPath];
    [lastCell toggleLoading];
}

This method is declared in a delegate which the cell implements.

ActivityDelegate.h

@protocol ActivityDelegate 
    @required
    -(void) toggleLoading:(bool)showLoading;
@end

The implementation can be blank.

The custom table cell loaded by your UITableViewController needs to implement this delegate so the UITableView knows is has the toggleLoading method.

In the UITableCell which implements ActivityDelegate, we put the method which shows/hides the indicator. This creates the loading spinner and adds/removes it from the accessoryView in the table cell.

ActivityTableViewCell.m

-(void) toggleLoading:(bool)showLoading {
    if(!showLoading) {
        [self.accessoryView setHidden:true];
        isLoading = false;
    } else {
        UIActivityIndicatorView *spinner = [[UIActivityIndicatorView alloc] initWithActivityIndicatorStyle:UIActivityIndicatorViewStyleGray];
        spinner.frame = CGRectMake(0, 0, 24, 24);
        self.accessoryView = spinner;
        [spinner startAnimating];
        [spinner release];
        isLoading = true;
        [self.backgroundView setNeedsDisplay];
    }
}

ActivityTableViewCell.h declares that is has a loading indicator which can be toggled. Hook this up in Interface Builder.

#import 
#import "ActivityDelegate.h"
@interface ActivityTableViewCell : UITableViewCell {
    IBOutlet UIView *viwHaveData;
    IBOutlet UIView *viwNoData;
    IBOutlet UILabel *lblNoData;
    IBOutlet UIActivityIndicatorView *loadingIndicator;
    BOOL isLoading;
}
 
@property (nonatomic, retain) IBOutlet UIView *viwHaveData;
@property (nonatomic, retain) IBOutlet UIView *viwNoData;
@property (nonatomic, retain) IBOutlet UILabel *lblNoData;
@property (nonatomic, retain) IBOutlet UIActivityIndicatorView *loadingIndicator;
@property (nonatomic, readwrite) BOOL isLoading;
 
@end

When you need to show the loading spinner, you can call [myCell toggleLoading];

DevExpress Scheduler: ID of Repeating Appointment

Harry Jennerway — Sat, 01 Oct 2011 17:31:21 +0000

Since I started using the DevExpress Scheduler a few weeks back I’ve found a few limitations in the 2011 version. The killer for me was the lack of appointment IDs for recurring appointments.

After hunting around trying every suggested method from DevExpress, I found a support ticket from another developer having the same problem.

Using the same kind of method I wrote the following core (pretty horrible) to do the job.

	 runat="server"...
		...
		 AppointmentsSelectionChanged="function(s, e) { OnAppointmentsSelectionChanged(s, e.appointmentIds);}" />
        >
 
	 runat="server" ID="appointmentId"/>
         type="text/javascript">
            function OnAppointmentsSelectionChanged(s, appointmentIds) {
                $('#<%= appointmentId.ClientID %>').val(appointmentIds);
            }
        >

This lets you grab the value from the code-behind (in my case by hooking the ASPxScheduler1_PopupMenuShowing event).

protected void ASPxScheduler1_PopupMenuShowing(object sender, PopupMenuShowingEventArgs e) {
        ASPxSchedulerPopupMenu menu = e.Menu;
        // Check whether an empty cell is clicked rather than an appointment.
        if (!menu.Id.Equals(SchedulerMenuItemId.DefaultMenu)) {
		var rawSelectedBookingId = appointmentId.Value; // if it's recurring, you get something like 12_0
                var selectedBookingId = string.IsNullOrWhiteSpace(rawSelectedBookingId) ? -1 : Convert.ToInt32(rawSelectedBookingId.Split(new[] {'_'}, StringSplitOptions.RemoveEmptyEntries).FirstOrDefault());

The selectedBookingId in my case, is the ID of the database object for the user’s right click selection

iOS App Signing Errors

Harry Jennerway — Thu, 28 Jul 2011 08:11:06 +0000

For the last day, I’ve been on the brink of pulling my hair out trying to fix a bizarre error when trying to deploy an app to my iPhone. Everything worked fine in the simulator, but when I tried to deploy it to the device, I kept getting “The entitlements specified in your application’s Code Signing Entitlements file do not match those specified in your provisioning profile.”

Suggestions, including this post said that cleaning the project, rebuilding, restarting XCode or voodoo incantations had solved it for others, but eventually it turned out to be due to the requirement for an Entitlements file in the project itself. You need to File->New->File, choose iOS->Entitlements File and call it Entitlements.plist, add an entry if one doesn’t exist for “Can be debugged” and set it to true. Now in the settings for the main target in your project, set the code signing entitlements file to the newly created Entitlements.plist file.

Clean, rebuild and launch the app, and hopefully it should work.

jQuery: Geocoding for Zip Code Lookups

Harry Jennerway — Sun, 22 May 2011 15:43:50 +0000

Forms which need a user’s address, or even just their country can be tedious to fill out, especially if you need to collect latitude and longitude. Yahoo’s Geolocation API can simplify the process by looking up latitude, longitude and country from a postal/zip code. The function below takes five arguments and uses jQuery to add a click handler. When the button is clicked, an AJAX request is sent to the Yahoo geolocation API via jQuery, the the resulting XML is parsed and the form fields are populated.

This has the benefit of needing just one piece of data (postcode) instead of four. The one problem with this is that the same origin policy prevent making AJAX calls to a separate domain. Unfortunately, this means you need an intermediate web service hosted on the same domain as the page which passes on the request. This just needs to return a URL via cURL (PHP) or WebClient (ASP.NET).

Then in JavaScript, the result can be parsed from the returned XML (unfortunately, Yahoo’s API doesn’t currently support JSON).

	function addGLookupPostCodeListener(searchButtonId, postCodeFieldId, countryFieldId, txtLatitudeId, txtLongitudeId) {
	    var searchButton = $('#' + searchButtonId);
	    searchButton.click(function () {
	        var thePostCode = $('#' + postCodeFieldId).val();
	        if (thePostCode === '')
	            return;
	            $.ajax({type: 'POST', url: '/API.asmx/LookupPostcode',  contentType: "application/json; charset=utf-8", dataType: 'xml', data: JSON.stringify({ postCode: encodeURI(thePostCode)}), success: function (response) {
	                    var xml = response;
	                    var $xml = $(xml);
	                    var haveNodes = false;
	                    var $country = $xml.find("Country");
	                    if ($country != null) { // populat country if it exists
	                        haveNodes = true;
	                        var txtCountry = $('#' + countryFieldId);
	                        switch($country.text()){
	                            case 'GB':// the API returns GB as the country code which is no good 
	                            txtCountry.val('United Kingdom');
	                            break;
	                        default:
	                            txtCountry.val($country.text());
	                            break;
	                    }
	                    var $latitude = $xml.find("Latitude");
	                    var $longitude = $xml.find("Longitude");
	                    if ($latitude != null && $longitude != null) { // populate lat/long if they exist
	                        haveNodes = true;
	                        var txtLatitude = $('#' + txtLatitudeId);
	                        var txtLongitude = $('#' + txtLongitudeId);
	                        txtLatitude.val($latitude.text());
	                        txtLongitude.val($longitude.text());
	                    }
	                    if (!haveNodes) {// if no nodes (due to invalid response or no data), show a message
	                        searchButton.after('Address not found');
	                    }
	                }
	            });
	            return false;
	    });
	}

WPF: Radio Toggle Button

Harry Jennerway — Sun, 24 Apr 2011 20:29:42 +0000

There are times when you might want to display a toggle switch to let the user pick between one or more views. The easiest way to implement this in WPF is with RadioButtons and custom templates. Persistence can easily be added by binding to an application settings resource, as in the example below.

The first thing you need is a custom control. This just needs to inherit from RadioButton, I added a few extra properties to make adding images easier.

namespace Lime49.UI {
    /// 
    /// A button which can be assigned an image
    /// 
    public class RadioImageButton : RadioButton {
        public static readonly DependencyProperty ImageLocationProperty = DependencyProperty.Register("ImageLocation", typeof(PlacementMode), typeof(RadioImageButton), new UIPropertyMetadata(PlacementMode.Left));
        /// 
        /// Gets or sets the position of the image in relative to the text.
        /// 
        /// The image.
        public PlacementMode ImageLocation {
            get { return (PlacementMode)base.GetValue(ImageLocationProperty); }
            set { base.SetValue(ImageLocationProperty, value); }
        }
 
        public static readonly DependencyProperty ImageProperty = DependencyProperty.Register("Image", typeof(ImageSource), typeof(RadioImageButton));
        /// 
        /// Gets or sets the image to display.
        /// 
        /// The image.
        public ImageSource Image {
            get { return base.GetValue(ImageProperty) as ImageSource; }
            set { base.SetValue(ImageProperty, value); }
        }
 
        public static readonly DependencyProperty TextProperty = DependencyProperty.Register("Text", typeof(string), typeof(RadioImageButton));
        /// 
        /// Gets or sets the text.
        /// 
        /// The text.
        public string Text {
            get { return base.GetValue(TextProperty) as string; }
            set { base.SetValue(TextProperty, value); }
        }
 
        public static readonly DependencyProperty ShowTextProperty = DependencyProperty.Register("ShowText", typeof(bool), typeof(RadioImageButton), new UIPropertyMetadata(true));
        /// 
        /// Gets or sets whether to show the text.
        /// 
        /// true if the text should be shown, otherwise false.
        public bool ShowText {
            get { return (bool)base.GetValue(ShowTextProperty); }
            set { base.SetValue(ShowTextProperty, value); }
        }
 
        public static readonly DependencyProperty AlwaysShowBorderProperty = DependencyProperty.Register("AlwaysShowBorder", typeof(bool), typeof(RadioImageButton));
        /// 
        /// Gets or sets whether to always show the border.
        /// 
        /// true if the border should be shown, otherwise false.
        public bool AlwaysShowBorder {
            get { return (bool)base.GetValue(AlwaysShowBorderProperty); }
            set { base.SetValue(AlwaysShowBorderProperty, value); }
        }
    }
}

The control template just needs to take these properties and display them. Ie (Visual Statemanager states omitted for brevity):

Then in your Window/Page you can use the following to quickly insert a RadioButton which is bound to the AppSettings collection and will persist it’s state:

private void btnChangeView_Checked(object sender, RoutedEventArgs e) {
    if (!IsLoaded)
        return;