WPExtensionsライブラリでWP7開発を簡素化する

先日、WPExtensionsライブラリのリリースをなんとかリリースしました。 ライブラリの古い作業名はあまりわかりにくいShWPではなく、基本的にライブラリには標準コントロールに対する拡張機能とラッパーが含まれています。

Nugetパッケージマネージャーのサポートが追加されました。 次のコマンドでライブラリをインストールできます：
インストールパッケージWPExtensions

codeplexを使用してライブラリ、ソースコード、デモをダウンロードすることもできます。
通常どおり、ライブラリを使用するには、適切な名前空間宣言を追加する必要があります。

xmlns：WPExtensions = "clr-namespace：WPExtensions; assembly = WPExtensions"

次に、ライブラリの主要コンポーネントを検討します。

AdvancedApplicationBar

このコンポーネントについては、 オタク誌にすでに出版物がありました
何が起こったかを簡単に繰り返し、このバージョンの新機能について説明します。

AdvancedApplicationBarは、標準のApplicationBarのラッパーであり、いくつかの新しい機能を追加します。 コントロールとして実装されているため、メインコンテナー（通常はグリッド）内に配置する必要があります。

<phone:PhoneApplicationPage ...> <Grid x:Name="LayoutRoot" Background="Transparent"> ... <WPExtensions:AdvancedApplicationBar IsVisible="True" IsMenuEnabled="True"> <WPExtensions:AdvancedApplicationBarIconButton IconUri="/Images/appbar_button1.png" Text="Button 1"/> <WPExtensions:AdvancedApplicationBarIconButton IconUri="/Images/appbar_button2.png" Text="Button 2"/> <WPExtensions:AdvancedApplicationBarMenuItem Text="MenuItem 1"/> <WPExtensions:AdvancedApplicationBarMenuItem Text="MenuItem 2"/> </WPExtensions:AdvancedApplicationBar> </Grid> </phone:PhoneApplicationPage> 

MenuItemを別のタグに割り当てる必要がないことに注意してください。

パノラマ/ピボットのサポート。

多くの場合、異なるパノラマ/ピボットアイテムがApplicationBarに異なるボタン/メニューのセットを表示するために必要です。 msdnでは、resに個別のApplicationBarを作成し、Actinアイテムを変更するときにApplicationBarを変更するソリューションが提案されています

ここで、PanoramaItem / PivotItem内の対応するボタンを移動して、ボタン/メニューがこのアイテム（ボタン1 /メニューアイテム1）のみに表示されるようにします。

この場合、残りのメニューボタンはデフォルトですべての要素の後に表示されます。 パノラマ内の要素の前にボタン/メニューを表示する必要がある場合は、メニュー/ボタンをパノラマ（ボタン2）に転送するだけです：

 <phone:PhoneApplicationPage .... xmlns:WPExtensions="clr-namespace:WPExtensions;assembly=WPExtensions" ...> <Grid x:Name="LayoutRoot" Background="Transparent"> <!--         --> <WPExtensions:AdvancedApplicationBarIconButton IconUri="/Images/appbar_button2.png" Text="Button 2"/> <Grid x:Name="ContentPanel" Margin="12,0,12,0"> <controls:Panorama> <controls:PanoramaItem Header="Item1"> <Grid> ... <!--          PanoramaItem --> <WPExtensions:AdvancedApplicationBarIconButton IconUri="/Images/appbar_button1.png" Text="Button 1"/> <WPExtensions:AdvancedApplicationBarMenuItem Text="MenuItem 1"/> </Grid> </controls:PanoramaItem> <controls:PanoramaItem Header="Item2"> ... </controls:PanoramaItem> </controls:Panorama> </Grid> <WPExtensions:AdvancedApplicationBar IsVisible="True" IsMenuEnabled="True"> <!--        --> <WPExtensions:AdvancedApplicationBarMenuItem Text="MenuItem 2"/> </WPExtensions:AdvancedApplicationBar> </Grid> </phone:PhoneApplicationPage> 

バインディングサポート

前回説明したように、AdvancedApplicationBarプロパティは元のプロパティとは異なり、データバインディングをサポートしています。

  <WPExtensions:AdvancedApplicationBarIconButton Text="{Binding AppBarIconButtonText}" IconUri="{Binding AppBarIconButtonText}" Visibility="{Binding Visibility}" Command="{Binding DeleteCommand}" CommandParameter="42" /> 

フォーカスされている要素のバインディングの更新のサポート。

これは、新しいバージョンの革新の1つであり、特にDataBindingをアクティブに使用する場合に役立ちます。
この点についてさらに詳しく説明しましょう。

フォームにBindingを持つTextBoxがあるとします。

 <TextBox Text="{Binding Text,Mode=TwoWay}" /> 

また、対応するボタンがフォーム上にあり、標準の<shell：ApplicationBarIconButtonボタンがあります。このボタンは、ハンドラ内でMessageBoxの添付プロパティのテキストを表示します。

 MessageBox.Show(Text); 

ApplicationBarIconButtonをクリックしたときとButtonをクリックしたときにテキストを編集し、編集モード（TextBoxでフォーカス）のままである場合、異なる結果が表示されます。 ApplicationBarIconButtonをタップすると、古いテキストが表示されていることがわかります。 これは、フォーカスが失われたときにのみテキストが更新され、標準のAppBarボタンがフォーカスを失わないためです。

AdvancedApplicationBarでは、ボタンをクリックするとフォーカスが失われます（フォーカスがページに転送されます）。ボタンが期待どおりに動作し、新しいテキストが表示されることがわかります。
必要に応じて、属性DisableLostFocus = "True"を使用してデフォルトの動作を返すことができます

 <WPExtensions:AdvancedApplicationBarIconButton ... DisableLostFocus="True" /> 

モード=「デフォルト」IsVisible =「True」
デフォルト値とは異なるApplicationBar属性がさらに2つあります。
デフォルトでは、ApplicationBarのMode、IsVisible属性の値は、Mode = "Default" IsVisible = "True"に設定されます

AdvancedApplicationBarでは、これらの属性の値はデフォルトでは固定されておらず、次の条件に依存します。

ページやPanoramaItem / PivotItemにボタンがある場合、属性値はMode =“ Default” IsVisible =“ True”です


メニュー項目のみがある場合、属性値は等しくなります。Mode=“ Minimized” IsVisible =“ True”



ボタン/メニュー項目がない場合、属性IsVisible =“ False”の値



これで、AdvancedApplicationBarの概要は終わりです。 次は、TextBox拡張機能の説明です

テキストボックス拡張

かなり頻繁に、TextBoxの基本的な機能を見逃します。 将来、拡張機能のリストを拡張する予定ですが、これまでのところ、最も一般的な2つの問題のために、ライブラリに2つの拡張機能を追加しました。

これらの拡張機能は、単一の要素とコンテナ内の要素（Page、StackPanel、Grid）の両方に適用できます。 たとえば、ページ上のすべてのテキストフィールドの動作を設定する場合は、ページに属性を追加するだけです。

 <phone:PhoneApplicationPage ... WPExtensions:Extensions.UpdateBindingOnChange="True" WPExtensions:Extensions.SelectAllOnFocus="True"> 

UpdateBindingOnChange

特定のモデルに添付されたテキストフィールドがあるとします。

 <TextBox Text="{Binding Text,Mode=TwoWay}" /> 

多くの場合、テキストの変更中にモデルを更新する必要があります。これは通常、TextChangedイベントでBinding が更新されます。

これで、代わりに属性を使用できます：Extensions.UpdateBindingOnChange = "True"

 <TextBox Text="{Binding Text,Mode=TwoWay}" WPExtensions:Extensions.UpdateBindingOnChange="True" /> 

SelectAllOnFocus

値を編​​集するとき、たとえば価格/数量などを編集するなど、最初に古い値を消去する必要があるアプリケーションをよく見ることができます。たとえば、10を20に置き換えます。 ユーザーは、もう一度タップして現在の値をそのままにするか、目的の値の設定を開始するだけで値を置き換えることができます。



これを行うために、GotFocusは通常、txtBox.SelectAll（）メソッドが呼び出された場所でインターセプトされます。
これで、WPExtensions拡張機能を使用してこの動作を設定できます。Extensions.SelectAllOnFocus= "True"

 <TextBox WPExtensions:Extensions.SelectAllOnFocus="True" /> 

MicrophoneWrapperマイクのサポート

最新バージョン1.3では、Audio名前空間（WPExtensions.Audio）のマイクにラッパーが追加されました。

ラッパーの使用も非常に簡単です。

 var microphoneWrapper=new MicrophoneWrapper(); 

録音：

 microphoneWrapper.Record(); 

停止：

 microphoneWrapper.Stop(); 

サウンドの再生：

 microphoneWrapper.Play(); 

録音されたサウンドを取得するには、2つの方法があります。

「生」または元のレコードを受信する：

 microphoneWrapper.GetContent(); 

WAV形式でレコードを受信する：

 microphoneWrapper.GetWavContent(); 

このライブラリが誰かに役立つことを願っています。それ自体でフィードバックがあれば嬉しいです。