【Windowsデスクトップアプリ】WPFアプリ実装基本TIPS〜実務で使えるリンクまとめ〜


WPFアプリ実装基本まとめ

はじめまして、渋谷でネイティブアプリエンジニアをしているYokiです👋
25才の2年目エンジニアとして働いています。

2018年2月〜6月ぐらいまでWindowsのデスクトップアプリを開発することがあり、その際に参考にしたものを
本記事ではまとめました。

誰かの参考になると幸いです😄

基本事項

・コントロールとはなんぞや
→ コントロールは、ユーザーとの対話を担う要素で、GUIアプリケーション開発の中心的存在といえる。コントロールは、マウスやキーボードなどのユーザー操作を受け取ったり、処理の途中経過や結果を適宜表示したりするために利用する。

・デバッグコードとして出力ウィンドウにメッセージを出力したいときは System.Diagnostics.Debug クラスを使う。
→ System.Console クラスの WriteLine() メソッドでも同様に出力ウィンドウにメッセージを出力させることができ ますが、こちらは Release モードでコンパイルしてもコードとして残ってしまうため、Release モードでもどこかにメッセージが出力されることになります。
コード上で "System.Diagnostics.Debug.WriteLine" と記述した後、"Debug" の部分にキーボードカーソルを置いてから F12 キーを押してみましょう。

機能処理とかC#とかとか

・String, string あるけどどっち使うの問題
みんな気になるC#のstringとStringの違い。

・命名規約
JavaとC#の命名規約まとめ (JavaプログラマーがC#でプログラムを書いて引っかかったところ その3)

・Git Ignore設定
git ignore

・リストビュー作成
Add Items to Columns in a WPF ListView

・リストにチェックボックスを配置する
Add Items to Columns in a WPF ListView

・ファイル保存(今回はdbファイル持ってきたかったので参考にした)
ファイルをダウンロードし保存する

・APIのレスポンスからバイナリファイルを取得して保存する
HttpClient でファイルを非同期でダウンロードする

string fileName = "test.db"

とかにすると、持ってきたファイルはプロジェクトないのbinフォルダ内に保存される。(デスクトップとかにファイル持つのを回避できる)

・API通信を Json.NET(ライブラリ) を使用してやってみる
C#で気象情報REST API(WeatherHacks)を使ってみる

・C#での using について
C# でファイル開くなら using を使おう

・C#での同期/非同期プログラミングについて
Async および Await を使用した非同期プログラミング (C#)

・通信処理でCookieをセットする方法について

既定ではHttpClient内部のHttpClientHandlerによりCookieヘッダーは自動設定されます。このとき手動設定したCookieヘッダーは取り除かれるのでこのようなことが起こります。UseCookiesをfalseに設定したHttpClientHandlerをHttpClientのコンストラクタに与えることで、この自動設定を無効にすることができます。
var client = new HttpClient(new HttpClientHandler { UseCookies = false });
client.DefaultRequestHeaders.Add("Cookie", "name=value");
var response = await client.GetAsync("http://example.com/");

・簡単なコールバック
Fire callback after async Task method

・オブジェクト型を辞書型に変換する
How to convert object to Dictionary in C#?
↑ IDictionary の I は消す必要あり

・コレクション要素をグルーピングする
LINQでn個ずつグルーピング

.ビルド構成について
VS.NETでデバッグ版/リリース版以外のビルド構成を追加するには?

・構成マネージャー
デバッグビルドでのみ特定のコードがコンパイルされるようにする
条件付きコンパイル定数を使用する

・Content-Type に boundary を入れたい時の対処
Wrong Content-Type header generated using MultipartFormDataContent

・SQLiteをいじる(導入から入出力まで)
SQLiteを使って環境設定からデータの保存・読み出しまで

・SQLiteにパスワードをつける
→ GDPR(EU一般データ保護規則)などのセキュリティ面を考慮して、DBなどの情報ファイルはちゃんと管理したいものです、、
で、例えばSQLiteをローカルに持つアプリならパスワードつけとこうぜって話です
System.Data.SQLite の暗号化について

・CharlsをWindowsでもつかいたいよね
Charles Proxy を利用したパケット情報の収集方法(Windows)

・テキストボックスの入力制限について
WPF テキストボックスの設定色々
[[XAML] WPF で IME (かな漢字変換) を切り替えるには (Windows フォームから WPF へ)]
IME制御
(https://code.msdn.microsoft.com/windowsdesktop/XAML-WPF-IME-Windows-WPF-9ef457d7)

困ったときの対処(エラー関係とか)

・名前空間がないだと!?
srcで名前空間設定したのにエラーがでるとき
clr-namespace:[名前空間] に存在しません。

→ 確かにこれで(1個目の対応で)直るけど、一旦srcのところ(エラーが出ているところ)をコメントアウトしてビルド、コメントアウトしたところを元に戻すとエラー解消されていた

・アクセシビリティに一貫性がないだと!?
アクセシビリティに一貫性がありません と言われる

・オブジェクト参照がオブジェクト インスタンスに設定されていません。
用語「オブジェクト参照がオブジェクト インスタンスに設定されていません。」について

配布するときのあれこれ

・いい感じにまとまってる資料を探してここに行き着いた
WPF アプリケーションの配布

・ClickOnceに関して
WPF勉強(10) アプリ配布方法について ClickOnce編

→ ClickOnceはなんか証明書とかややこしそう

・インストーラーの作成
VisualStudioInstallerの使い方

・XCOPY?
.NET アプリケーションを XCOPY 配置で配布する

XCopy ではバージョン管理、アンインストール、およびロールバックがサポートされず、それらをサポートするにはアプリケーション側で実装する必要があり、そんなことをするくらいならインストーラーを作成すべきだと思います。

用語

・データコンテキスト
【WPF基礎】脱WPF初心者のための基礎知識 その1~DataContextってなんぞ?~

「xxxオブジェクトが扱うデータはhogeオブジェクトが持っているので(データ環境の実体はhogeオブジェクト)、DataContextを通してアクセスする」
WPF では UI からプロパティが変更されたことはデータコンテキストに自動的に通知されますが、データコンテキストからプロパティが変更されたことは自動的には通知されません。つまり、MainViewModel側から明示的にプロパティ変更通知をおこなう必要があります。これは INotifyPropertyChanged インターフェースによって実現できる。

・コードビハインド
参考
イベント処理などのプログラムコードは、XAML中に記述するのではなく、 XAMLとは別ファイルにすることが可能です。 このように、XAML で記述した GUI のイベント処理などを別ファイルで与えることを コードビハインド(code-behind)といいます。

・ASP.NET 【 Active Server Pages .NET 】 ASPX

ASP.NETとは、.NET Frameworkで提供されるWebサービス向けのクラスライブラリ。Windowsサーバ上でダイナミックなWebページを動作させるための基盤となるソフトウェアで、WebアプリケーションやWebサービスの開発・構築に用いられる。

デザインとかとか

・フォントファイルを取り込んで使用する
フォントをアプリケーションに埋め込む(Visual Studio編)

・リソースディクショナリーを使用して再利用ビューを作成する
WPFサンプル:別XAMLに定義したリソースをMergedDictionaries で読みこむ

・均等配置
WPF 等間隔で横並びにする方法

・ホバーアクションとか
[WPF] マウスオーバー時のボタンのボーダーと背景色をデフォルトから変更する

・リソースから画像を読み込む方法
[WPF/XAML] リソースから画像を読み込む

・windowリサイズ時のimageの挙動についてストレッチの設定に依存する
Stretch 列挙型

・リストボックスの中のitemTemplateを横幅いっぱいに設定するには
How to get a ListBox ItemTemplate to stretch horizontally the full width of the ListBox?

スクロールバーのデザインをMacぽくしたいとき
How to create Apple MacOS like Scrollbar in WPF

・用意する画像のパターンについて
↓ 多分これ
Using file or image resources (XAML)

・普通の画面遷移
NavigationWindowを使った画面遷移

・アプリアイコン
アイコン

アプリケーション アイコンおよびコントロール パネルのアイテム: 16 × 16、32 × 32、48 × 48、256 × 256 でフル セットとなります。(コードで 32 ~ 256 に拡大縮小します)。.ico ファイル形式である必要があります。クラシック モードの場合、フル セットは 16 × 16、24 × 24、32 × 32、48 × 48 および 64 × 64 になります。

・マテリアルデザインキット
参考

UI参考リンク

・ライブラリを使用したDrawer & PopUp Menuの実装

使用ライブラリ:MaterialDesignInXamlToolkit(MIT ライセンス)

→ アイコン、ポップアップメニューで利用

Youtube Navigation Drawer & PopUp Menu



・ライブラリを使用したハンバーガーメニューの実装

使用したライブラリ:HamburgerMenu (MIT ライセンス)



・グローバルメニュー

WPFサンプル:NavigationServiceを使ったページ遷移

global1
global2

・ダッシュボードライクな画面

Designing a Dashboard in WPF Visual C#