この記事は翻訳者によって翻訳されたものです。 記事の文章にポインターを重ねると、原文のテキストが表示されます。 |
訳文
原文
|
ListBox クラス
選択可能な項目の一覧が表示されます。
名前空間: System.Windows.Controls
アセンブリ : System.Windows (System.Windows.dll 内)
[TemplateVisualStateAttribute(Name = "InvalidFocused", GroupName = "ValidationStates")] [TemplatePartAttribute(Name = "ScrollViewer", Type = typeof(ScrollViewer))] [TemplateVisualStateAttribute(Name = "InvalidUnfocused", GroupName = "ValidationStates")] [TemplateVisualStateAttribute(Name = "Valid", GroupName = "ValidationStates")] public class ListBox : Selector
<ListBox .../>
ListBox 型で公開されるメンバーは以下のとおりです。
| 名前 | 説明 | |
|---|---|---|
|
ActualHeight | FrameworkElement の描画時の高さを取得します。 (FrameworkElement から継承されます。) |
|
ActualWidth | FrameworkElement の描画時の幅を取得します。 (FrameworkElement から継承されます。) |
|
AllowDrop | この UIElement を Silverlight でのドラッグ アンド ドロップ操作の対象として使用できるかどうかを判断する値を取得または設定します。 (UIElement から継承されます。) |
|
Background | コントロールの背景を提供するブラシを取得または設定します。 (Control から継承されます。) |
|
BorderBrush | コントロールの境界線の背景を表すブラシを取得または設定します。 (Control から継承されます。) |
|
BorderThickness | コントロールの境界線の太さを取得または設定します。 (Control から継承されます。) |
|
CacheMode | レンダリングされたコンテンツを可能な場合にキャッシュするように指示する値を取得または設定します。 (UIElement から継承されます。) |
|
CharacterSpacing | フォント サイズの 1,000 分の 1 の単位で計測される、コントロール内のテキストの文字間の距離を取得または設定します。 (Control から継承されます。) |
|
Clip | UIElement のコンテンツのアウトラインの定義に使用する Geometry を取得または設定します。 (UIElement から継承されます。) |
|
Cursor | マウス ポインターが FrameworkElement の上にあるときに表示されるカーソル イメージを取得または設定します。 (FrameworkElement から継承されます。) |
|
DataContext | FrameworkElement がデータ バインディングに関与するときにそのデータ コンテキストを取得または設定します。 (FrameworkElement から継承されます。) |
|
DefaultStyleKey | コントロールの既定のスタイルを参照するキーを取得または設定します。 (Control から継承されます。) |
|
DesiredSize | レイアウト処理の測定パスの実行中にこの UIElement が計算したサイズを取得します。 (UIElement から継承されます。) |
|
Dispatcher | このオブジェクトに関連付けられている Dispatcher を取得します。 (DependencyObject から継承されます。) |
|
DisplayMemberPath | 各データ項目で表示されるプロパティの名前またはパスを取得または設定します。 (ItemsControl から継承されます。) |
|
Effect | この UIElement のレンダリングに使用されるピクセル シェーダー効果を取得または設定します。 (UIElement から継承されます。) |
|
FlowDirection | レイアウトを制御する親要素内でのテキストやその他のユーザー インターフェイス要素のフロー方向を取得または設定します。 (FrameworkElement から継承されます。) |
|
FontFamily | コントロール内にテキストを表示するために使用されるフォントを取得または設定します。 (Control から継承されます。) |
|
FontSize | このコントロール内のテキストのサイズを取得または設定します。 (Control から継承されます。) |
|
FontStretch | 画面上でフォントを縮小または拡大する度合いを取得または設定します。 (Control から継承されます。) |
|
FontStyle | 描画されるテキストのスタイルを取得または設定します。 (Control から継承されます。) |
|
FontWeight | 指定したフォントの太さを取得または設定します。 (Control から継承されます。) |
|
Foreground | 前景色を表すブラシを取得または設定します。 (Control から継承されます。) |
|
HasItems | Selector に項目が含まれるかどうかを取得します。 (Selector から継承されます。) |
|
Height | FrameworkElement の高さの推奨値を取得または設定します。 (FrameworkElement から継承されます。) |
|
HorizontalAlignment | FrameworkElement がレイアウトの親 (パネル コントロールや項目コントロールなど) の一部となる場合に適用される水平方向の配置の特性を取得または設定します。 (FrameworkElement から継承されます。) |
|
HorizontalContentAlignment | コントロールのコンテンツの水平方向の配置を取得または設定します。 (Control から継承されます。) |
|
IsEnabled | ユーザーがコントロールを操作できるかどうかを示す値を取得または設定します。 (Control から継承されます。) |
|
IsHitTestVisible | この UIElement が含まれる領域が、ヒット テストに対して true 値を返すかどうかを示す値を取得または設定します。 (UIElement から継承されます。) |
|
IsSynchronizedWithCurrentItem | Selector で SelectedItem を Items プロパティの現在の項目と同期するかどうかを示す値を取得または設定します。 (Selector から継承されます。) |
|
IsTabStop | コントロールがタブ ナビゲーションに含まれるかどうかを示す値を取得または設定します。 (Control から継承されます。) |
|
ItemContainerGenerator | この ItemsControl に関連付けられている ItemContainerGenerator を取得します。 (ItemsControl から継承されます。) |
|
ItemContainerStyle | 項目コンテナーを表示するときに使用するスタイルを取得または設定します。 |
|
Items | コントロールのコンテンツの生成に使用するコレクションを取得します。 (ItemsControl から継承されます。) |
|
ItemsPanel | 項目のレイアウトを制御するパネルを定義するテンプレートを取得または設定します。 (ItemsControl から継承されます。) |
|
ItemsSource | ItemsControl のコンテンツの生成に使用するコレクションを取得または設定します。 (ItemsControl から継承されます。) |
|
ItemTemplate | 各項目を表示するために使用する DataTemplate を取得または設定します。 (ItemsControl から継承されます。) |
|
Language | FrameworkElement に適用されるローカリゼーション/グローバリゼーション言語情報を取得または設定します。 (FrameworkElement から継承されます。) |
|
Margin | FrameworkElement の外側の余白を取得または設定します。 (FrameworkElement から継承されます。) |
|
MaxHeight | FrameworkElement の高さの上限を取得または設定します。 (FrameworkElement から継承されます。) |
|
MaxWidth | FrameworkElement の幅の上限を取得または設定します。 (FrameworkElement から継承されます。) |
|
MinHeight | FrameworkElement の高さの下限を取得または設定します。 (FrameworkElement から継承されます。) |
|
MinWidth | FrameworkElement の幅の下限を取得または設定します。 (FrameworkElement から継承されます。) |
|
Name | オブジェクトの識別名を取得または設定します。 XAML プロセッサが XAML マークアップからオブジェクト ツリーを作成するとき、実行時のコードからこの名前で、XAML で宣言されたオブジェクトを参照できます。 (FrameworkElement から継承されます。) |
|
Opacity | オブジェクトの不透明度を取得または設定します。 (UIElement から継承されます。) |
|
OpacityMask | このオブジェクトの領域の不透明度を変更する場合に使用するブラシを取得または設定します。 (UIElement から継承されます。) |
|
Padding | コントロール内のスペースを取得または設定します。 (Control から継承されます。) |
|
Parent | オブジェクト ツリーにおけるこの FrameworkElement の親オブジェクトを取得します。 (FrameworkElement から継承されます。) |
|
Projection | UIElement のレンダリング時に適用されるパースペクティブ射影 (3-D 効果) を取得または設定します。 (UIElement から継承されます。) |
|
RenderSize | UIElement の最終的な描画サイズを取得します。 (UIElement から継承されます。) |
|
RenderTransform | UIElement の描画位置に影響する変換情報を取得または設定します。 (UIElement から継承されます。) |
|
RenderTransformOrigin | RenderTransform によって宣言された任意の描画変換の、UIElement の境界に対する原点を取得または設定します。 (UIElement から継承されます。) |
|
Resources | ローカルで定義されたリソース ディクショナリを取得します。 XAML では、XAML の暗黙的なコレクション構文を使用して、frameworkElement.Resources プロパティ要素の子オブジェクト要素としてリソース項目を設定できます。 (FrameworkElement から継承されます。) |
|
SelectedIndex | 選択された項目のインデックスを取得または設定します。 (Selector から継承されます。) |
|
SelectedItem | 選択された項目を取得または設定します。 (Selector から継承されます。) |
|
SelectedItems | ListBox コントロールの現在選択されている項目の一覧を取得します。 |
|
SelectedValue | SelectedValuePath を使用して取得される、選択されている項目の値を取得または設定します。 (Selector から継承されます。) |
|
SelectedValuePath | SelectedItem プロパティの SelectedValue プロパティを取得するために使用されるプロパティ パスを取得または設定します。 (Selector から継承されます。) |
|
SelectionMode | ListBox コントロールの選択動作を取得または設定します。 |
|
Style | レンダリング中にこのオブジェクトに適用される Style インスタンスを取得または設定します。 (FrameworkElement から継承されます。) |
|
TabIndex | ユーザーが Tab キーを使用してコントロール間を移動するときに、要素がフォーカスを受け取る順序を決定する値を取得または設定します (Control から継承されます。) |
|
TabNavigation | このコントロールにおける Tab キーによる移動と TabIndex の動作を変更する値を取得または設定します。 (Control から継承されます。) |
|
Tag | オブジェクトに関するカスタム情報を格納するために使用できる任意のオブジェクト値を取得または設定します。 (FrameworkElement から継承されます。) |
|
Template | コントロール テンプレートを取得または設定します。 (Control から継承されます。) |
|
Triggers | FrameworkElement に対して定義されたアニメーションのトリガーのコレクションを取得します。 (FrameworkElement から継承されます。) |
|
UseLayoutRounding | オブジェクトとそのビジュアル サブツリーの描画で、描画をピクセル単位に揃える丸め処理を使用するかどうかを決定する値を取得または設定します。 (UIElement から継承されます。) |
|
VerticalAlignment | FrameworkElement が親オブジェクト (パネル コントロールや項目コントロールなど) の一部となる場合に適用される垂直方向の配置の特性を取得または設定します。 (FrameworkElement から継承されます。) |
|
VerticalContentAlignment | コントロールのコンテンツの垂直方向の配置を取得または設定します。 (Control から継承されます。) |
|
Visibility | UIElement の可視性を取得または設定します。 表示されない UIElement は描画されず、レイアウトに対して必要サイズも伝達されません。 (UIElement から継承されます。) |
|
Width | FrameworkElement の幅を取得または設定します。 (FrameworkElement から継承されます。) |
| 名前 | 説明 | |
|---|---|---|
|
AddHandler | 指定したルーティング イベントのルーティング イベント ハンドラーを、現在の要素のハンドラー コレクションに追加します。 イベント ルート上の他の要素により既に処理済みとしてマークされているルーティング イベントに対し、指定したハンドラーが呼び出されるようにするには、handledEventsToo を true に指定します。 (UIElement から継承されます。) |
|
ApplyTemplate | 関連するコントロール テンプレートを読み込み、その各部を参照できるようにします。 (Control から継承されます。) |
|
Arrange | 子オブジェクトを配置し、UIElement のサイズを決定します。 子要素に対してカスタム レイアウトを実装する親オブジェクトは、それらのレイアウトのオーバーライド実装からこのメソッドを呼び出し、レイアウトを再帰的に更新する必要があります。 (UIElement から継承されます。) |
|
ArrangeOverride | Silverlight レイアウトの配置パスの動作を提供します。 クラスはこのメソッドをオーバーライドして、独自の配置パス動作を定義できます。 (FrameworkElement から継承されます。) |
|
CaptureMouse | UIElement にマウス キャプチャを設定します。 (UIElement から継承されます。) |
|
CheckAccess | 呼び出し元のスレッドがこのオブジェクトにアクセスできるかどうかを確認します。 (DependencyObject から継承されます。) |
|
ClearContainerForItemOverride | 指定されたコンテンツの項目コンテナーに適用されたバインディングとテンプレートをすべて削除します。 (Selector から継承されます。) |
|
ClearValue | 依存関係プロパティのローカル値をクリアします。 (DependencyObject から継承されます。) |
|
Equals(Object) | 指定した Object が、現在の Object と等しいかどうかを判断します。 (Object から継承されます。) |
|
Finalize | Object がガベージ コレクションにより収集される前に、オブジェクトがリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
|
FindName | 指定した識別名を持つオブジェクトを取得します。 (FrameworkElement から継承されます。) |
|
Focus | コントロールにフォーカスを設定することを試みます。 (Control から継承されます。) |
|
GetAnimationBaseValue | アニメーションがアクティブでない場合に適用される、Silverlight 依存関係プロパティに対し設定されている基本値を返します。 (DependencyObject から継承されます。) |
|
GetBindingExpression | バインディングが確立された依存関係プロパティの BindingExpression を取得します。 (FrameworkElement から継承されます。) |
|
GetContainerForItemOverride | 指定された項目の表示に使用する要素を作成または識別します。 (ItemsControl.GetContainerForItemOverride() をオーバーライドします。) |
|
GetHashCode | 特定の型のハッシュ関数として機能します。 (Object から継承されます。) |
|
GetTemplateChild | インスタンス化されている ControlTemplate ビジュアル ツリー内の名前付き要素を取得します。 (Control から継承されます。) |
|
GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
|
GetValue | DependencyObject から依存関係プロパティの現在の有効値を返します。 (DependencyObject から継承されます。) |
|
InvalidateArrange | UIElement の配置状態 (レイアウト) を無効にします。 無効にした後、UIElement のレイアウトが更新されます。更新は非同期に行われます。 (UIElement から継承されます。) |
|
InvalidateMeasure | UIElement の測定状態 (レイアウト) を無効にします。 (UIElement から継承されます。) |
|
IsItemItsOwnContainerOverride | 指定された項目が自身の項目コンテナーかどうか (または自身の項目コンテナーにすることができるかどうか) を判断します。 (ItemsControl.IsItemItsOwnContainerOverride(Object) をオーバーライドします。) |
|
Measure | UIElement の DesiredSize を更新します。 通常、レイアウトの子のカスタム レイアウトを実装するオブジェクトは、独自の MeasureOverride 実装からこのメソッドを呼び出し、レイアウトを再帰的に更新します。 (UIElement から継承されます。) |
|
MeasureOverride | Silverlight レイアウトの測定パスの動作を提供します。 クラスはこのメソッドをオーバーライドして、独自の測定パス動作を定義できます。 (FrameworkElement から継承されます。) |
|
MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |
|
OnApplyTemplate | 新しいテンプレートが適用されたときに、ListBox コントロールのビジュアル ツリーを構築します。 (Selector.OnApplyTemplate() をオーバーライドします。) |
|
OnCreateAutomationPeer | Silverlight オートメーション インフラストラクチャの ListBoxAutomationPeer を返します。 (UIElement.OnCreateAutomationPeer() をオーバーライドします。) |
|
OnDoubleTap | DoubleTap イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnDragEnter | DragEnter イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnDragLeave | DragLeave イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnDragOver | DragOver イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnDrop | Drop イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnGotFocus | GotFocus イベントに対する処理を提供します。 (Control.OnGotFocus(RoutedEventArgs) をオーバーライドします。) |
|
OnHold | Hold イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnItemsChanged | ItemsChanged イベントに対する処理を提供します。 (Selector.OnItemsChanged(NotifyCollectionChangedEventArgs) をオーバーライドします。) |
|
OnKeyDown | このコントロールにフォーカスがある状態でキーを押したときに発生する KeyDown イベントの処理を提供します。 (Control.OnKeyDown(KeyEventArgs) をオーバーライドします。) |
|
OnKeyUp | KeyUp イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnLostFocus | LostFocus イベントに対する処理を提供します。 (Control.OnLostFocus(RoutedEventArgs) をオーバーライドします。) |
|
OnLostMouseCapture | LostMouseCapture イベントが発生する前に呼び出され、デリゲートをアタッチせずに、派生クラスでイベントを処理します。 (Control から継承されます。) |
|
OnManipulationCompleted | ManipulationCompleted イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnManipulationDelta | ManipulationDelta イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnManipulationStarted | ManipulationStarted イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnMouseEnter | MouseEnter イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnMouseLeave | MouseLeave イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnMouseLeftButtonDown | MouseLeftButtonDown イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnMouseLeftButtonUp | MouseLeftButtonUp イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnMouseMove | MouseMove イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnMouseRightButtonDown | MouseRightButtonDown イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnMouseRightButtonUp | MouseRightButtonUp イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnMouseWheel | MouseWheel イベントが発生する前に呼び出され、デリゲートをアタッチせずに、派生クラスでイベントを処理します。 (Control から継承されます。) |
|
OnTap | Tap イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnTextInput |
TextInput イベントが発生する前に呼び出されます。
(ItemsControl から継承されます。) Silverlight for Windows Phone Windows Phone OS 7.1では、このメンバーは Control.OnTextInput(TextCompositionEventArgs) から継承されています。 |
|
OnTextInputStart | TextInputStart イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
OnTextInputUpdate | TextInputUpdate イベントが発生する前に呼び出されます。 (Control から継承されます。) |
|
PrepareContainerForItemOverride | 指定された項目を表示するために、指定された要素を準備します。 (Selector から継承されます。) |
|
ReadLocalValue | ローカル値が設定されている場合、依存関係プロパティのローカル値を返します。 (DependencyObject から継承されます。) |
|
ReleaseMouseCapture | UIElement からマウス キャプチャを削除します。 この呼び出しの後には、通常、マウス キャプチャを保持しているオブジェクトがなくなります。 (UIElement から継承されます。) |
|
RemoveHandler | 指定したルーティング イベント ハンドラーをこの UIElement から削除します。 (UIElement から継承されます。) |
|
ScrollIntoView | オブジェクトをスクロールして表示します。 |
|
SelectAll | ListBox 内のすべての項目を選択します。 |
|
SetBinding | 指定されたバインディング オブジェクトを使用して FrameworkElement にバインディングをアタッチし、後で使用できるように BindingExpressionBase を返します。 (FrameworkElement から継承されます。) |
|
SetValue | DependencyObject で依存関係プロパティのローカル値を設定します。 (DependencyObject から継承されます。) |
|
ToString | 現在のオブジェクトを表す文字列を返します。 (Object から継承されます。) |
|
TransformToVisual | UIElement から指定したオブジェクトに座標を変換するために使用できる変換オブジェクトを返します。 (UIElement から継承されます。) |
|
UpdateLayout | UIElement の子オブジェクトのすべての位置がレイアウトに対して適切に更新されるようにします。 (UIElement から継承されます。) |
| 名前 | 説明 | |
|---|---|---|
|
BindingValidationError | バインディング ソースによってデータの妥当性確認エラーが報告されたときに発生します。 (FrameworkElement から継承されます。) |
|
DataContextChanged | この要素のデータ コンテキストが変更されたときに発生します。 (FrameworkElement から継承されます。) |
|
DoubleTap | この UIElement 上で DoubleTap ジェスチャが実行されると発生します。 (UIElement から継承されます。) |
|
DragEnter | この要素をドラッグ先とする、基になるドラッグ イベントが入力システムによって報告されたときに発生します。 (UIElement から継承されます。) |
|
DragLeave | この要素をドラッグ元とする、基になるドラッグ イベントが入力システムによって報告されたときに発生します。 (UIElement から継承されます。) |
|
DragOver | この要素をドロップ先の候補とする、基になるドラッグ イベントが入力システムによって報告されたときに発生します。 (UIElement から継承されます。) |
|
Drop | この要素をドロップ先とする、基になるドロップ イベントが入力システムによって報告されたときに発生します。 (UIElement から継承されます。) |
|
GotFocus | UIElement がフォーカスを受け取ったときに発生します。 (UIElement から継承されます。) |
|
Hold | この UIElement 上で Hold ジェスチャが実行されると発生します。 (UIElement から継承されます。) |
|
IsEnabledChanged | IsEnabled プロパティが変更された場合に発生します。 (Control から継承されます。) |
|
KeyDown | UIElement にフォーカスがあるときにキーボード キーが押されると発生します。 (UIElement から継承されます。) |
|
KeyUp | UIElement にフォーカスがあるときにキーボード キーが離されると発生します。 (UIElement から継承されます。) |
|
LayoutUpdated | Silverlight のビジュアル ツリーのレイアウトが変化したときに発生します。 (FrameworkElement から継承されます。) |
|
Loaded | FrameworkElement が構築されてオブジェクト ツリーに追加されたときに発生します。 (FrameworkElement から継承されます。) |
|
LostFocus | UIElement がフォーカスを失ったときに発生します。 (UIElement から継承されます。) |
|
LostMouseCapture | UIElement でマウスのキャプチャがなくなると発生します。 (UIElement から継承されます。) |
|
ManipulationCompleted | UIElement の操作および慣性による処理が完了すると発生します。 (UIElement から継承されます。) |
|
ManipulationDelta | 操作中に入力デバイスが位置を変更したときに発生します。 (UIElement から継承されます。) |
|
ManipulationStarted | 入力デバイスで UIElement の操作を開始すると発生します。 (UIElement から継承されます。) |
|
MediaCommand | リモコンのボタンを押すと発生します。 (UIElement から継承されます。) |
|
MouseEnter | マウス (またはスタイラス) が UIElement の境界領域に入ったときに発生します。 (UIElement から継承されます。) |
|
MouseLeave | マウス (またはスタイラス) が UIElement の境界領域を出たときに発生します。 (UIElement から継承されます。) |
|
MouseLeftButtonDown | マウス ポインターが UIElement の上にあるときにマウスの左ボタンが押されると (またはスタイラスの先端がタブレットに触れると) 発生します。 (UIElement から継承されます。) |
|
MouseLeftButtonUp | マウス (またはスタイラス) が UIElement の上にあるときに (または UIElement がマウス キャプチャを保持しているときに) マウスの左ボタンが離されると (またはスタイラスの先端がタブレットから離れると) 発生します。 (UIElement から継承されます。) |
|
MouseMove | マウス (またはスタイラス) が UIElement の上にあるときに (または UIElement がマウス キャプチャを保持しているときに) その座標位置が変更されると発生します。 (UIElement から継承されます。) |
|
MouseRightButtonDown | マウス ポインターが UIElement の上にあるときにマウスの右ボタンが押されると発生します。 (UIElement から継承されます。) |
|
MouseRightButtonUp | マウス ポインターが UIElement の上にあるときにマウスの右ボタンが離されると発生します。 ただし、このイベントが発生するのは、呼び出し元が前の MouseRightButtonDown イベントを処理済みとしてマークした場合のみです。詳細については、「解説」を参照してください。 (UIElement から継承されます。) |
|
MouseWheel | マウス ポインターが UIElement 上にあるとき、または UIElement にフォーカスがあるときに、ユーザーがマウス ホイールを回転させると発生します。 (UIElement から継承されます。) |
|
SelectionChanged | 現在選択されている項目が変更されたときに発生します。 (Selector から継承されます。) |
|
SizeChanged | FrameworkElement の ActualHeight プロパティまたは ActualWidth プロパティの値が変更されると発生します。 (FrameworkElement から継承されます。) |
|
Tap | この UIElement 上で Tap ジェスチャが実行されると発生します。 (UIElement から継承されます。) |
|
TextInput | デバイスに依存しない方法で UI 要素がテキストを取得すると発生します。 (UIElement から継承されます。) |
|
TextInputStart | デバイスに依存しない方法で UI 要素が最初にテキストを取得すると発生します。 (UIElement から継承されます。) |
|
TextInputUpdate | 入力方式エディター (IME) を使用してテキストが引き続き構成されると発生します。 (UIElement から継承されます。) |
|
Unloaded | このオブジェクトがメイン オブジェクト ツリーから接続解除されたときに発生します。 (FrameworkElement から継承されます。) |
| 名前 | 説明 | |
|---|---|---|
|
IsSelectionActiveProperty | IsSelectionActive 依存関係プロパティを識別します。 |
|
ItemContainerStyleProperty | ItemContainerStyle 依存関係プロパティを識別します。 |
|
SelectionModeProperty | SelectionMode 依存関係プロパティを識別します。 |
| 名前 | 説明 | |
|---|---|---|
|
ISupportInitialize.BeginInit | 初期化の開始を通知するシグナルをオブジェクトに送信します。 (Selector から継承されます。) |
|
ISupportInitialize.EndInit | 初期化の完了を通知するシグナルをオブジェクトに送信します。 (Selector から継承されます。) |
ListBox は、項目のコレクションを表示するコントロールです。 ListBox には一度に複数の項目が表示されます。 ListBox で複数の項目の選択を可能にするかどうかを指定するには、SelectionMode プロパティを使用します。
ListBox は ItemsControl です。 コンテンツは、Items プロパティまたは ItemsSource プロパティを使用して設定します。 コンテンツ モデルの詳細については、「コントロール コンテンツ モデル」を参照してください。 ListBox コントロールに値を直接設定することも、項目のコレクションにバインドすることもできます。 ListBox に値を設定する方法の詳細については、「方法 : ListBox にデータを表示する」を参照してください。
バインドされていないいくつかのテキスト項目を含む ListBox コントロールを、次の図に示します。
ListBox コントロールのカスタマイズ
同じプロパティ設定を複数の ListBox コントロールに適用するには、Style プロパティを使用します。 ListBox に表示される各項目のスタイルは、ItemContainerStyle プロパティを設定することで適用できます。 ListBox の視覚的な構造および視覚的な動作を変更するには、既定のスタイルおよびテンプレートをコピーし、変更します。 詳細については、コントロールのカスタマイズ のトピックを参照してください。
このコントロールの依存関係プロパティは、コントロールの既定のスタイルによって設定される場合があります。 ListBox の依存関係プロパティが既定のスタイルで設定されている場合、アプリケーション内で ListBox が表示されたときにプロパティが既定値から変更される場合があります。 詳細については、依存関係プロパティ値の優先順位 のトピックを参照してください。 ListBox の既定のスタイルおよびテンプレートを取得する方法については、「ListBox のスタイルとテンプレート」を参照してください。
メモ :
|
|---|
|
設定した視覚的プロパティが ListBox コントロールの既定のテンプレートに存在し、TemplateBinding を使用して設定されている場合にのみ、プロパティの効果が得られます。 視覚的プロパティの一覧については、「ControlTemplate を使用した既存のコントロールの外観のカスタマイズ」の「コントロールの視覚的な構造の変更」を参照してください。 |
バージョンについてのメモ
Silverlight for Windows Phone
Windows Phone OS 7.1 では、ListBox コントロールのスクロールのパフォーマンスが改善されています。これは、一部の ScrollViewer プロパティの更新方法とイベントが発生するタイミングに影響します。 Windows Phone OS 7.0 および Windows Phone OS 7.1 での動作の相違を次の表に示します。
動作 | Windows Phone OS 7.0 app/Windows Phone OS 7.0 デバイス | Windows Phone OS 7.0 または Windows Phone OS 7.1 app/Windows Phone OS 7.1 デバイス |
|---|---|---|
ScrollViewer プロパティは、UI スレッドでスクロール中に更新されます。 | プロパティは、値が変更されるとすぐに更新されます。 | プロパティは、ユーザーが指を離したとき、またはユーザーが画面の ¼ を任意の方向にドラッグ、パン、またはフリックしたときに更新されます。 |
ScrollViewer 内でのドラッグ中に UI スレッドで発生した ManipulationDelta イベント。 | イベントは、ScrollViewer で要素によって処理できます。 | これらは入力スレッドにあるため、イベントは発生しません。 |
アプリケーションが Windows Phone OS 7.0 動作に依存している場合は、ListBox に関連付けられている ScrollViewer で ManipulationMode プロパティを Control に設定することで、パフォーマンスの向上を無効にすることができます。 その方法を次のコード例に示します。
<ListBox ItemsSource="{Binding Items}" ScrollViewer.ManipulationMode ="Control" Height="652" Canvas.Top="80">
複数の ListBox コントロールがさまざまな方法で構成されたページを作成するコード例を、次に示します。
<UserControlx:Class="ListBoxSnippetEx.Page"xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"xmlns:src="clr-namespace:ListBoxSnippetEx"><StackPanelx:Name="LayoutRoot"Background="White"Margin="10,10,10,10"><StackPanelOrientation="Horizontal"><TextBlockMargin="5"Text="ListBox with unbound data:"/><ListBoxWidth="150"Margin="0,5,0,10"><TextBlockText="TextBlock"/><TextBoxText="TextBox"/><ButtonContent="Button"/><RectangleFill="LightBlue"Height="20"Width="100"Margin="2,2,2,2"/><EllipseFill="Coral"Height="20"Width="150"Margin="2,2,2,2"/></ListBox><TextBlockMargin="5"Text="ListBox with bound data:"/><Grid><Grid.Resources><src:Customersx:Key="customers"/></Grid.Resources><ListBoxItemsSource="{StaticResource customers}"Width="250"Margin="0,5,0,10"DisplayMemberPath="LastName"/></Grid></StackPanel><StackPanelOrientation="Horizontal"><TextBlockMargin="5"Text="ListBox with ItemTemplate:"Width="160"/><Grid><Grid.Resources><src:Customersx:Key="customers"/></Grid.Resources><ListBoxItemsSource="{StaticResource customers}"Width="350"Margin="0,5,0,10"><ListBox.ItemTemplate><DataTemplate><StackPanelOrientation="Horizontal"><TextBlockPadding="5,0,5,0"Text="{Binding FirstName}"/><TextBlockText="{Binding LastName}"/><TextBlockText=", "/><TextBlockText="{Binding Address}"/></StackPanel></DataTemplate></ListBox.ItemTemplate></ListBox></Grid><Grid><Grid.Resources><Stylex:Key="horizontalListBoxStyle"TargetType="ListBox"><SetterProperty="ItemsPanel"><Setter.Value><ItemsPanelTemplate><StackPanelOrientation="Horizontal"VerticalAlignment="Center"HorizontalAlignment="Center"/></ItemsPanelTemplate></Setter.Value></Setter><SetterProperty="ItemTemplate"><Setter.Value><DataTemplate><StackPanelOrientation="Horizontal"><TextBlockPadding="5,0,5,0"Text="{Binding FirstName}"/><TextBlockText="{Binding LastName}"/></StackPanel></DataTemplate></Setter.Value></Setter></Style><src:Customersx:Key="items"/></Grid.Resources><ListBoxHeight="25"Width="420"ItemsSource="{StaticResource items}"Style="{StaticResource horizontalListBoxStyle}"/></Grid></StackPanel><TextBlockMargin="5"Text="ListBox with SelectionChanged event handler:"Width="270"HorizontalAlignment="Left"/><ListBoxWidth="150"Margin="0,5,0,5"SelectionChanged="PrintText"HorizontalAlignment="Left"><ListBoxItemContent="Item 1"/><ListBoxItemContent="Item 2"/><ListBoxItemContent="Item 3"/><ListBoxItemContent="Item 4"/><ListBoxItemContent="Item 5"/></ListBox><TextBlockName="textBlock1"/></StackPanel></UserControl>
using System; using System.Windows; using System.Windows.Controls; using System.Windows.Documents; using System.Windows.Ink; using System.Windows.Input; using System.Windows.Media; using System.Windows.Media.Animation; using System.Windows.Shapes; using System.Collections.ObjectModel; namespace ListBoxSnippetEx { publicpartialclass Page : UserControl { public Page() { // Required to initialize variables InitializeComponent(); } void PrintText(object sender, SelectionChangedEventArgs args) { ListBoxItem lbi = ((sender as ListBox).SelectedItem as ListBoxItem); textBlock1.Text = " You selected " + lbi.Content.ToString() + "."; } } publicclass Customer { public String FirstName { get; set; } public String LastName { get; set; } public String Address { get; set; } public Customer(String firstName, String lastName, String address) { this.FirstName = firstName; this.LastName = lastName; this.Address = address; } } publicclass Customers : ObservableCollection<Customer> { public Customers() { Add(new Customer("Michael", "Anderberg", "12 North Third Street, Apartment 45")); Add(new Customer("Chris", "Ashton", "34 West Fifth Street, Apartment 67")); Add(new Customer("Cassie", "Hicks", "56 East Seventh Street, Apartment 89")); Add(new Customer("Guido", "Pica", "78 South Ninth Street, Apartment 10")); } } }
Silverlight でサポートされるオペレーティング システムの詳細については、「サポートされているオペレーティング システムとブラウザー」を参照してください。
メモ :