Floater 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
提供用于托管浮点数的内联级流内容元素。 浮点器 显示与 FlowDocument中主要内容流并行的图像和其他内容。
public ref class Floater : System::Windows::Documents::AnchoredBlockpublic class Floater : System.Windows.Documents.AnchoredBlocktype Floater = class
inherit AnchoredBlockPublic Class Floater
Inherits AnchoredBlock- 继承
示例
以下示例定义包含 FlowDocument 和 Floater 元素的 Figure。
<FlowDocumentReader>
<FlowDocument
ColumnWidth="400"
IsOptimalParagraphEnabled="True" IsHyphenationEnabled="True"
>
<Section FontSize="12">
<Paragraph>
<Bold>Neptune</Bold> (planet), major planet in the solar system, eighth planet
from the Sun and fourth largest in diameter. Neptune maintains an almost constant
distance, about 4,490 million km (about 2,790 million mi), from the Sun. Neptune
revolves outside the orbit of Uranus and for most of its orbit moves inside the
elliptical path of the outermost planet Pluto (see Solar System). Every 248 years,
Pluto’s elliptical orbit brings the planet inside Neptune’s nearly circular orbit
for about 20 years, temporarily making Neptune the farthest planet from the Sun.
The last time Pluto’s orbit brought it inside Neptune’s orbit was in 1979. In
1999 Pluto’s orbit carried it back outside Neptune’s orbit.
<!-- This Figure uses relative measurements for width and height. -->
<Figure
Width="0.25" Height="0.1" Background="GhostWhite"
HorizontalAnchor="PageLeft"
HorizontalOffset="100" VerticalOffset="20"
>
<Paragraph
FontStyle="Italic" TextAlignment="Left"
Background="Beige" Foreground="DarkGreen"
>
Neptune has 72 times Earth's volume...
</Paragraph>
</Figure>
<!-- This Floater uses relative measurements for width. -->
<Floater
Background="GhostWhite"
Width="0.4" HorizontalAlignment="Left"
>
<Table CellSpacing="5">
<Table.Columns>
<TableColumn Width="155"/>
<TableColumn Width="130"/>
</Table.Columns>
<TableRowGroup>
<TableRow>
<TableCell ColumnSpan="3">
<Paragraph>Neptune Stats</Paragraph>
</TableCell>
</TableRow>
<TableRow Background="LightGoldenrodYellow" FontSize="12">
<TableCell>
<Paragraph FontWeight="Bold">Mean Distance from Sun</Paragraph>
</TableCell>
<TableCell>
<Paragraph>4,504,000,000 km</Paragraph>
</TableCell>
</TableRow>
<TableRow FontSize="12" Background="LightGray">
<TableCell>
<Paragraph FontWeight="Bold">Mean Diameter</Paragraph>
</TableCell>
<TableCell>
<Paragraph>49,532 km</Paragraph>
</TableCell>
</TableRow>
<TableRow Background="LightGoldenrodYellow" FontSize="12">
<TableCell>
<Paragraph FontWeight="Bold">Approximate Mass</Paragraph>
</TableCell>
<TableCell>
<Paragraph>1.0247e26 kg</Paragraph>
</TableCell>
</TableRow>
<TableRow>
<TableCell ColumnSpan="4">
<Paragraph FontSize="10" FontStyle="Italic">
Information from the
<Hyperlink
NavigateUri="http://encarta.msn.com/encnet/refpages/artcenter.aspx"
>Encarta</Hyperlink>
web site.
</Paragraph>
</TableCell>
</TableRow>
</TableRowGroup>
</Table>
</Floater>
</Paragraph>
<Paragraph>
Astronomers believe Neptune has an inner rocky core that is surrounded by a vast
ocean of water mixed with rocky material. From the inner core, this ocean extends
upward until it meets a gaseous atmosphere of hydrogen, helium, and trace amounts
of methane. Neptune has four rings and 11 known moons. Even though Neptune's volume
is 72 times Earth’s volume, its mass is only 17.15 times Earth’s mass. Because of
its size, scientists classify Neptune—along with Jupiter, Saturn, and Uranus—as
one of the giant or Jovian planets (so-called because they resemble Jupiter).
</Paragraph>
<Paragraph>
<Figure
Width="140" Height="50"
Background="GhostWhite" TextAlignment="Left"
HorizontalAnchor="PageCenter" WrapDirection="Both"
>
<Paragraph FontStyle="Italic" Background="Beige" Foreground="DarkGreen" >
Neptune has an orbital period of ~20 years...
</Paragraph>
</Figure>
Mathematical theories of astronomy led to the discovery of Neptune. To account for
wobbles in the orbit of the planet Uranus, British astronomer John Couch Adams and
French astronomer Urbain Jean Joseph Leverrier independently calculated the existence
and position of a new planet in 1845 and 1846, respectively. They theorized that the
gravitational attraction of this planet for Uranus was causing the wobbles in Uranus’s
orbit. Using information from Leverrier, German astronomer Johann Gottfried Galle first
observed the planet in 1846.
</Paragraph>
</Section>
</FlowDocument>
</FlowDocumentReader>
下图显示了此示例的呈现方式。
注解
Figure 或 Floater 元素通常用于突出显示或强调部分内容、托管支持图像或主内容流中的其他内容，或注入松散相关的内容，如广告。 浮点器可以包含从 Block 类继承的对象。 有关详细信息，请参阅 TextElement 内容模型概述
Figure 和 Floater 在多方面有所不同，并用于不同的情境。
图：
可定位：您可以设置其水平和垂直定位点，使其相对于页面、内容、列或段落来停靠。 还可以使用其 HorizontalOffset 属性 VerticalOffset 来指定任意偏移量。
可以调整为跨多个列：您可以将 Figure 的高度和宽度设置为页面、内容或列高度或宽度的倍数。 请注意，对于页面和内容，不允许大于 1 的倍数。 例如，可以将宽度 Figure 设置为“0.5 页”或“0.25 内容”或“2 列”。 还可以将高度和宽度设置为绝对像素值。
浮子：
无法定位，将在任何可用空间中显示。 不能设置偏移量或将 Floater 定位。
不能调整为多个列的大小：默认情况下， Floater 大小为一列。 它有一个 Width 属性，可以设置为绝对像素值，但如果此值大于一列宽度，则忽略它，并且浮点数大小为一列。 可以通过设置正确的像素宽度将其大小调整为小于一列，但大小不是列相对的，因此“0.5Column”不是宽度的有效表达式 Floater 。 Floater 没有高度属性，并且无法设置高度，高度取决于内容
Floater分页：如果其内容在指定宽度下扩展到超过 1 列的高度，浮动元素将中断并分页到下一列、下一页等。
Figure 是放置独立内容的好位置，可在其中控制大小和定位，并且确信内容适合指定大小。 Floater 是放置更多自由流动的内容的位置，这些内容与主页内容类似，但与主页内容分开。
构造函数
| 名称 | 说明 |
|---|---|
| Floater() |
初始化 Floater 类的新实例。 |
| Floater(Block, TextPointer) |
使用指定的 Floater 对象作为初始内容初始化 Block 类的新实例，并使用指定新 TextPointer插入位置的 Floater。 |
| Floater(Block) |
字段
| 名称 | 说明 |
|---|---|
| HorizontalAlignmentProperty |
标识 HorizontalAlignment 依赖属性。 |
| WidthProperty |
标识 Width 依赖属性。 |
属性
| 名称 | 说明 |
|---|---|
| AllowDrop |
获取或设置一个值，该值指示此元素是否可以用作拖放操作的目标。 (继承自 ContentElement) |
| AreAnyTouchesCaptured |
获取一个值，该值指示是否至少捕获到此元素的一个触摸。 (继承自 ContentElement) |
| AreAnyTouchesCapturedWithin |
获取一个值，该值指示是否至少捕获一个触摸到此元素或其可视化树中的任何子元素。 (继承自 ContentElement) |
| AreAnyTouchesDirectlyOver |
获取一个值，该值指示是否在此元素上按下至少一次触摸。 (继承自 ContentElement) |
| AreAnyTouchesOver |
获取一个值，该值指示是否在该元素或其可视化树中的任何子元素上按下至少一个触摸。 (继承自 ContentElement) |
| Background |
获取或设置用于填充内容区域背景的画笔。 (继承自 TextElement) |
| BaselineAlignment |
获取或设置元素的 Inline 基线对齐方式。 (继承自 Inline) |
| BindingGroup |
获取或设置 BindingGroup 用于元素的元素。 (继承自 FrameworkContentElement) |
| Blocks |
获取包含构成元素内容的顶级 BlockCollection 元素的 Block。 (继承自 AnchoredBlock) |
| BorderBrush |
获取或设置在绘制元素边框时要使用的值 Brush 。 (继承自 AnchoredBlock) |
| BorderThickness |
获取或设置元素的边框粗细。 (继承自 AnchoredBlock) |
| CommandBindings |
获取与此元素关联的对象的集合 CommandBinding 。 (继承自 ContentElement) |
| ContentEnd |
获取一个文本指针，该指针表示元素中内容的末尾。 (继承自 TextElement) |
| ContentStart |
获取一个文本指针，该指针表示元素中内容的开始。 (继承自 TextElement) |
| ContextMenu |
获取或设置上下文菜单元素，该元素应在通过用户界面（UI）从此元素中请求上下文菜单时显示。 (继承自 FrameworkContentElement) |
| Cursor |
获取或设置当鼠标指针位于此元素上时显示的光标。 (继承自 FrameworkContentElement) |
| DataContext |
获取或设置元素参与数据绑定时的数据上下文。 (继承自 FrameworkContentElement) |
| DefaultStyleKey |
获取或设置用于在主题中查找此控件的样式模板的键。 (继承自 FrameworkContentElement) |
| DependencyObjectType |
获取包装 DependencyObjectType 此实例的 CLR 类型。 (继承自 DependencyObject) |
| Dispatcher |
获取与此DispatcherDispatcherObject关联的值。 (继承自 DispatcherObject) |
| ElementEnd |
获取一个文本指针，该指针表示元素末尾之后的位置。 (继承自 TextElement) |
| ElementStart |
获取一个文本指针，该指针表示元素开头前的位置。 (继承自 TextElement) |
| FlowDirection |
获取或设置一个值，该值指定元素中 Inline 内容流的相对方向。 (继承自 Inline) |
| Focusable |
获取或设置一个值，该值指示元素是否可以接收焦点。 (继承自 ContentElement) |
| FocusVisualStyle |
获取或设置一个对象，该对象用于自定义在捕获键盘焦点时将应用于此元素的外观、效果或其他样式特征。 (继承自 FrameworkContentElement) |
| FontFamily |
获取或设置元素内容的首选顶级字体系列。 (继承自 TextElement) |
| FontSize |
获取或设置元素内容的字号。 (继承自 TextElement) |
| FontStretch |
获取或设置元素内容的字体拉伸特征。 (继承自 TextElement) |
| FontStyle |
获取或设置元素内容的字体样式。 (继承自 TextElement) |
| FontWeight |
获取或设置元素内容的顶级字体粗细。 (继承自 TextElement) |
| ForceCursor |
获取或设置一个值，该值指示这是否 FrameworkContentElement 应强制用户界面（UI）将此实例 Cursor 的属性声明的游标呈现。 (继承自 FrameworkContentElement) |
| Foreground |
获取或设置要应用于元素内容的画笔。 (继承自 TextElement) |
| HasAnimatedProperties |
获取一个值，该值指示此元素是否具有任何动画属性。 (继承自 ContentElement) |
| HorizontalAlignment |
获取或设置一个值，该值指示 Floater 对象的水平对齐方式。 |
| InputBindings |
获取与此元素关联的输入绑定的集合。 (继承自 ContentElement) |
| InputScope |
获取或设置此 FrameworkContentElement输入的上下文。 (继承自 FrameworkContentElement) |
| IsEnabled |
获取或设置一个值，该值指示是否在用户界面（UI）中启用此元素。 (继承自 ContentElement) |
| IsEnabledCore |
获取一个值，该值将成为派生类中的返回值 IsEnabled 。 (继承自 ContentElement) |
| IsFocused |
获取一个值，该值确定此元素是否具有逻辑焦点。 (继承自 ContentElement) |
| IsInitialized |
获取一个值，该值指示此元素是否已初始化，要么被加载为可扩展应用程序标记语言（XAML），要么显式调用其 EndInit() 方法。 (继承自 FrameworkContentElement) |
| IsInputMethodEnabled |
获取一个值，该值指示是否启用了输入法系统（如输入法编辑器（IME）来处理此元素的输入。 (继承自 ContentElement) |
| IsKeyboardFocused |
获取一个值，该值指示此元素是否具有键盘焦点。 (继承自 ContentElement) |
| IsKeyboardFocusWithin |
获取一个值，该值指示键盘焦点是元素或子元素中的任意位置。 (继承自 ContentElement) |
| IsLoaded |
获取一个值，该值指示是否已加载此元素以供演示。 (继承自 FrameworkContentElement) |
| IsMouseCaptured |
获取一个值，该值指示鼠标是否由此元素捕获。 (继承自 ContentElement) |
| IsMouseCaptureWithin |
获取一个值，该值确定鼠标捕获是由此元素还是由其元素树中的子元素保存。 (继承自 ContentElement) |
| IsMouseDirectlyOver |
获取一个值，该值指示鼠标指针的位置是否对应于命中测试结果，这将考虑元素组合。 (继承自 ContentElement) |
| IsMouseOver |
获取一个值，该值指示鼠标指针是否位于此元素上（包括视觉子元素或其控件组合）。 (继承自 ContentElement) |
| IsSealed |
获取一个值，该值指示此实例当前是否密封（只读）。 (继承自 DependencyObject) |
| IsStylusCaptured |
获取一个值，该值指示是否将触笔捕获到此元素。 (继承自 ContentElement) |
| IsStylusCaptureWithin |
获取一个值，该值确定触笔捕获是否由此元素保存，包括子元素和控制组合。 (继承自 ContentElement) |
| IsStylusDirectlyOver |
获取一个值，该值指示触笔位置是否对应于命中测试结果，这将考虑元素组合。 (继承自 ContentElement) |
| IsStylusOver |
获取一个值，该值指示触笔是否位于此元素上（包括可视子元素）。 (继承自 ContentElement) |
| Language |
获取或设置应用于单个元素的本地化/全球化语言信息。 (继承自 FrameworkContentElement) |
| LineHeight |
获取或设置每行内容的高度。 (继承自 AnchoredBlock) |
| LineStackingStrategy |
获取或设置在文本元素中为每行文本确定行框的机制。 (继承自 AnchoredBlock) |
| LogicalChildren |
获取一个枚举器，该枚举器可以循环访问元素的逻辑子级。 (继承自 TextElement) |
| Margin |
获取或设置元素的边距粗细。 (继承自 AnchoredBlock) |
| Name |
获取或设置元素的标识名称。 该名称提供实例引用，以便编程代码隐藏（如事件处理程序代码）可以在分析 XAML 期间构造元素后引用元素。 (继承自 FrameworkContentElement) |
| NextInline |
获取作为此元素对等的下一 Inline 个元素。 (继承自 Inline) |
| OverridesDefaultStyle |
获取或设置一个值，该值指示此元素是否包含主题样式中的样式属性。 (继承自 FrameworkContentElement) |
| Padding |
获取或设置元素的填充粗细。 (继承自 AnchoredBlock) |
| Parent |
获取此元素的逻辑树中的父级。 (继承自 FrameworkContentElement) |
| PreviousInline |
获取与此元素对等的上 Inline 一个元素。 (继承自 Inline) |
| Resources |
获取或设置当前本地定义的资源字典。 (继承自 FrameworkContentElement) |
| SiblingInlines |
获取一个 InlineCollection 包含 Inline 此元素的同级元素（对等）。 (继承自 Inline) |
| Style |
获取或设置此元素要使用的样式。 (继承自 FrameworkContentElement) |
| Tag |
获取或设置可用于存储有关此元素的自定义信息的任意对象值。 (继承自 FrameworkContentElement) |
| TemplatedParent |
获取对此元素的模板父级的引用。 如果未通过模板创建元素，则此属性不相关。 (继承自 FrameworkContentElement) |
| TextAlignment |
获取或设置一个值，该值指示文本内容的水平对齐方式。 (继承自 AnchoredBlock) |
| TextDecorations |
获取一个 TextDecorationCollection 包含要应用于此元素的文本修饰。 (继承自 Inline) |
| TextEffects |
获取或设置要应用于元素内容的文本效果的集合。 (继承自 TextElement) |
| ToolTip |
获取或设置用户界面 （UI） 中为此元素显示的工具提示对象。 (继承自 FrameworkContentElement) |
| TouchesCaptured |
获取捕获到此元素的所有触摸设备。 (继承自 ContentElement) |
| TouchesCapturedWithin |
获取捕获到此元素的所有触摸设备或其可视化树中的任何子元素。 (继承自 ContentElement) |
| TouchesDirectlyOver |
获取此元素上的所有触摸设备。 (继承自 ContentElement) |
| TouchesOver |
获取位于此元素上的所有触摸设备或其可视化树中的任何子元素。 (继承自 ContentElement) |
| Typography |
获取元素内容的当前有效版式变体。 (继承自 TextElement) |
| Width |
获取或设置一个值，该值指示 Floater 对象的宽度。 |
方法
活动
显式接口实现
| 名称 | 说明 |
|---|---|
| IAddChild.AddChild(Object) |
添加子对象。 (继承自 TextElement) |
| IAddChild.AddText(String) |
将节点的文本内容添加到对象。 (继承自 TextElement) |
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
有关此成员的说明，请参阅 IsAmbientPropertyAvailable(String) 方法。 (继承自 FrameworkContentElement) |
