Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries. Thanks for all your past and future contributions.

Revision as of 05:14, 30 November 2012 by hamishwillee (Talk | contribs)

Creating a button with an image and text in Windows Phone

From Wiki
Jump to: navigation, search

This article explains how to create a Button with an image and text in Windows Phone 7.

WP Metro Icon UI.png
SignpostIcon XAML 40.png
WP Metro Icon WP8.png
SignpostIcon WP7 70px.png
Article Metadata
Code ExampleTested withCompatibility
Platform(s): Windows Phone
Windows Phone 8
Windows Phone 7.5
Created: girishpadia (17 Oct 2011)
Last edited: hamishwillee (30 Nov 2012)


Most buttons on Windows Phone are relatively "flat" and are labelled with text. This text is defined in the Content parameter (a ContentControl) of the Button XAML definition:

<Button Content="Button" HorizontalAlignment="Center" Name="button1" VerticalAlignment="Center"  />

This example shows how you can replace the button text with a picture.


Note: The wonderful flower you are seeing in the above image is captured by my digital camera.


Create a project with any name of your choice (ContentControl in this example) and place a button in the mainPage.xaml file. As soon as you place the button you will see the MainPage.xaml will change to code much like the following.

<Button Content="Button" HorizontalAlignment="Center" Name="button1" VerticalAlignment="Center"  />

Remove this content property from this XML text (Content="Button") so that your code should be simillar to below.

<Button HorizontalAlignment="Center" Name="button1" VerticalAlignment="Center"  />

Now we need to add an image to the project so that it can be later used as a button's image:

  1. Right click on project and select Add->New Folder.
    A blank folder will be generated. Rename it to "Image".
  2. Add an image to this new "Image" folder. "You can do this by right click on Image folder and select Add->Existing item

For this example the image name is "myimage.JPG".

Now again go back to your button code in XAML file and add the image as shown:

<Button HorizontalAlignment="Center" VerticalAlignment="Center" >
<Image Source="Image\myimage.JPG" Stretch="Fill" Height="334" Width="339" />

You can see in the designer view that the picture is now part of your button. We add a <TextBlock> below this image - using either the toolbox (drag'n'drop) or typing the xml code of TextBlock. After adding TextBlock your above code will look something like this.

<Button HorizontalAlignment="Center" VerticalAlignment="Center" >
<Image Source="Image\myimage.JPG" Stretch="Fill" Height="334" Width="339" />
<TextBlock Text="This button has picture!" TextAlignment="Center" />

That's it. We have added a picture and text within the button. Press F5 and run the project and see the output in emulator.


See the examples section of ContentControl Class for other examples of setting button content.

915 page views in the last 30 days.