Advanced Search

Log In | Not a Member?

Contact ADC

コントロールリージョンの宣言

Dashboardでは、スタイルシートと共に拡張機能を利用できます。-apple-dashboard-regionは、特定の用途のリージョンを指定することを可能にし、Dashboard内で実行するウィジェットに固有のものです。

-apple-dashboard-region

ウィジェットは、デフォルトでは、その内部の任意の場所をクリックしてドラッグすることで、Dashboardの中で移動できます。しかし、状況によっては、この動作が最適でない場合や望ましくない場合があります。

たとえば、ボタンをマウスでクリックして押したままの状態にしたとき、ウインドウは動くべきではありません。しかし、何も変更を加えなければ、ウィジェットはそれを許します。ドラッグを許さないリージョンを指定するには、コントロール円およびコントロール矩形を使います。

「計算機」ウィジェットは、Figure 19に示すように、コントロール円とコントロール矩形を作成する方法の例を示しています。明るい色で示したリージョンが、ドラッグを許さない領域です。

Figure 19  「計算機」ウィジェットのコントロール円とコントロール矩形

「計算機」においてボタンをコントロールリージョンとして指定するとき、画像に対してスタイルが適用されます。そのスタイルのプロパティの1つであり、コントロールリージョンを指定するのが apple-dashboard-regionプロパティです。このプロパティは、パラメータとしてdashboard-region()を受け取ります。このパラメータ自身も2つのパラメータを必要とします。

このほかに、リージョン境界のオフセットを指定する省略可能な4つのパラメータがあります。これらのパラメータは省略可能です。省略した場合、値は0に設定されます。

dashboard-region()のパラメータは、次の順番で指定する必要があります。

dashboard-region(label geometry-type offset-top offset-right offset-bottom offset-left)

したがって、すべての辺が対象要素の縁から 5 ピクセル内側にある円形のコントロールリージョンを指定するスタイルは、次のようになります。

.control-circle-example {

    ...

    -apple-dashboard-region: dashboard-region(control circle 5px 5px 5px 5px);

    ...

}

1つのパラメータに複数のdashboard-region()値を指定することで複雑な形状も作成できます。たとえば、「計算機」の“=”ボタンを、円形と矩形のコントロールリージョンで構成することも考えられます。

.equals-button-example {

    ...

    -apple-dashboard-region:

        dashboard-region(control circle 15px 15px 75px 15px)

        dashboard-region(control rectangle 32px 15px 48px 15px)

        dashboard-region(control circle 60px 15px 30px 15px);

    ...

}

この例では、要素は幅65ピクセル、長さ125ピクセルです。2つのコントロール円の直径は35ピクセルで、コントロール矩形は幅35ピクセル、長さ45ピクセルです。これらの値は、Figure 20のように配置されます。

Figure 20  コントロールリージョンの例

円形のリージョンが、対象境界の内側で中央に置かれる点に注目してください。

要素から特定のコントロールリージョンを取り除くには、その要素の-apple-dashboard-regionプロパティをnoneに設定します。

Did this document help you? Yes: Tell us what works for you. It’s good, but: Report typos, inaccuracies, and so forth. It wasn’t helpful: Tell us what would have helped.

	Get information on Apple products. Visit the Apple Store online or at retail locations. 1-800-MY-APPLE Copyright © 2007 Apple Inc. All rights reserved. | Terms of use | Privacy Notice