getRealPreference

書式

preferencesObject.getRealPreference(キー名)

説明

指定されたキー名の設定の小数値を返します。該当する名前のキーがない場合は0になります。なお、小数値以外の設定は読み出すことができずエラーが発生します。
パラメーターに指定するキー名は環境設定ファイルの内容を参照します。バージョンごとに環境設定ファイルの内容は異なります。このため、設定するキー名もバージョンごとに異なる場合があります。設定ファイルの場所はAdobeの公式ページ (https://helpx.adobe.com/jp/illustrator/using/setting-preferences.html)を参照してください。

環境設定ファイルをテキストエディタで開くと以下の図のような感じになっています。



 以下のサンプルで指定しているuiBrightnessはCS6用ですが、CS6の環境設定ファイルを開くと上図のように/uiBrightness 0.3300000131という文字があります。ここでuiBrightnessがキー名でその後に続く数字が値になります。
設定するキー名がネスト(入れ子・階層化)されている場合があります。例えば以下のような環境設定の場合です。

/smartGuides {
/isEnabled 1
/tolerance 4
/anglesCount 4294967295
/showAlignmentGuides 1
/showReadouts 1
/showObjectHighlighting 1
/showToolGuides 0
/showConstructionGuides 0
/showLabels 1
}

 この場合、パラメーターに指定するにはapp.preferences.getRealPreference("smartGuides/anglesCount");のように/で区切って指定します。
var n=app.preferences.getRealPreference("uiBrightness");
alert(n);

目次に戻る