SIGN UP MEMBER LOGIN:    
ARTICLE

Programming XAML - A Quick Start

Posted by Mahesh Chand Articles | XAML with C# April 10, 2007
XAML is a new descriptive programming language that is used to define user interfaces in WPF, Silverlight and Windows 8 Metro Style Apps. This article is an introduction to XAML.
Reader Level:

XAML is a new descriptive programming language developed by Microsoft to write user interfaces for Windows 8 metro style apps, WPF and Silverlight applications. This article is a basic introduction to XAML.

 

The Root Element

 

The root element of the XAML must have namespace defined as following:

xmlns="http://schemas.microsoft.com/winfx/2006/xaml/
presentation
 

The root element of an XAML document can contain only certain elements and these elements are a Window, a Canvas, or panels. XAML has different types of panels used for different purposes. I will be talking about panels in more details in my forthcoming articles.

 

Windows and Canvas

 

Once the root element is defined, children are defined within the root element. For example, the following XAML code creates a Window and a Button as the child of the window.

 

<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/
presentation
 xmlns:x="http://schemas.microsoft.com/winfx/2006/
xaml
"
>

          <Button>Hello World</Button>

</Window>

 

The <Window> element represents a window, which replaces a Windows Form or ASP.NET Web page in previous Microsoft development platforms and the <Button> element represents a button control.

 

The above code generates the following output:

 

XamlIntroImg1.gif

 

Image 1. A Window generated using XAML  

 

Here is another example. In this example, I use <Canvas> element as the root element. Again, a canvas can be treated as a parent control of other child controls. 

 

<Canvas xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:def="Definition">

 

          <Button>XAML Button</Button>

 

</Canvas>

 

The above code generates output as Figure 2. As you can see from Figure 2, an XAML document is rendered directly by the browser.

 

XamlIntroImg2.gif


Figure 2. Button control

 

XAML Control Attributes

 

Each of the elements such as <Window> or <Button> has attributes and can be set within the element itself. For example, a Button has Height, Width, Background, Foreground and other attributes, which represents height, width, foreground color, and background color of the button respectively.

 

The following code snippet sets the Id, height, width, background color, foreground color, font name and size, and content of a button. The Content attribute represents the text of the botton. 

<Button Name="btn1" Height="50" Width="200" Background="Red" Foreground="White" FontFamily="Times New Roman" FontSize="14" Content="Red Button"/> 

Figure 3 is the result of above code. As you can see from Figure 2, the button has white foreground and red background, with the size specified in the code.

 

XamlIntroImg3.gif

 

Figure 3. Button with red background.

 

Like any other controls, you can also define the events of the controls within the XAML element itself. For example, the Click attribute of the <Button> represents the click event handler of the button. The following code sets the Click attribute of the button as ButtonClickMethod, which means when the button is clicked; the code written on the ButtonClickMethod will be executed. 

 

<Button Name="btn1" Height="50" Width="200" Background="Red" Foreground="White"

            FontFamily="Times New Roman" FontSize="14" Content="Red Button" Click="ButtonClickMethod"/>

 

Control Event Handlers

 

Now lets define the ButtonClickMethod. I am using C# language. The code is always written within <![CDATA[ ]]> element. My ButtonClickMethod is listed in Listing 5. As you can see from Listing 5, I can also set the button's properties at run-time in my code as well. I also generate a message box when the button is clicked.

 

        <![CDATA[

         

            void ButtonClickMethod(object sender, EventArgs e)

            {

                btn1.Background = Brushes.Green;

                MessageBox.Show("Red Button clicked");

            }

        ]]>

 

The final code is listed in Listing 6.

 

<DockPanel>

        <Button Name="btn1" Height="50" Width="200" Background="Red" Foreground="White"

            FontFamily="Times New Roman" FontSize="14" Content="Red Button" Click="ButtonClickMethod"/>       
     <x:Code>

          <![CDATA[

         

            void ButtonClickMethod(object sender, EventArgs e)

            {

                btn1.Background = Brushes.Green;

                MessageBox.Show("Red Button clicked");

            }

        ]]>
     </x:Code>

  </DockPanel>  

 

The output of Listing 6 generates Figure 4. As you can see from this Figure, when you click on the button, it changes the color of the button to green and generates a message box saying "Red Button clicked".

 

XamlIntroImg4.gif

 

Figure 4. Button click output 

 

Communication between two Controls

 

Now let's create one Windows application with a TextBox and a Button control on it. In this application, we will change the TextBox.Text property on button click event. Our final Window looks like Figure 5.

 

XamlIntro101.gif

Figure 5. A Window with a TextBox and a Button control

 

The code for creating a Windows, a TextBox, and a Button is listed in Listing 7. In this code, the <Window /> element represents a Window.  

 

<Window x:Class="WindowsApplication5.Window1"

    xmlns="http://schemas.microsoft.com/winfx/avalon/2005"

    xmlns:x="http://schemas.microsoft.com/winfx/xaml/2005"

    Title="WindowsApplication5"

    >

    <Grid Height="244" Width="469">

     <TextBox VerticalAlignment="Top" HorizontalAlignment="Left" Grid.Column="0" Grid.ColumnSpan="1" Grid.Row="0" Grid.RowSpan="1" Margin="190,26.5,0,0" Width="202" Height="38" Name="textBox1"></TextBox>

    <Button VerticalAlignment="Top" HorizontalAlignment="Left" Grid.Column="0" Grid.ColumnSpan="1" Grid.Row="0" Grid.RowSpan="1" Margin="232,99.5,0,0" Width="135" Height="55" Name="button1" Click="ButtonClickMethod">Button</Button>

  </Grid>  

 

</Window>

 

Listing 8.

 

Now let's add code to change Text property of TextBox as listed in Listing 8. This code should look familiar. On button click event handler, we are simply setting textBox1.Text to "Button clicked" string.

    <x:Code>
    <![CDATA[

            void ButtonClickMethod(object sender, EventArgs e)

            {

               textBox1.Text = "Button clicked";            

            }

        ]]>

   </x:Code> 

Listing 9.

 

Now let's run the application and click on the button. The output looks like Figure 6.

 

XamlIntro102.gif

 

Figure  6.

 

In-line versus Code-behind

 

Similar to ASP.NET programming model, we have choice to write code in XAML document itself or in a seperate file as code-behind. In our previous example, we used the following syntax to write in-line code.

 

    <![CDATA[

 

However, you have choice to use a seperate file and place all code in that file as code-behind file. If you want to do so, you have to tell your XAML document the file name using the following syntax. 

<Window x:Class="XamlNotePad.Window1"
xmlns="http://schemas.microsoft.com/winfx/avalon/2005"
xmlns:x="http://schemas.microsoft.com/winfx/xaml/2005"
Title="XAML Notepad" Height="521" Width="801">

In the above code, the code-behind code is placed in XamlNotePad.Window1 class. The in-line code is compiled at run-time but if you have a code-behind file, you will have to compile the application before deploying it.

 

This is why XAML is HOT!

 

I did lot of work with graphics using GDI+ and graphics objects such as Rectangle, Ellipse, Line, and Path did not have any events.

 

Guess what? All of these objects in XAML have events now. In other words, I can have a mouse down event on an ellipse. That's pretty cool.

 

The following code creates an Ellipse and adds MouseDown  event handler called EllipseMouseDown. I have EllipseMouseDown defined in code-behind.

 

<Ellipse Name="MyEllipse" Height="100" Width="300" StrokeThickness="5" Stroke="Black" Fill="Gold" MouseDown="EllipseMouseDown" />

Here is the MouseDown event handler in .cs file.

void EllipseMouseDown(object sender, MouseButtonEventArgs e)
{
    MessageBox.Show("Mouse was down");
}

Now when you mouse down on the ellipse, the output looks like Figure 7.

EllipseImg2.gif

Figure 7.

Pretty cool. huh?

Summary

 

This article is a basic introduction to XAML. In this article, you saw how to create simple user interfaces and controls using XAML. You also learnt how we can create controls and write event handlers for the controls.

Login to add your contents and source code to this article
share this article :
post comment
 

Just updated some images.

Posted by Mahesh Chand May 23, 2012

I copied your code in a XAML file but it did not work; IE says "An error occurred in the application you were using". The contenst of the XAML file is:

<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
<Button>Hello World</Button>
</Window>

Obviously I am missing something fundamental; I think an introductory article should explain what to do.

Posted by Sam Hobbs Jan 25, 2010

Hi, Any idea how your example will be work as MultiPointWindows application? Nikolai

Posted by Nikolai Vitsyn Jan 15, 2008

Did you mean both in same project? Both serve same purpose - UI implementation. If you are using XAML, you will not be using ASP.NET. The code behind language will be same C# or VB.NET.

XAML is another (future) way to build both Windows Forms and ASP.NET applications.

Posted by Mahesh Chand Aug 23, 2007

Hi, Any idea how i can work with asp.net 2.0 & XAML Thanks in advance, >>Munnamax

Posted by Munir Shaikh Aug 21, 2007
Team Foundation Server Hosting
Become a Sponsor
PREMIUM SPONSORS
  • ceTE software specializes in components for dynamic PDF generation and manipulation. The DynamicPDF™ product line allows you to dynamically generate PDF documents, merge PDF documents and new content to existing PDF documents from within your applications. Visit DynamicPDF here
    The leading .NET charting control now features PDF, Flash and Silverlight export, visualization of large datasets and more. Deliver true charting functionality to your BI, Scorecard, Presentation or Scientific apps. Download evaluation now.
Nevron Gauge for SharePoint
Become a Sponsor