mikeo_410

 Popup

  Popupクラスは、ContextMenuの親のクラスで、Windowの挙動はContextMenuと同じ。たとえば、Windowの外をクリックすると受動的に閉じられます。
  使い道の広いWindowです。
  HTMLエディタを作るにあたって、ColorPicker と HTMLソース編集のタグ選択を作りました。

１．Popupの使い方

１．１．使用する名前空間

  Popup は、System.Windows.Controls.Primitives にあります。必要になる宣言は下記です。

1. using System.Windows;
2. using System.Windows.Shapes;
3. using System.Windows.Media;
4. using System.Windows.Input;
5. using System.Windows.Documents;
6. using System.Windows.Controls;
7. using System.Windows.Controls.Primitives;

１．２．例

  Popupを継承したクラスPopup1を作ります。このインスタンスpopup1を生成し、IsOpenプロパティを true に設定すれば表示されます。
  popup1の表示領域外をクリックすれば自動的に閉じられます。

1. //Popup ウインドウのサンプル
2. public class Popup1 : Popup
3. {
4.     protected override void OnOpened(EventArgs e)
5.     {
6.         base.OnOpened(e);
8.         TextBlock tb = new TextBlock();
9.         tb.Text="Popupのテスト";
10.         tb.Background = Brushes.Magenta;
11.         Child = tb;
12.         Debug.WriteLine(Placement);
13.     }
14. }
15. Popup1 popup1 = new Popup1();
16. //左ボタン押下でpopup1を開く
17. private void tblock1_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)
18. {
19.     //以下の挙動の設定は、Popup1クラスのOnOpened()などで行えば設定漏れを防げる
20.     popup1.StaysOpen = false;
21.     popup1.PlacementTarget = tblock1;
22.     popup1.Placement = PlacementMode.MousePoint;
24.     popup1.IsOpen = true;
25. }

１．３．StayOpen

  デフォルトでは、StayOpenプロパティは true であるらしく、下図のような動作になります。
  このような使い方が有効な例は思いつきません。

１．TextBlockにPopupウインドウを表示	２．本体が他の窓に隠れてもPopupウインドウは最前面に残る

１．４．開く位置の設定方法

  下表のようです。
  Placement のデフォルトは PlacementMode.Bottom のようです。 
  ところが、デフォルトでの表示は、モニタ画面の左上隅になります。PlacementTarget を指定しないと、作成したプログラムのウインドウとは無関係に表示されるので、表示されていないと誤解してしまいます。Bottom なのに上隅になるのは、全画面の下にPopupを付ける指定なので、折り返されていると解釈しました。

表。Popupの表示位置の設定

Placement	PlacementTarget	HorizontalOffset  VerticalOffset	表示位置
Top  Bottom  Center  Left  Right	基準となるWindow	-	PlacementTargetに対して指定位置
Mouse	-	-	マウスポインタの位置
MousePoint	-	マウスポインタからの相対座標	マウスポインタの位置に、HorizontalOffset、VerticalOffsetを加算
Absolute  AbsolutePoint	-	モニタの左上隅を原点とした絶対的な座標	HorizontalOffset、VerticalOffsetが示す位置
Relative  RelativePoint	基準となるWindow	PlacementTargetに対する相対座標	PlacementTargetに対して、HorizontalOffset、VerticalOffsetを加算

※AbsoluteとAbsolutePoint、RelativeとRelativePointの違いは、Popupが画面からはみ出すときの描画の仕方にあるようだが良くわからない。

２．ColorPicker の例

  「文字の色」「背景色」のボタンを作って配置しました。このボタンは、文字列と色見本がキートップになっています。
  ボタンがクリックされると、色見本（ColorPicker）を表示します。Placement に、PlacementMode.Buttom を、PlacementTargetにボタンを設定します。これによって、クリックしたボタンの直下に色見本が開きます。
  閉じるのは、色を選択して「OK」をクリックするか、別なボタンのクリックなど領域外の事象発生で行われます。

３．タグ選択の例

  HTMLをソースで編集する場合のタグ入力補助機能を作りました。HTTMLのソースを表示しているRichTextBoxと連動して動きます。

1. '<'を押すと、タグ選択が開きます。
2. 文字を入力するごとに、それまで入力した部分が一致するものを選択してListBoxを更新していきます。
3. 入力された文字は逐次RichTextBoxに反映します。
4. エンターキーかダブルクリックでListBoxの選択項目を、RichTextBoxに貼り付けます。（当然既に表示している部分を除いて）

３．１．どこに窓を開くか

  通常は、マウスポインタの位置に表示されるか、きっかけになったボタンなどのコントロールの近傍に表示されるので問題を感じません。
  しかし、これは、'<'キーを押したときに開くので、意味的にマウスはまったく関係ありません。
  キャレットの表示位置に表示する必要があります。

1. protected override void OnOpened(EventArgs e)
2. {
3.     //標示位置をキャレットから決めて、設定する
4.     StaysOpen = false;
5.     PlacementTarget = owner;
6.     Placement = PlacementMode.Relative;
7.     Rect rect = owner.CaretPosition.GetCharacterRect(LogicalDirection.Forward);
8.     HorizontalOffset = rect.X;
9.     VerticalOffset = rect.Y + rect.Bottom;
10.     //本来の処理
11.     base.OnOpened(e);
12.     //ListBoxにフォーカスを設定
13.     lb.Focus();
14.     //入力文字数を初期化
15.     length = 0;
16. }

  ownerは、HTMLのソースを編集しているRichTextBoxです。
  位置は相対で指定しています。

３．２．文字の入力

  ここでは、フォーカスがPopupウインドウのListBoxにあります。ListBoxは項目の選択にキーボード入力を使います。
  この状態で、英字キーが押されたらListBoxの項目の選択を更新します。同時に、RichTextBoxにも反映します。
  Popupウインドウの OnPreviewTextInput() をオーバライドすると、ListBox で使わない文字入力だけが通るようです。
  ここで、英字ならRichTextBoxへ反映しました。

一覧