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 page」 或 「0.25 content」 或 「2 Column」。 您也可以將高度和寬度設為絕對像素值。
Floater：
無法定位，但會轉譯任何可用的空間。 您無法設定位移或錨定 Floater 。
無法調整為多個資料行的大小：根據預設， Floater 大小為一個資料行。 Width它有屬性可以設定為絕對圖元值，但如果此值大於一個資料行寬度，則會忽略它，而且浮點數會以一個資料行調整大小。 您可以藉由設定正確的圖元寬度，將它大小調整為小於一個資料行，但調整大小不是資料行相對，因此 「0.5Column」 不是寬度的有效運算式 Floater 。 Floater 沒有高度屬性，而且高度無法設定，高度取決於內容
Floater 分頁：如果其指定寬度的內容延伸到超過 1 欄高度，浮點符號和分頁至下一欄、下一頁等等。
Figure 是放置獨立內容的絕佳位置，您想要控制大小和位置，而且確信內容會符合指定的大小。 Floater 是放置更多自由流動內容的絕佳位置，其流程類似于主頁面內容，但與它分開。
建構函式
| Floater() |
初始化 Floater 類別的新執行個體。 |
| Floater(Block) | |
| Floater(Block, TextPointer) |
初始化 Floater 類別的新執行個體，並將指定的 Block 物件做為其初始內容，以及會替新 TextPointer 指定插入位置的 Floater。 |
欄位
| HorizontalAlignmentProperty |
識別 HorizontalAlignment 相依性屬性。 |
| WidthProperty |
識別 Width 相依性屬性。 |
屬性
| AllowDrop |
取得或設定值，這個值表示這個項目是否可以作為拖放作業的目標。 (繼承來源 ContentElement) |
| AreAnyTouchesCaptured |
取得值，這個值表示是否至少有一個觸控擷取至這個項目。 (繼承來源 ContentElement) |
| AreAnyTouchesCapturedWithin |
取得值，這個值表示是否至少有一個觸控擷取至這個項目或其視覺化樹狀結構中的任何子項目。 (繼承來源 ContentElement) |
| AreAnyTouchesDirectlyOver |
取得值，這個值表示是否至少有一個觸控在這個項目上按下。 (繼承來源 ContentElement) |
| AreAnyTouchesOver |
取得值，這個值表示是否至少有一個觸控在這個項目或其視覺化樹狀結構中的任何子項目上按下。 (繼承來源 ContentElement) |
| Background |
取得或設定用來填滿內容區域背景的筆刷。 (繼承來源 TextElement) |
| BaselineAlignment |
取得或設定用於 Inline 項目的基準線對齊。 (繼承來源 Inline) |
| BindingGroup |
取得或設定用於項目的 BindingGroup。 (繼承來源 FrameworkContentElement) |
| Blocks |
取得包含最上層 Block 項目的 BlockCollection，這些項目組成項目的內容。 (繼承來源 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 |
取得與這個 Dispatcher 關聯的 DispatcherObject。 (繼承來源 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 |
取得值，指出這個元素是否已初始化，方法是載入為 Extensible Application Markup Language (XAML) ，或明確呼叫其 EndInit() 方法。 (繼承來源 FrameworkContentElement) |
| IsInputMethodEnabled |
取得值，這個值表示是否已啟用輸入法系統，例如輸入法編輯器 (輸入法) ，以便處理這個專案的輸入。 (繼承來源 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) |
