Basic Library for WPF/Silverlight
ファイルピッカー要素
製品の概要 > FilePicker > ファイルピッカー要素

FilePicker for WPF/Silverlightは、ファイルの選択機能を提供します。選択したファイルは、Upload for WPF/Silverlightを使用してアップロードしたり、他のコントロールで使用することができます。基本 C1FilePicker コントロールは、次の図のようになります。

コントロールは、ウォーターマークまたは選択したファイルの名前をリストするボックス、および省略符で示される[参照]ボタンで構成されています。

 ユーザーが実行時に[参照]ボタンをクリックすると、OpenFileDialog ダイアログボックスが表示されます。ユーザーは OpenFileDialog を使用して、ローカルコンピュータまたはネットワークで接続されたコンピュータ上にある1つまたは複数のファイルを選択できます。選択したファイルは、SelectedFiles コレクションに追加されます。詳細については、「[開く]ダイアログボックス」トピックを参照してください。

[参照]ボタンのコンテンツおよび外観をカスタマイズすることができます。それには、BrowseContent プロパティをオブジェクトに設定します。選択したオブジェクトは[参照]ボタンとして表示されます。

デフォルトでは、ウォーターマークは C1FilePicker コントロールのテキスト領域に表示されます。ウォーターマークにより、指示や推奨事項が実行時にユーザーに示されます。たとえば、デフォルトのウォーターマークテキストは「ファイルを選択」です。

テキストは淡色表示されることに注意してください。1つまたは複数のファイルを選択すると、ファイルはこのテキスト領域に表示されます。このとき、ウォーターマークと区別するために、ファイルは濃い色で表示されます。ファイルを選択した後に、ClearSelection メソッドを使用して C1FilePicker コントロールからファイルをクリアすると、ウォーターマークが再度表示されます。例については、「選択したファイルをクリアする」を参照してください。

ウォーターマークをカスタマイズするには、Watermark プロパティを、表示する値に設定します。例については、「ウォーターマークを削除する」を参照してください。ウォーターマークを表示しない場合は、Watermark プロパティを空白の値(スペース文字など)に設定します。

関連トピック