コンポーネントのインストール
「Rating for ASP.NET Wijmo」を使用するには、Visual Studio、Visual Basic、Visual C#の開発環境に「ComponentOne Studio for ASP.NET Wijmo 2012J」をインストールする必要があります。
トライアル版は、「グレープシティのWebページ」からダウンロードできます。
ダウンロードしたい製品にチェックを付け［申込フォーム］ボタンを押すと、「トライアル版申込フォーム」ページに移動しますので、「個人情報の収集および使用に同意する」にチェックを入れ「同意する」ボタンをクリックします。
トライアル申込フォームが表示されますので、必要情報を登録すると添付トライアルライセンスキーファイルとダウンロードサイトを記載したE-Mailが送られてきます。ここからダウンロードを行ってください。また、ダウンロードファイルは圧縮ファイルになっていますので、解凍してインストーラを起動します。
制限事項などの詳細については、インストーラに同梱されているリリースノートを参照ください。
コントロールと参照の追加
「Rating for ASP.NET Wijmo」をインストールしたら、プロジェクトにコントロールを追加します。
ツールボックスに専用のタブを作成し、使用するコンポーネントを追加します。追加するコンポーネントは、アセンブリ名が「C1.Web.Wijmo.Controls.4」の「C1Rating」コントロールです。
プロジェクトに以下のランタイムライブラリへの参照が追加されます。
| ファイル | 内容 |
|---|---|
| C1.Web.Wijmo.Controls.4 | 本体アセンブリ |
また、プロジェクトに以下のランタイムライブラリが追加されます。
| ファイル | 内容 |
|---|---|
| C1.Web.Wijmo.Controls.4.dll | 本体アセンブリ |
なお、.NET Framework 4が必要です。
C1Ratingコントロールの概要
「Rating for ASP.NET Wijmo」のC1Ratingコントロールは、カスタマイズ可能なスターレーティングコントロールを自動的に生成するコントロールです。
レーティング機能は、よくWebページで商品や作品などをユーザーが評価する際に使用されるマークで、C1Ratingコントロールはこの機能をWebページに簡単に実装できるコントロールです。
デフォルトではスターマークが使用されますが、バー配列とGOOD/BADのレーティングオプションを使用することができます。
レーティングコントロールの向きはデフォルトではページの水平方向に設定されていますが。垂直方向に配置することもできます。
レーティングコントロールは、通常の表示状態、マウスポインタを重ねた状態、クリックしてレーティングを確定した状態の3つの動作をします。
ユーザーがアイコンを操作すると、C1Ratingコントロールには「Hover」および「Rated」イベントが発生します。
また、複数のクライアント側イベントが用意されており、それらを利用すればコントロールにマウスポインタが置かれるような処理が行われたときに、C1Ratingコントロールを操作できます。
|
イベントのサーバー側 プロパティ名 |
イベント名 | 説明 |
|---|---|---|
| OnClientHover | hover | コントロールの上にマウスボタンが置かれたときに発生します |
| OnClientRated | rating | コントロールのレーティング後に発生します |
| OnClientRating | rating | コントロールのレーティング前に発生します |
| OnClientReset | reset | リセットボタンがクリックされたときに発生します |
