SixSix翻译的XAML教程 语法简介

  [This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

  XAML 语法简介

  本文介绍了如何使用几种不同的方法在XAML中创建对象和设置他们的属性。

  主题包括以下几个部分:

  什么是XAML?

  声明对象

  设置属性

  其他相关主题

  什么是XAML

  XAML是一种陈述性语言。你可以使用XAML标记创建可视化的UI原件。 之后,你可以在一个单独的文件中使用JavasScript来操作你在XAML所声明的对象、响应一些事件。作为一种以XML为基础的陈述性语言,它创建界面时,从原型到产品的过程非常直观,尤其是对于有网页设计背景知识和技术的人。

  XAML文件通常是以.xaml为后缀的XML文件。下面是一个典型的Silverlight XAML文件例子。.XAML

  <Canvas

  xmlns="http://schemas.microsoft.com/client/2007"

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

  <Rectangle

  Width="100"

  Height="100"

  Fill="Blue" />

  </Canvas>

  声明对象

  在XAML中,有以下几种方式声明对象和设置它们的属性::

  Object element syntax: 使用开放的和封闭的标签来声明对象,就像XML一样。你可以使用这种方法来声明根元素和设置它们的属性值。

  Attribute syntax: 使用内嵌来声明对象。你可以使用这种方法来设置一个属性的值。.

  Object element syntax

  一种典型的使用Object element syntax来声明对象的方法。.首先你要创建两个XML元素标签:

  <objectName>

  </objectName>

  ... objectName 是你想要实例化的对象的名字。下面的例子使用Object element syntax声明一个Canvas。XAML

  <Canvas>

  </Canvas>

  一些对象, 比如Canvas, 可以包含其他对象。.XAML

  <Canvas>

  <Rectangle>

  </Rectangle>

  </Canvas>

  为了方便,如果一个对象里不包含其他对象,那么可以只使用一个标签来描述它XAML

  <Canvas>

  <Rectangle />

  </Canvas>

  使用Attribute syntax声明对象

  见下一部分, 设置属性, 获得更多有关attribute syntax的信息。

  设置属性

  使用 object element syntax,你可以在声明对象的时候设置它的属性. 在XAML中,有几种方法可以设置属性: 使用 attribute syntax, 或使用  property element syntax.

  通过Attribute syntax设置属性

  <objectNameproperty="propertyValue">

  </objectName>

  ... property 是属性名称,你会将propertyValue 的值赋到它的身上。 下面的例子展示了如何使用attribute syntax 来设置一个Rectangle的Width, Height, 和 Fill .XAML

  <Canvas>

  <Rectangle

  Width="100"Height="100"Fill="Blue" />

  </Canvas>

  使用 Property Element Syntax设置属性

  一些属性可以通过property element syntax来设置. 你通过创建XML elements来描述你想要的属性, 例如:

  <objectName>

  <objectName.property>

  <propertyValue ... />

  </objectName.property>

  </objectName>

  ... property 是属性名称,你会将propertyValue 的值赋到它的身上. 下面的例子展示了如何使用 property element syntax 来设置一个Rectangle的Fill ,使用a SolidColorBrush.XAML

  <Canvas>

  <Rectangle

  Width="100"

  Height="100">

  <Rectangle.Fill>

  <SolidColorBrush />

  </Rectangle.Fill>

  </Rectangle>

  </Canvas>

  使用 Content Element Syntax设置属性

  有时候,当一个属性支持element syntax,你可以忽略属性名,直接将属性值内嵌在对象标签里。这就是content element syntax. 下面的例子展示了怎样不指定 Text 属性,设置TextBlock的 Text 属性值 。XAML

  <TextBlock>

  Hello!

  </TextBlock>

  使用 Implicit Collection Syntax设置属性

  有时候, 一个属性表现为一个集合, 你可以忽略集合名字,直接设置属性值。这就是implicit collection syntax.。下面的例子展示了对于LinearGradientBrush 如何忽略GradientStopCollection ,以及直接指定 GradientStop 对象。 GradientStopCollection 包含在第一个LinearGradientBrush中,,但在第二个里被忽略了。XAML

  <Rectangle Width="100" Height="100"

  Canvas.Left="0" Canvas.Top="30">

  <Rectangle.Fill>

  <LinearGradientBrush>

  <LinearGradientBrush.GradientStops>

  <!-- Here the GradientStopCollection tag is specified. -->

  <GradientStopCollection>

  <GradientStop Offset="0.0" Color="Red" />

  <GradientStop Offset="1.0" Color="Blue" />

  </GradientStopCollection>

  </LinearGradientBrush.GradientStops>

  </LinearGradientBrush>

  </Rectangle.Fill>

  </Rectangle>

  <Rectangle Width="100" Height="100"

  Canvas.Left="100" Canvas.Top="30">

  <Rectangle.Fill>

  <LinearGradientBrush>

  <LinearGradientBrush.GradientStops>

  <!-- Notice that the GradientStopCollection tag

  is omitted. -->

  <GradientStop Offset="0.0" Color="Red" />

  <GradientStop Offset="1.0" Color="Blue" />

  </LinearGradientBrush.GradientStops>

  </LinearGradientBrush>

  </Rectangle.Fill>

  </Rectangle>

  有时你甚至可以同时忽略集合元素标签和属性元素标签::XAML

  <Rectangle Width="100" Height="100"

  Canvas.Left="200" Canvas.Top="30">

  <Rectangle.Fill>

  <LinearGradientBrush>

  <GradientStop Offset="0.0" Color="Red" />

  <GradientStop Offset="1.0" Color="Blue" />

  </LinearGradientBrush>

  </Rectangle.Fill>

  </Rectangle>

  什么时候使用Attribute或Property Element Syntax设置属性

  所有属性都支持attribute 或property element syntax, 一些属性支持其他方法. 设置属性所支持的方法取决于属性值所认可的对象类型。.

  如果属性值是简单类型, 比如 Double, Integer,String, 这种属性只支持 attribute syntax . 下面的例子展示了如何使用 attribute syntax 设置Rectangle的Width.Width属性支持Attribute syntax,因为他的属性值是Double类型。 XAML

  <Rectangle Width="100" />

  是否可以使用attribute syntax取决于你使用于设置属性的对象是否支持attribute syntax.下面的例子展示了使用 attribute syntax 设置一个Rectangle的 Fill属性。在你使用SolidColorBrush去设置Fill属性的时候,它是支持attribute syntax的,因为SolidColorBrush支持attribute syntax. XAML

  <Rectangle Fill="Blue" />

  是否能够使用element syntax 设置属性取决于你使用的对象是否支持。如果对象支持object element syntax,属性才支持property element syntax 。下面的例子展示了使用property element syntax 设置一个Rectangle的Fill.当你使用SolidColrBrush设置Fill的时候,它是支持attribute syntax的,因为SolidColorBrush支持attribute syntax 。. XAML

  <Rectangle>

  <Rectangle.Fill>

  <SolidColorBrush />

  </Rectangle.Fill>

  </Rectangle>

  See Also

  Silverlight Object Models