Creating a button with an image and text in Windows Phone

Comments

(no comments yet)

Log in or Join to leave comments.

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

See Also

• Button Control Design Guidelines for Windows Phone
• Button Class
• ContentControl Class

Article Metadata

---

Code Example

Source file: Media:ContentControl.zip

---

Tested with

SDK: Windows Phone

---

Compatibility

Platform(s): Windows Phone

---

Article

Created: girishpadia (17 Oct 2011)

Last edited: hamishwillee (10 Apr 2013)

Introduction

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.

Implementation

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" >
  <StackPanel>
      <Image Source="Image\myimage.JPG" Stretch="Fill" Height="334" Width="339" />
   </StackPanel>
</Button>

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" >
 <StackPanel>
  <Image Source="Image\myimage.JPG" Stretch="Fill" Height="334" Width="339" />
  <TextBlock Text="This button has picture!" TextAlignment="Center" />
 </StackPanel>
</Button>

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.

References

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