Class Dialogs

組み込みダイアログを表示するための関数を含む静的クラスです。

継承

Dialogs
Namespace: ic4.WinForms
Assembly: ic4dotnet.System.Windows.Forms.dll

構文

public static class Dialogs

メソッド

ShowDeviceDialog(Grabber, IWin32Window)

ユーザーにビデオキャプチャデバイスを選択させるダイアログを表示します。
ユーザーがデバイスを選択した場合、渡された grabber オブジェクトでデバイスが開かれます。

宣言

public static bool ShowDeviceDialog(Grabber grabber, IWin32Window parentWindow)

パラメータ

型 名前 説明
Grabber grabber Grabber オブジェクト
IWin32Window parentWindow ダイアログの親ウィンドウ

戻り値

型 説明
bool true デバイスを正常に開いた場合、そうでない場合は false

例外

型 条件
ArgumentNullException grabber が null の場合

ShowDevicePropertyDialog(Grabber, IWin32Window, PropertyDialogFlags, string, string, PropertyVisibility, string)

ユーザーに、grabberで開かれているビデオキャプチャデバイスのプロパティを設定するダイアログを表示します。
ユーザーがダイアログをキャンセルした場合、プロパティはダイアログを開いた時点の状態に戻されます。

宣言

public static bool ShowDevicePropertyDialog(Grabber grabber, IWin32Window parentWindow, PropertyDialogFlags flags = PropertyDialogFlags.Default, string category = "Root", string title = "Properties", PropertyVisibility initialVisibility = PropertyVisibility.Beginner, string initialFilter = null)

パラメータ

型 名前 説明
Grabber grabber 開かれたビデオキャプチャデバイスを持つグラバー
IWin32Window parentWindow ダイアログの親ウィンドウ
PropertyDialogFlags flags ダイアログの動作をカスタマイズ
string category ダイアログに表示するプロパティのカテゴリ
string title ダイアログのタイトル。nullの場合は既定のタイトルが設定されます
PropertyVisibility initialVisibility ダイアログの可視性セレクタで初期選択されるプロパティの表示レベル
string initialFilter ダイアログのフィルタテキストボックスに挿入される文字列

戻り値

型 説明
bool true:ダイアログが表示され、OKボタンで終了した場合。そうでない場合はfalse

例外

型 条件
ArgumentNullException grabberがnull

ShowPropertyMapDialog(PropertyMap, IWin32Window, PropertyDialogFlags, string, string, PropertyVisibility, string)

ユーザーに、渡された PropertyMap のプロパティを設定するダイアログを表示します。
ユーザーがダイアログをキャンセルした場合、プロパティはダイアログを開いた時点の状態に戻されます。
開かれたビデオキャプチャデバイスの PropertyMap (DevicePropertyMap) を表示する場合、この関数ではアクティブなデータストリームがあるときに一部のプロパティを変更できません。
ストリーム定義プロパティを変更可能なダイアログを表示するには、ShowDevicePropertyDialog(Grabber, IWin32Window, PropertyDialogFlags, string, string, PropertyVisibility, string) を AllowStreamRestart オプション付きで使用してください。

宣言

public static bool ShowPropertyMapDialog(PropertyMap map, IWin32Window parentWindow, PropertyDialogFlags flags = PropertyDialogFlags.Default, string category = "Root", string title = "Properties", PropertyVisibility initialVisibility = PropertyVisibility.Beginner, string initialFilter = null)

パラメータ

型 名前 説明
PropertyMap map プロパティマップ
IWin32Window parentWindow ダイアログの親ウィンドウ
PropertyDialogFlags flags ダイアログの動作をカスタマイズするフラグ
string category ダイアログに表示するプロパティのカテゴリ
string title ダイアログのタイトル。null の場合はデフォルトタイトルが設定されます
PropertyVisibility initialVisibility ダイアログの可視性セレクタで事前に選択するプロパティの表示レベル
string initialFilter ダイアログのフィルターテキストボックスに事前入力する文字列

戻り値

型 説明
bool true:ダイアログが表示され、OKボタンで終了した場合、false:それ以外の場合

例外

型 条件
ArgumentNullException map が null の場合

ShowSelectDeviceDialog(IWin32Window)

ユーザーがビデオキャプチャデバイスを選択できるダイアログを表示します

宣言

public static DeviceInfo ShowSelectDeviceDialog(IWin32Window parentWindow)

パラメータ

型 名前 説明
IWin32Window parentWindow ダイアログの親ウィンドウ

戻り値

型 説明
DeviceInfo 選択されたビデオキャプチャデバイスを表す DeviceInfo オブジェクト、もしくはユーザーがデバイスを選択しなかった場合は null