ComboBox 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表具有下拉式清單的選取控制項，且可按一下控制項上的箭頭來顯示或隱藏。
public ref class ComboBox : System::Windows::Controls::Primitives::Selector[System.Windows.Localizability(System.Windows.LocalizationCategory.ComboBox)]
[System.Windows.StyleTypedProperty(Property="ItemContainerStyle", StyleTargetType=typeof(System.Windows.Controls.ComboBoxItem))]
[System.Windows.TemplatePart(Name="PART_Popup", Type=typeof(System.Windows.Controls.Primitives.Popup))]
[System.Windows.TemplatePart(Name="PART_EditableTextBox", Type=typeof(System.Windows.Controls.TextBox))]
public class ComboBox : System.Windows.Controls.Primitives.Selector[<System.Windows.Localizability(System.Windows.LocalizationCategory.ComboBox)>]
[<System.Windows.StyleTypedProperty(Property="ItemContainerStyle", StyleTargetType=typeof(System.Windows.Controls.ComboBoxItem))>]
[<System.Windows.TemplatePart(Name="PART_Popup", Type=typeof(System.Windows.Controls.Primitives.Popup))>]
[<System.Windows.TemplatePart(Name="PART_EditableTextBox", Type=typeof(System.Windows.Controls.TextBox))>]
type ComboBox = class
inherit SelectorPublic Class ComboBox
Inherits Selector- 繼承
- 屬性
範例
下列範例會建立 ComboBox。 此範例會藉由將 ItemsSource 屬性系結至 類型的 VacationSpots 集合物件來填入 ComboBox 。 此範例也會建立 ， TextBlock 以顯示 的 ComboBox 選取專案。
<StackPanel Grid.Column="0"
Grid.Row="6">
<StackPanel.Resources>
<src:VacationSpots x:Key="myVacations"/>
</StackPanel.Resources>
<ComboBox Name="comboBox1"
ItemsSource="{StaticResource myVacations}"
Text="My Cities"
IsEditable="true"
IsReadOnly="true"/>
<TextBlock Text="{Binding ElementName=comboBox1, Path=SelectedItem}"/>
</StackPanel>
下列範例會定義上述範例中 所系結的集合物件 ComboBox 。
class VacationSpots : ObservableCollection<string>
{
public VacationSpots ()
{
Add("Spain");
Add("France");
Add("Peru");
Add("Mexico");
Add("Italy");
}
}
Class VacationSpots
Inherits ObservableCollection(Of String)
Public Sub New()
Add("Spain")
Add("France")
Add("Peru")
Add("Mexico")
Add("Italy")
End Sub
End Class
備註
ComboBox可讓使用者從下拉式清單中選取專案，或選擇性地在控制項的文字方塊中輸入新的文字。 ComboBox 是 ItemsControl ，這表示它可以包含任何類型的物件集合 (，例如字串、影像或面板) 。 如需詳細資訊，請參閱 ItemsControl 類別。
IsEditable和 IsReadOnly 屬性會指定 ComboBox 當使用者執行下列其中一項時的行為：
下表描述使用者可根據 和 IsReadOnly 的值 IsEditable 採取且無法採取的動作。
IsReadOnly 是 true |
IsReadOnly 是 false |
|
|---|---|---|
IsEditable 是 true |
- 輸入字串，無法選取 中的 ComboBox 專案。 - 無法輸入未對應至 中 ComboBox 專案的字串。 - 可以在文字方塊中選取字串 ComboBox 的一部分。 - 可以複製文字方塊中的 ComboBox 字串，但無法將字串貼到 ComboBox 文字方塊中。 |
- 可以輸入字串來選取 中的 ComboBox 專案。 - 可以輸入未對應至 中 ComboBox 專案的字串。 - 可以在文字方塊中選取字串 ComboBox 的一部分。 - 可以在文字方塊中複製或貼上 ComboBox 字串。 |
IsEditable 是 false |
- 可以輸入字串來選取 中的 ComboBox 專案。 - 無法輸入未對應至 中 ComboBox 專案的字串。 - 無法在 中 ComboBox 選取字串的一部分。 - 無法複製或貼上 中的 ComboBox 字串。 |
- 可以輸入字串來選取 中的 ComboBox 專案。 - 無法輸入未對應至 中 ComboBox 專案的字串。 - 無法在 中 ComboBox 選取字串的一部分。 - 無法複製或貼上 中的 ComboBox 字串。 |
只有在 是 true 時 IsEditable ，屬性 IsReadOnly 才會有效果。
ComboBox是 ItemsControl ，因此它可以顯示簡單字串以外的內容。 例如，您可以建立 ComboBox 包含影像清單的 。 當您在 中 ComboBox 具有字串以外的內容時，當隱藏下拉式清單時，可能會顯示 ComboBox 不區分的字串。 若要在 ComboBox 中包含非字串專案時顯示 字串，請使用 TextSearch.Text 或 TextSearch.TextPath 附加屬性。
自訂 ComboBox 控制項
若要將相同的屬性設定套用至多個 ComboBox 控制項，請使用 Style 屬性。 您可以修改預設值 ControlTemplate ，讓控制項具有唯一的外觀。 如需建立 ControlTemplate 的詳細資訊，請參閱 建立 ControlTemplate 來自訂現有控制項的外觀。 若要查看 的特定 ComboBox 元件和狀態，請參閱 ComboBox 樣式和範本。
此控制項的相依性屬性可能是由控制項的預設樣式所設定。 如果屬性是以預設樣式設定，當控制項出現在應用程式中時，屬性可能會從其預設值變更。 預設樣式取決於應用程式執行時所使用的桌面主題。
注意
如果該屬性同時顯示於控制項的預設範本，並使用 TemplateBinding 來設定，則設定視覺效果屬性僅具效果作用。 您可以在通過建立 ControlTemplate 自訂現有控制項的外觀文章的變更控制項的視覺效果結構一節中找到視覺效果屬性清單。
建構函式
| ComboBox() |
初始化 ComboBox 類別的新執行個體。 |
欄位
| IsDropDownOpenProperty |
識別 IsDropDownOpen 相依性屬性。 |
| IsEditableProperty |
識別 IsEditable 相依性屬性。 |
| IsReadOnlyProperty |
識別 IsReadOnly 相依性屬性。 |
| MaxDropDownHeightProperty |
識別 MaxDropDownHeight 相依性屬性。 |
| SelectionBoxItemProperty |
識別 SelectionBoxItem 相依性屬性。 |
| SelectionBoxItemStringFormatProperty |
識別 SelectionBoxItemStringFormat 相依性屬性。 |
| SelectionBoxItemTemplateProperty |
識別 SelectionBoxItemTemplate 相依性屬性。 |
| ShouldPreserveUserEnteredPrefixProperty |
識別 ShouldPreserveUserEnteredPrefix 相依性屬性。 |
| StaysOpenOnEditProperty |
識別 StaysOpenOnEdit 相依性屬性。 |
| TextProperty |
識別 Text 相依性屬性。 |
屬性
| ActualHeight |
取得呈現此項目的高度。 (繼承來源 FrameworkElement) |
| ActualWidth |
取得呈現此項目的寬度。 (繼承來源 FrameworkElement) |
| AllowDrop |
取得或設定此元素是否可以當做拖放操作目標的值。 這是相依性屬性。 (繼承來源 UIElement) |
| AlternationCount |
取得或設定 ItemsControl 中的交替項目容器數，它可讓交替容器具有獨特的外觀。 (繼承來源 ItemsControl) |
| AreAnyTouchesCaptured |
取得值，這個值表示是否至少有一個觸控擷取至這個項目。 (繼承來源 UIElement) |
| AreAnyTouchesCapturedWithin |
取得值，這個值表示是否至少有一個觸控擷取至這個項目或其視覺化樹狀結構中的任何子項目。 (繼承來源 UIElement) |
| AreAnyTouchesDirectlyOver |
取得值，這個值表示是否至少有一個觸控在這個項目上按下。 (繼承來源 UIElement) |
| AreAnyTouchesOver |
取得值，這個值表示是否至少有一個觸控在這個項目或其視覺化樹狀結構中的任何子項目上按下。 (繼承來源 UIElement) |
| Background |
取得或設定描述控制項背景的筆刷。 (繼承來源 Control) |
| BindingGroup |
取得或設定用於項目的 BindingGroup。 (繼承來源 FrameworkElement) |
| BitmapEffect |
已淘汰.
已淘汰.
取得或設定直接套用至此元素呈現內容的點陣圖效果。 這是相依性屬性。 (繼承來源 UIElement) |
| BitmapEffectInput |
已淘汰.
已淘汰.
取得或設定直接套用至此元素呈現內容的點陣圖效果輸入來源。 這是相依性屬性。 (繼承來源 UIElement) |
| BorderBrush |
取得或設定描述控制項框線背景的筆刷。 (繼承來源 Control) |
| BorderThickness |
取得或設定控制項的框線粗細。 (繼承來源 Control) |
| CacheMode |
取得或設定 UIElement 的快取表示。 (繼承來源 UIElement) |
| Clip |
取得或設定用來定義項目內容外框的幾何。 這是相依性屬性。 (繼承來源 UIElement) |
| ClipToBounds |
取得或設定是否裁剪此元素 (或來自此元素的子元素) 的內容，以符合容器元素大小的值。 這是相依性屬性。 (繼承來源 UIElement) |
| CommandBindings |
取得與這個項目關聯的 CommandBinding 物件集合。 CommandBinding 會啟用此項目的命令處理，並宣告命令、其事件及此項目所附加之處理常式之間的連結。 (繼承來源 UIElement) |
| ContextMenu |
取得或設定每當透過使用者介面要求操作功能表時，應該顯示的快顯功能表元素， (UI) 此元素內。 (繼承來源 FrameworkElement) |
| Cursor |
取得或設定滑鼠指標在此元素上方時所顯示的游標。 (繼承來源 FrameworkElement) |
| DataContext |
取得或設定項目在參與資料繫結時的資料內容。 (繼承來源 FrameworkElement) |
| DefaultStyleKey |
取得或設定可在使用或定義佈景主題樣式時，用來參考這個控制項之樣式的索引鍵。 (繼承來源 FrameworkElement) |
| DependencyObjectType |
DependencyObjectType取得包裝這個實例之 CLR 型別的 。 (繼承來源 DependencyObject) |
| DesiredSize |
取得這個項目在版面配置處理序的測量傳遞期間所計算的大小。 (繼承來源 UIElement) |
| Dispatcher |
取得與這個 Dispatcher 關聯的 DispatcherObject。 (繼承來源 DispatcherObject) |
| DisplayMemberPath |
取得或設定來源物件上值的路徑，以當作此物件的視覺表示。 (繼承來源 ItemsControl) |
| Effect |
取得或設定要套用至 UIElement 的點陣圖效果。 這是相依性屬性。 (繼承來源 UIElement) |
| FlowDirection |
取得或設定文字和其他使用者介面的方向， (UI) 元素在控制其配置的任何父元素內流動。 (繼承來源 FrameworkElement) |
| Focusable |
取得或設定元素是否能夠接收焦點的值。 這是相依性屬性。 (繼承來源 UIElement) |
| FocusVisualStyle |
取得或設定屬性，這個屬性可自訂外觀、效果或其他樣式特性，以在這個項目捕捉到鍵盤焦點時套用至項目。 (繼承來源 FrameworkElement) |
| FontFamily |
取得或設定控制項的字型系列。 (繼承來源 Control) |
| FontSize |
取得或設定字型大小。 (繼承來源 Control) |
| FontStretch |
取得或設定螢幕上字型緊縮或加寬的程度。 (繼承來源 Control) |
| FontStyle |
取得或設定字型樣式。 (繼承來源 Control) |
| FontWeight |
取得或設定指定字型的粗細。 (繼承來源 Control) |
| ForceCursor |
取得或設定值，這個值表示這 FrameworkElement 是否應該強制使用者介面 (UI) 轉譯資料指標，如 屬性所 Cursor 宣告。 (繼承來源 FrameworkElement) |
| Foreground |
取得或設定描述前景色彩的筆刷。 (繼承來源 Control) |
| GroupStyle |
取得 GroupStyle 物件的集合，定義每個群組層級的外觀。 (繼承來源 ItemsControl) |
| GroupStyleSelector |
取得或設定方法，讓您可針對 GroupStyle 提供自訂選取邏輯，以套用至集合中的每個群組。 (繼承來源 ItemsControl) |
| HandlesScrolling |
取得值，這個值表示下拉式方塊是否支援捲動。 |
| HasAnimatedProperties |
取得值，這個值表示此項目是否有任何動畫屬性。 (繼承來源 UIElement) |
| HasEffectiveKeyboardFocus |
取得值，指出 ComboBox 是否具有焦點。 |
| HasEffectiveKeyboardFocus |
取得值，指出 UIElement 是否具有焦點。 (繼承來源 UIElement) |
| HasItems |
取得表示 ItemsControl 是否包含項目的值。 (繼承來源 ItemsControl) |
| Height |
取得或設定項目的建議高度。 (繼承來源 FrameworkElement) |
| HorizontalAlignment |
取得或設定套用至此元素在父項元素 (例如面板或項目控制項) 中組成時的水平對齊特性。 (繼承來源 FrameworkElement) |
| HorizontalContentAlignment |
取得或設定控制項內容的水平對齊。 (繼承來源 Control) |
| InheritanceBehavior |
取得或設定屬性值繼承的範圍限制、資源索引鍵查閱，以及 RelativeSource FindAncestor 查閱。 (繼承來源 FrameworkElement) |
| InputBindings |
取得與此元素關聯的輸入繫結集合。 (繼承來源 UIElement) |
| InputScope |
取得或設定此 FrameworkElement 使用的輸入內容。 (繼承來源 FrameworkElement) |
| IsArrangeValid |
取得值，這個值表示在此項目之配置中子項目的計算大小和位置是有效的。 (繼承來源 UIElement) |
| IsDropDownOpen |
取得或設定下拉式方塊的下拉清單目前是否開啟的值。 |
| IsEditable |
取得或設定值，這個值啟用或停用 ComboBox 之文字方塊中的文字編輯功能。 |
| IsEnabled |
取得或設定值，指出使用者介面中是否啟用這個專案， (UI) 。 這是相依性屬性。 (繼承來源 UIElement) |
| IsEnabledCore |
取得值，這個值會成為衍生類別中 IsEnabled 的傳回值。 (繼承來源 UIElement) |
| IsFocused |
取得值，決定這個項目是否具有邏輯焦點。 這是相依性屬性。 (繼承來源 UIElement) |
| IsGrouping |
取得指出控制項是否使用群組的值。 (繼承來源 ItemsControl) |
| IsHitTestVisible |
取得或設定宣告此元素是否可以從其呈現內容的某些部分傳回，作為點擊測試結果的值。 這是相依性屬性。 (繼承來源 UIElement) |
| IsInitialized |
取得值，這個值表示這個元素是否已初始化，不論是在 XAML 處理器處理期間，還是明確呼叫其 EndInit() 方法。 (繼承來源 FrameworkElement) |
| IsInputMethodEnabled |
取得值，指出是否啟用輸入法編輯器 (輸入法) 等輸入法系統，以處理這個專案的輸入。 (繼承來源 UIElement) |
| IsKeyboardFocused |
取得值，指出這個項目是否具有鍵盤焦點。 這是相依性屬性。 (繼承來源 UIElement) |
| IsKeyboardFocusWithin |
取得值，表示鍵盤焦點是否在項目或其視覺化樹狀結構子項目內的任何位置。 這是相依性屬性。 (繼承來源 UIElement) |
| IsLoaded |
取得值，這個值表示此項目是否已載入以供展示。 (繼承來源 FrameworkElement) |
| IsManipulationEnabled |
取得或設定值，這個值表示是否在此 UIElement 上啟用操作事件。 (繼承來源 UIElement) |
| IsMeasureValid |
取得值，這個值表示配置測量所傳回的目前大小是否有效。 (繼承來源 UIElement) |
| IsMouseCaptured |
取得值，指出是否將滑鼠擷取至這個項目。 這是相依性屬性。 (繼承來源 UIElement) |
| IsMouseCaptureWithin |
取得值，這個值決定滑鼠擷取是由這個項目持有，還是由其視覺化樹狀中的子項目持有。 這是相依性屬性。 (繼承來源 UIElement) |
| IsMouseDirectlyOver |
取得值，指出滑鼠指標位置是否與點擊測試結果對應，該結果會將複合項目納入考量。 這是相依性屬性。 (繼承來源 UIElement) |
| IsMouseOver |
取得值，指出滑鼠指標是否在這個項目上方 (包括視覺化樹狀中的子項目)。 這是相依性屬性。 (繼承來源 UIElement) |
| IsReadOnly |
取得或設定值，這個值會啟用僅顯示選取項目模式，使用者在此模式中只能選取下拉式方塊的內容，但無法編輯。 |
| IsSealed |
取得值，這個值表示此執行個體目前是否已密封 (唯讀)。 (繼承來源 DependencyObject) |
| IsSelectionBoxHighlighted |
取得 SelectionBoxItem 是否反白顯示的值。 |
| IsStylusCaptured |
取得值，指出這個項目是否擷取手寫筆。 這是相依性屬性。 (繼承來源 UIElement) |
| IsStylusCaptureWithin |
取得值，這個值決定手寫筆擷取是由這個項目持有，還是由項目範圍及其視覺化樹狀結構中的項目持有。 這是相依性屬性。 (繼承來源 UIElement) |
| IsStylusDirectlyOver |
取得值，指出手寫筆位置是否與點擊測試結果相對應，該結果會將複合項目納入考量。 這是相依性屬性。 (繼承來源 UIElement) |
| IsStylusOver |
取得值，指出手寫筆游標是否位在這個項目上方 (包括視覺子項目)。 這是相依性屬性。 (繼承來源 UIElement) |
| IsSynchronizedWithCurrentItem |
取得或設定值，這個值表示 Selector 是否應維持 SelectedItem 與 Items 屬性中的目前項目同步。 (繼承來源 Selector) |
| IsTabStop |
取得或設定值，這個值表示控制項是否包含於索引標籤巡覽。 (繼承來源 Control) |
| IsTextSearchCaseSensitive |
取得或設定值，其表示在搜尋項目時，大小寫是否也是條件之一。 (繼承來源 ItemsControl) |
| IsTextSearchEnabled |
取得或設定值，表示 TextSearch 是否已在 ItemsControl 執行個體上啟用。 (繼承來源 ItemsControl) |
| IsVisible |
取得值，指出使用者介面中是否顯示這個專案 (UI) 。 這是相依性屬性。 (繼承來源 UIElement) |
| ItemBindingGroup |
取得或設定複製到 ItemsControl 中每個項目的 BindingGroup。 (繼承來源 ItemsControl) |
| ItemContainerGenerator |
取得與控制項關聯的 ItemContainerGenerator。 (繼承來源 ItemsControl) |
| ItemContainerStyle |
取得或設定 Style，它會套用到為每個項目所產生的容器項目。 (繼承來源 ItemsControl) |
| ItemContainerStyleSelector |
取得或設定可以套用至每個產生之容器項目的樣式的自訂樣式選取邏輯。 (繼承來源 ItemsControl) |
| Items |
取得用來產生 ItemsControl 之內容的集合。 (繼承來源 ItemsControl) |
| ItemsPanel |
取得或設定樣板，這個樣板會定義控制項目配置的面板。 (繼承來源 ItemsControl) |
| ItemsSource |
取得或設定用來產生 ItemsControl 之內容的集合。 (繼承來源 ItemsControl) |
| ItemStringFormat |
取得或設定複合字串，這個字串會指定如何格式化 ItemsControl 中要以字串形式顯示的項目。 (繼承來源 ItemsControl) |
| ItemTemplate |
取得或設定用來顯示每個項目的 DataTemplate。 (繼承來源 ItemsControl) |
| ItemTemplateSelector |
取得或設定選擇用來顯示每個項目範本的自訂邏輯。 (繼承來源 ItemsControl) |
| Language |
取得或設定套用至項目的當地語系化/全球化語言資訊。 (繼承來源 FrameworkElement) |
| LayoutTransform |
取得或設定在配置執行時應該套用至這個專案的圖形轉換。 (繼承來源 FrameworkElement) |
| LogicalChildren |
取得 ItemsControl 物件的邏輯子物件列舉程式。 (繼承來源 ItemsControl) |
| Margin |
取得或設定項目的外邊界。 (繼承來源 FrameworkElement) |
| MaxDropDownHeight |
取得或設定下拉式方塊之下拉式清單的最大高度。 |
| MaxHeight |
取得或設定元素的最大高度限制。 (繼承來源 FrameworkElement) |
| MaxWidth |
取得或設定元素的最大寬度限制。 (繼承來源 FrameworkElement) |
| MinHeight |
取得或設定元素的最小高度限制。 (繼承來源 FrameworkElement) |
| MinWidth |
取得或設定元素的最小寬度限制。 (繼承來源 FrameworkElement) |
| Name |
取得或設定項目的識別名稱。 名稱會提供參考，讓事件處理常式程式碼等程式碼後置可以在 XAML 處理器處理期間建構標記專案之後參考它。 (繼承來源 FrameworkElement) |
| Opacity |
取得或設定在使用者介面 (UI) 轉譯時套用至整個 UIElement 的不透明度因數。 這是相依性屬性。 (繼承來源 UIElement) |
| OpacityMask |
取得或設定套用至任何 Alpha 色板遮罩 (用來遮住此項目的呈現內容) 時實作 Brush 的不透明度遮罩。 這是相依性屬性。 (繼承來源 UIElement) |
| OverridesDefaultStyle |
取得或設定此元素的樣式屬性是否來自佈景主題樣式的值。 (繼承來源 FrameworkElement) |
| Padding |
取得或設定控制項內部的邊框間距。 (繼承來源 Control) |
| Parent |
取得這個專案的邏輯父元素。 (繼承來源 FrameworkElement) |
| PersistId |
已淘汰.
取得值，這個值可唯一識別此項目。 (繼承來源 UIElement) |
| RenderSize |
取得 (或設定) 這個項目的最終呈現大小。 (繼承來源 UIElement) |
| RenderTransform |
取得或設定影響這個項目呈現位置的轉換資訊。 這是相依性屬性。 (繼承來源 UIElement) |
| RenderTransformOrigin |
取得或設定 RenderTransform (相對於項目邊界) 宣告任何可能呈現轉換的中心點。 這是相依性屬性。 (繼承來源 UIElement) |
| Resources |
取得或設定在本機定義的資源字典。 (繼承來源 FrameworkElement) |
| SelectedIndex |
取得或設定目前選取範圍中第一個項目的索引，若選取範圍是空的，則傳回 -1。 (繼承來源 Selector) |
| SelectedItem |
取得或設定目前選取範圍中的第一個項目，如果選取範圍是空的，則傳回 null。 (繼承來源 Selector) |
| SelectedValue |
取得或設定藉由使用 SelectedItem 而獲得的 SelectedValuePath 值。 (繼承來源 Selector) |
| SelectedValuePath |
取得或設定路徑，這個路徑會用來從 SelectedValue 取得 SelectedItem。 (繼承來源 Selector) |
| SelectionBoxItem |
取得顯示在選取方塊中的項目。 |
| SelectionBoxItemStringFormat |
取得複合字串，這個字串會指定如何在選取方塊中選取的項目顯示為字串時，將其格式化。 |
| SelectionBoxItemTemplate |
取得選取方塊內容的項目範本。 |
| ShouldPreserveUserEnteredPrefix |
取得或設定值，指出 ComboBox 是否會保留使用者的輸入，或者用符合的項目取代輸入。 |
| SnapsToDevicePixels |
取得或設定值，該值判斷這個項目的呈現在呈現期間是否該使用裝置特定像素的設定。 這是相依性屬性。 (繼承來源 UIElement) |
| StaysOpenOnEdit |
取得或設定值，這個值表示當使用者按一下 ComboBox 時，已開啟並顯示下拉式清單控制項的 TextBox 是否會保持開啟狀態。 |
| Style |
取得或設定這個項目呈現時要使用的樣式。 (繼承來源 FrameworkElement) |
| StylusPlugIns |
取得與這個項目關聯的所有手寫筆外掛程式 (自訂) 物件集合。 (繼承來源 UIElement) |
| TabIndex |
取得或設定值，此值會決定當使用者使用 TAB 鍵巡覽控制項時，項目接收焦點的順序。 (繼承來源 Control) |
| Tag |
取得或設定可以用來儲存關於此元素自訂資訊的任意物件值。 (繼承來源 FrameworkElement) |
| Template |
取得或設定控制項範本。 (繼承來源 Control) |
| TemplatedParent |
取得這個項目的範本父代參考。 若此項目不是透過範本建立，則這個屬性不相關。 (繼承來源 FrameworkElement) |
| Text |
取得或設定目前選取之項目的文字。 |
| ToolTip |
取得或設定在使用者介面中為這個專案顯示的工具提示物件， (UI) 。 (繼承來源 FrameworkElement) |
| TouchesCaptured |
取得已擷取至這個項目的所有觸控裝置。 (繼承來源 UIElement) |
| TouchesCapturedWithin |
取得已擷取至這個項目或其視覺化樹狀結構中之任何子項目的所有觸控裝置。 (繼承來源 UIElement) |
| TouchesDirectlyOver |
取得在這個項目上停留的所有觸控裝置。 (繼承來源 UIElement) |
| TouchesOver |
取得在這個項目或其視覺化樹狀結構中之任何子項目上停留的所有觸控裝置。 (繼承來源 UIElement) |
| Triggers |
取得直接在這個項目或子項目中建立的觸發程序集合。 (繼承來源 FrameworkElement) |
| Uid |
取得或設定這個項目的唯一識別項 (適用於當地語系化)。 這是相依性屬性。 (繼承來源 UIElement) |
| UseLayoutRounding |
取得或設定值，指出配置進位是否應該在配置期間套用到這個項目的大小和位置。 (繼承來源 FrameworkElement) |
| VerticalAlignment |
取得或設定套用至此項目在父項目 (例如面板或項目控制項) 中組成時的垂直對齊特性。 (繼承來源 FrameworkElement) |
| VerticalContentAlignment |
取得或設定控制項內容的垂直對齊。 (繼承來源 Control) |
| Visibility |
取得或設定使用者介面 (UI) 這個專案的可見度。 這是相依性屬性。 (繼承來源 UIElement) |
| VisualBitmapEffect |
已淘汰.
已淘汰.
取得或設定 BitmapEffect 的 Visual 值。 (繼承來源 Visual) |
| VisualBitmapEffectInput |
已淘汰.
已淘汰.
取得或設定 BitmapEffectInput 的 Visual 值。 (繼承來源 Visual) |
| VisualBitmapScalingMode |
取得或設定 BitmapScalingMode 的 Visual。 (繼承來源 Visual) |
| VisualCacheMode |
取得或設定 Visual 的快取表示。 (繼承來源 Visual) |
| VisualChildrenCount |
取得這個項目內的視覺化子項目數。 (繼承來源 FrameworkElement) |
| VisualClearTypeHint |
取得或設定 ClearTypeHint，以決定 Visual 中的 ClearType 呈現方式。 (繼承來源 Visual) |
| VisualClip |
取得或設定 Visual 的裁剪區域做為 Geometry 值。 (繼承來源 Visual) |
| VisualEdgeMode |
取得或設定 Visual 的邊緣模式做為 EdgeMode 值。 (繼承來源 Visual) |
| VisualEffect |
取得或設定要套用至 Visual 的點陣圖效果。 (繼承來源 Visual) |
| VisualOffset |
取得或設定視覺物件的位移值。 (繼承來源 Visual) |
| VisualOpacity |
取得或設定 Visual 的不透明度。 (繼承來源 Visual) |
| VisualOpacityMask |
取得或設定 Brush 值，這個值表示 Visual 的不透明遮罩。 (繼承來源 Visual) |
| VisualParent |
取得視覺物件的視覺化樹狀結構父物件。 (繼承來源 Visual) |
| VisualScrollableAreaClip |
取得或設定 Visual 的可捲動裁剪區域。 (繼承來源 Visual) |
| VisualTextHintingMode |
取得或設定 Visual 的 TextHintingMode。 (繼承來源 Visual) |
| VisualTextRenderingMode |
取得或設定 Visual 的 TextRenderingMode。 (繼承來源 Visual) |
| VisualTransform | (繼承來源 Visual) |
| VisualXSnappingGuidelines |
取得或設定 X 座標 (垂直) 導線集合。 (繼承來源 Visual) |
| VisualYSnappingGuidelines |
取得或設定 Y 座標 (水平) 導線集合。 (繼承來源 Visual) |
| Width |
取得或設定元素的寬度。 (繼承來源 FrameworkElement) |
方法
事件
| ContextMenuClosing |
在項目上的任何內容功能表正要關閉之前發生。 (繼承來源 FrameworkElement) |
| ContextMenuOpening |
當項目上的任何內容功能表開啟時發生。 (繼承來源 FrameworkElement) |
| DataContextChanged |
這個項目的資料內容變更時發生。 (繼承來源 FrameworkElement) |
| DragEnter |
輸入系統報告其下以此項目作為拖曳目標的拖曳事件時發生。 (繼承來源 UIElement) |
| DragLeave |
輸入系統報告其下以此項目作為拖曳來源的拖曳事件時發生。 (繼承來源 UIElement) |
| DragOver |
在輸入系統回報以此項目作為可能置放目標的基礎拖曳事件時發生。 (繼承來源 UIElement) |
| Drop |
輸入系統報告其下以這個項目作為置放目標的置放事件時發生。 (繼承來源 UIElement) |
| DropDownClosed |
發生於下拉式方塊的下拉式清單關閉時。 |
| DropDownOpened |
發生於下拉式方塊的下拉式清單開啟時。 |
| FocusableChanged |
發生於 Focusable 屬性的值變更時。 (繼承來源 UIElement) |
| GiveFeedback |
輸入系統報告其下牽涉此元素的拖放事件時發生。 (繼承來源 UIElement) |
| GotFocus |
此元素取得邏輯焦點時發生。 (繼承來源 UIElement) |
| GotKeyboardFocus |
鍵盤以此元素為焦點時發生。 (繼承來源 UIElement) |
| GotMouseCapture |
此元素擷取滑鼠時發生。 (繼承來源 UIElement) |
| GotStylusCapture |
此元素擷取手寫筆時發生。 (繼承來源 UIElement) |
| GotTouchCapture |
當觸控擷取至這個項目時發生。 (繼承來源 UIElement) |
| Initialized |
當這個 FrameworkElement 初始化時發生。 這個事件符合 IsInitialized 屬性值從 |
| IsEnabledChanged |
當這個項目的 IsEnabled 屬性值變更時發生。 (繼承來源 UIElement) |
| IsHitTestVisibleChanged |
當這個項目的 IsHitTestVisible 相依性屬性值變更時發生。 (繼承來源 UIElement) |
| IsKeyboardFocusedChanged |
當這個項目的 IsKeyboardFocused 屬性值變更時發生。 (繼承來源 UIElement) |
| IsKeyboardFocusWithinChanged |
當這個項目的 IsKeyboardFocusWithin 屬性值變更時發生。 (繼承來源 UIElement) |
| IsMouseCapturedChanged |
當這個項目的 IsMouseCaptured 屬性值變更時發生。 (繼承來源 UIElement) |
| IsMouseCaptureWithinChanged |
當這個項目的 IsMouseCaptureWithinProperty 值變更時發生。 (繼承來源 UIElement) |
| IsMouseDirectlyOverChanged |
當這個項目的 IsMouseDirectlyOver 屬性值變更時發生。 (繼承來源 UIElement) |
| IsStylusCapturedChanged |
當這個項目的 IsStylusCaptured 屬性值變更時發生。 (繼承來源 UIElement) |
| IsStylusCaptureWithinChanged |
當這個項目的 IsStylusCaptureWithin 屬性值變更時發生。 (繼承來源 UIElement) |
| IsStylusDirectlyOverChanged |
當這個項目的 IsStylusDirectlyOver 屬性值變更時發生。 (繼承來源 UIElement) |
| IsVisibleChanged |
當這個項目的 IsVisible 屬性值變更時發生。 (繼承來源 UIElement) |
| KeyDown |
焦點在這個項目上方且按下按鍵時發生。 (繼承來源 UIElement) |
| KeyUp |
焦點在這個項目上方且放開按鍵時發生。 (繼承來源 UIElement) |
| LayoutUpdated |
當目前 Dispatcher 的數個關聯視覺化項目的配置變更時發生。 (繼承來源 UIElement) |
| Loaded |
當項目已配置版面、呈現以及可以互動時發生。 (繼承來源 FrameworkElement) |
| LostFocus |
此元素失去邏輯焦點時發生。 (繼承來源 UIElement) |
| LostKeyboardFocus |
鍵盤不再以此元素為焦點時發生。 (繼承來源 UIElement) |
| LostMouseCapture |
此元素失去滑鼠擷取時發生。 (繼承來源 UIElement) |
| LostStylusCapture |
此元素失去手寫筆擷取時發生。 (繼承來源 UIElement) |
| LostTouchCapture |
當這個項目失去觸控擷取時發生。 (繼承來源 UIElement) |
| ManipulationBoundaryFeedback |
當操作遇到界限時發生。 (繼承來源 UIElement) |
| ManipulationCompleted |
當對 UIElement 物件進行的操作和慣性完成時發生。 (繼承來源 UIElement) |
| ManipulationDelta |
輸入裝置在操作期間變更位置時發生。 (繼承來源 UIElement) |
| ManipulationInertiaStarting |
當輸入裝置在操作期間失去和 UIElement 物件的通訊以及慣性開始時發生。 (繼承來源 UIElement) |
| ManipulationStarted |
當輸入裝置開始對 UIElement 物件進行操作時發生。 (繼承來源 UIElement) |
| ManipulationStarting |
發生於第一次建立操作處理器時。 (繼承來源 UIElement) |
| MouseDoubleClick |
發生於按兩下或更多下滑鼠按鈕時。 (繼承來源 Control) |
| MouseDown |
指標在此元素上方且按下任何滑鼠按鈕時發生。 (繼承來源 UIElement) |
| MouseEnter |
滑鼠指標進入此元素的邊界時發生。 (繼承來源 UIElement) |
| MouseLeave |
滑鼠指標離開此元素的邊界時發生。 (繼承來源 UIElement) |
| MouseLeftButtonDown |
滑鼠指標在此元素上方且按下滑鼠左按鈕時發生。 (繼承來源 UIElement) |
| MouseLeftButtonUp |
滑鼠指標在此元素上方且放開滑鼠左按鈕時發生。 (繼承來源 UIElement) |
| MouseMove |
滑鼠指標在此元素上方移動時發生。 (繼承來源 UIElement) |
| MouseRightButtonDown |
滑鼠指標在此元素上方且按下滑鼠右按鈕時發生。 (繼承來源 UIElement) |
| MouseRightButtonUp |
滑鼠指標在此元素上方且放開滑鼠右按鈕時發生。 (繼承來源 UIElement) |
| MouseUp |
在此元素上方放開任何滑鼠按鈕時發生。 (繼承來源 UIElement) |
| MouseWheel |
滑鼠指標在此元素上方且使用者滾動滑鼠滾輪時發生。 (繼承來源 UIElement) |
| PreviewDragEnter |
輸入系統報告其下以此項目作為拖曳目標的拖曳事件時發生。 (繼承來源 UIElement) |
| PreviewDragLeave |
輸入系統報告其下以此項目作為拖曳來源的拖曳事件時發生。 (繼承來源 UIElement) |
| PreviewDragOver |
在輸入系統回報以此項目作為可能置放目標的基礎拖曳事件時發生。 (繼承來源 UIElement) |
| PreviewDrop |
輸入系統報告其下以這個項目作為置放目標的置放事件時發生。 (繼承來源 UIElement) |
| PreviewGiveFeedback |
拖放操作開始時發生。 (繼承來源 UIElement) |
| PreviewGotKeyboardFocus |
鍵盤以此元素為焦點時發生。 (繼承來源 UIElement) |
| PreviewKeyDown |
焦點在這個項目上方且按下按鍵時發生。 (繼承來源 UIElement) |
| PreviewKeyUp |
焦點在這個項目上方且放開按鍵時發生。 (繼承來源 UIElement) |
| PreviewLostKeyboardFocus |
鍵盤不再以此元素為焦點時發生。 (繼承來源 UIElement) |
| PreviewMouseDoubleClick |
使用者按滑鼠按鈕超過兩下時發生。 (繼承來源 Control) |
| PreviewMouseDown |
指標在此元素上方且按下任何滑鼠按鈕時發生。 (繼承來源 UIElement) |
| PreviewMouseLeftButtonDown |
滑鼠指標在此元素上方且按下滑鼠左按鈕時發生。 (繼承來源 UIElement) |
| PreviewMouseLeftButtonUp |
滑鼠指標在此元素上方且放開滑鼠左按鈕時發生。 (繼承來源 UIElement) |
| PreviewMouseMove |
滑鼠指標在此元素上方且移動滑鼠指標時發生。 (繼承來源 UIElement) |
| PreviewMouseRightButtonDown |
滑鼠指標在此元素上方且按下滑鼠右按鈕時發生。 (繼承來源 UIElement) |
| PreviewMouseRightButtonUp |
滑鼠指標在此元素上方且放開滑鼠右按鈕時發生。 (繼承來源 UIElement) |
| PreviewMouseUp |
滑鼠指標在此元素上方且放開任何滑鼠按鈕時發生。 (繼承來源 UIElement) |
| PreviewMouseWheel |
滑鼠指標在此元素上方且使用者滾動滑鼠滾輪時發生。 (繼承來源 UIElement) |
| PreviewQueryContinueDrag |
拖放操作期間，鍵盤或滑鼠按鈕狀態變更時發生。 (繼承來源 UIElement) |
| PreviewStylusButtonDown |
手寫筆指標在此元素上方且按下手寫筆按鈕時發生。 (繼承來源 UIElement) |
| PreviewStylusButtonUp |
手寫筆指標在此元素上方且放開手寫筆按鈕時發生。 (繼承來源 UIElement) |
| PreviewStylusDown |
手寫筆在此項目上方且碰觸數位板時發生。 (繼承來源 UIElement) |
| PreviewStylusInAirMove |
手寫筆在項目上方移動，但沒有真正碰觸數位板時發生。 (繼承來源 UIElement) |
| PreviewStylusInRange |
手寫筆在此項目上方，且夠靠近數位板而被偵測到時發生。 (繼承來源 UIElement) |
| PreviewStylusMove |
手寫筆在項目上方移動時發生。 手寫筆必須在受到數位板偵測時移動才能引發此事件，否則會改為引發 PreviewStylusInAirMove。 (繼承來源 UIElement) |
| PreviewStylusOutOfRange |
手寫筆遠離數位板而無法被偵測到時發生。 (繼承來源 UIElement) |
| PreviewStylusSystemGesture |
使用者執行其中一種手寫筆筆勢時發生。 (繼承來源 UIElement) |
| PreviewStylusUp |
手寫筆在此項目上方，且使用者將手寫筆舉起離開數位板時發生。 (繼承來源 UIElement) |
| PreviewTextInput |
此元素以一種與裝置無關的方式取得文字時發生。 (繼承來源 UIElement) |
| PreviewTouchDown |
手指在這個項目上方且在螢幕上觸控時發生。 (繼承來源 UIElement) |
| PreviewTouchMove |
手指在這個項目上方且在螢幕上移動時發生。 (繼承來源 UIElement) |
| PreviewTouchUp |
手指在這個項目上方且離開螢幕時發生。 (繼承來源 UIElement) |
| QueryContinueDrag |
拖放操作期間，鍵盤或滑鼠按鈕狀態變更時發生。 (繼承來源 UIElement) |
| QueryCursor |
要求顯示游標時發生。 每當滑鼠指標移動至新位置時，都會引發此事件，這意謂游標物件可能會根據其新位置而變更。 (繼承來源 UIElement) |
| RequestBringIntoView |
在這個項目上呼叫 BringIntoView(Rect) 時發生。 (繼承來源 FrameworkElement) |
| SelectionChanged |
發生於 Selector 的選取範圍變更時。 (繼承來源 Selector) |
| SizeChanged |
當這個項目的 ActualHeight 或 ActualWidth 屬性變更值時發生。 (繼承來源 FrameworkElement) |
| SourceUpdated |
來源值因與此項目繫結的任何現有屬性變更時發生。 (繼承來源 FrameworkElement) |
| StylusButtonDown |
手寫筆指標在此元素上方且按下手寫筆按鈕時發生。 (繼承來源 UIElement) |
| StylusButtonUp |
手寫筆指標在此元素上方且放開手寫筆按鈕時發生。 (繼承來源 UIElement) |
| StylusDown |
手寫筆在此項目上方且碰觸數位板時發生。 (繼承來源 UIElement) |
| StylusEnter |
手寫筆進入此元素的邊界時發生。 (繼承來源 UIElement) |
| StylusInAirMove |
手寫筆在項目上方移動，但沒有真正碰觸數位板時發生。 (繼承來源 UIElement) |
| StylusInRange |
手寫筆在此項目上方，且夠靠近數位板而被偵測到時發生。 (繼承來源 UIElement) |
| StylusLeave |
手寫筆離開元素的邊界時發生。 (繼承來源 UIElement) |
| StylusMove |
當手寫筆移至此項目上方時發生。 手寫筆在數位板上必須移動才會引發這個事件。 否則，會改為引發 StylusInAirMove。 (繼承來源 UIElement) |
| StylusOutOfRange |
手寫筆在此項目上方，且遠離數位板而無法被偵測到時發生。 (繼承來源 UIElement) |
| StylusSystemGesture |
使用者執行其中一種手寫筆筆勢時發生。 (繼承來源 UIElement) |
| StylusUp |
手寫筆在此項目上方，且使用者將手寫筆舉起離開數位板時發生。 (繼承來源 UIElement) |
| TargetUpdated |
這個項目上的任何屬性繫結的目標值變更時發生。 (繼承來源 FrameworkElement) |
| TextInput |
此元素以一種與裝置無關的方式取得文字時發生。 (繼承來源 UIElement) |
| ToolTipClosing |
在項目上的任何工具提示正要關閉之前發生。 (繼承來源 FrameworkElement) |
| ToolTipOpening |
任何元素的工具提示開啟時發生。 (繼承來源 FrameworkElement) |
| TouchDown |
手指在這個項目上方且在螢幕上觸控時發生。 (繼承來源 UIElement) |
| TouchEnter |
當觸控從這個項目的界限外部移至內部時發生。 (繼承來源 UIElement) |
| TouchLeave |
當觸控從這個項目的界限內部移至外部時發生。 (繼承來源 UIElement) |
| TouchMove |
手指在這個項目上方且在螢幕上移動時發生。 (繼承來源 UIElement) |
| TouchUp |
手指在這個項目上方且離開螢幕時發生。 (繼承來源 UIElement) |
| Unloaded |
當項目從已載入項目的項目樹狀結構中移除時發生。 (繼承來源 FrameworkElement) |
明確介面實作
| IAddChild.AddChild(Object) |
此成員支援Windows Presentation Foundation (WPF) 基礎結構，而且不適合直接從程式碼使用。 (繼承來源 ItemsControl) |
| IAddChild.AddText(String) |
此成員支援Windows Presentation Foundation (WPF) 基礎結構，而且不適合直接從程式碼使用。 (繼承來源 ItemsControl) |
| IContainItemStorage.Clear() |
清除所有屬性關聯性。 (繼承來源 ItemsControl) |
| IContainItemStorage.ClearItemValue(Object, DependencyProperty) |
移除指定項目和屬性之間的關聯性。 (繼承來源 ItemsControl) |
| IContainItemStorage.ClearValue(DependencyProperty) |
從所有屬性清單中移除指定的屬性。 (繼承來源 ItemsControl) |
| IContainItemStorage.ReadItemValue(Object, DependencyProperty) |
傳回與指定的項目相關聯的指定的屬性其值。 (繼承來源 ItemsControl) |
| IContainItemStorage.StoreItemValue(Object, DependencyProperty, Object) |
儲存指定的屬性和值，並與指定的項目產生關聯。 (繼承來源 ItemsControl) |
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
如需這個成員的描述，請參閱 IsAmbientPropertyAvailable(String) 方法。 (繼承來源 FrameworkElement) |
