GIZMOガジェット制作チュートリアル : ファーストガイド : Mac OS X版について

Mac OS X版について

GIZMO ver2 Mac OS X版は現在開発中です

GIZMO ver2 Mac OS X版は現在開発中です。 GIZMOによるガジェット制作をMac環境でご利用になりたい方はGIZMO β for Mac OS X ver1.1.3（以下、「GIZMO Mac OS X版」）をご利用ください。

作成したガジェットを「GIZMO Mac OS X版」にインストールしたい場合は、GadgetInstallerMaker for Mac OS X ver 1.1を使用してガジェットインストーラーを作成してください。

GIZMO Mac OS X版の動作について

GIZMO Mac OS X版は、起動時に「/ユーザ/ユーザー名/ライブラリ/Application Support/GIZMO/gadget/」にインストール済みのガジェットをコピーします。実際に動作するガジェットは「ユーザ」以下のディレクトリにコピーされたガジェットです。 writeText()メソッドなどで保存するデータもすべて「ユーザ」以下のディレクトリ側のガジェットフォルダに保存されます。 GIZMO Mac OS X版ではユーザーごとに個別にガジェットの設定やデータが保存されます。

ガジェット制作時の注意点

ガジェットのドラッグ制御

GIZMO Mac OS X版では、ボタン／テキストフィールド上でドラッグした際にガジェットが移動してしまいます。そのため、テキストフィールドのテキストをドラッグして選択することができません。選択可能なテキストフィールドを作成する場合や、ボタン上でドラッグしてもガジェットが移動しないようしたい場合は、_dragプロパティを使用してガジェットが移動しないようにする必要があります。ただし、ボタン上でドラッグした際にガジェットが移動しても問題ない場合や、テキストフィールドをドラッグして選択する必要がない場合は特に何もする必要はありません。

my_btn.onPress = function () {
  Gizmo._drag = false;
};
my_btn.onRelease = function () {
  Gizmo._drag = true;
};
my_txt.onSetFocus = function () {
  Gizmo._drag = false;
};
my_txt.onKillFocus = function () {
  Gizmo._drag = true;
};

レイヤードガジェットは使わない

GIZMO Mac OS X版では子レイヤーを使用しても負荷軽減の効果がありません。

また、親レイヤーと子レイヤーが重なる部分にボタンなどマウスカーソルが変化するインスタンスがあると、カーソルが点滅するように表示される場合があります。このような問題があるため、GIZMO Mac OS X版ではレイヤードガジェットは使用せず、スタンドアローンガジェットで作成する必要があります。

オートリフレッシュの制御は不要

GIZMO Mac OS X版ではオートリフレッシュの制御は必要ありません。 GIZMO Mac OS X版ではオートリフレッシュの制御を行っても表示の際の負荷が変わらないためです。ただし、オートリフレッシュの制御を行っても特に不具合が発生するわけではありません。

GIZMO Mac OS X版で使用可能な機能

GIZMO Mac OS X版ではGIZMO ver.2にあるいくつかの機能が使用できません。GIZMO Mac OS X版で使用可能な機能は以下のとおりです。詳細はリファレンスを参照してください。

メソッド	説明
activate()	ガジェットのアクティブ化
addEventListener()	イベントリスナーを登録
callEvt()	指定ガジェットにカスタムイベントを送信
callLayerEvt()	指定レイヤーにカスタムイベントを送信
clearXMLCache()	キャッシュファイルの削除
close()	指定ガジェットを閉じる
digitFormat()	数値の桁数を揃える
dispatchEvent()	イベントを発行
duplicate()	子ガジェットを複製して開く
fileDropEnable()	ファイルドロップの設定
getAllGadgetStatus()	全ガジェット起動／終了監視の設定
getCoreEngineVersion()	GIZMOコアバージョン／更新日の取得
getCpuClock()	CPUクロックの取得
getGadgetList()	ガジェット一覧の取得
getGadgetPosition()	指定ガジェット移動監視の設定
getGadgetStatus()	指定ガジェット起動の確認
getLang()	システム言語情報の取得
getXML()	XMLダウンロード＆文字コード変換
gtrace()	デバッグ用トレース
isTopWindow()	前面固定状態の取得
launchMailto()	メール作成
loadConfig()	設定用XMLの読み込み
movePosition()	ガジェット相対位置の移動
open()	ガジェットを開く
openConfig()	ガジェット設定ダイアログを開く
openDialog()	ファイル選択ダイアログを開く
openDir()	指定したフォルダを開く
readEncText()	テキストの復号化と読み込み
reloadXML()	ローカルXMLの読み込み
removeEventListener()	イベントリスナーの解除
sendMsg()	指定ガジェットにメッセージを送信
setCloseLock()	ガジェット終了のロック
setConfigItem()	設定用XMLの値の設定
setDragLimit()	ガジェットドラッグ領域制限の設定
setDragResize()	ドラッグリサイズの設定
setGadgetIsTop()	指定ガジェットの前面固定の設定
setPosition()	ガジェット絶対座標の移動
setStageSize()	ステージサイズ設定
setTracking()	ガジェット追従の設定
sjisEncode()	SJISでURLエンコード
writeEncText()	テキストの暗号化保存
writeText()	テキストの保存
writeTextEx()	テキストの保存（イベントあり）
プロパティ	説明
_active	ガジェットのアクティブ状態
_configxml	ロード済みの設定XML
_drag	ガジェットのドラッグ可否設定の状態
_draw	オートリフレッシュ設定の状態
_dskh	プライマリモニタの高さ
_dskw	プライマリモニタの幅
_event	最後に発生したイベント
_gadname	gadgetIDを示す
_hideWatch	GIZMOタスクトレイ収納状態の監視
_isTop	前面固定状態の設定
_mouseWatch	マウス移動監視の状態
_scalable	ステージリサイズ時の拡大／縮小の設定
_trace	traceガジェットでのトレース可否設定の状態
_urlDrop	URLリンクのドラッグ＆ドロップの可否の設定
_ver	Gizmoコンポーネントのバージョン
_xabs	ガジェットの水平位置
_xmlAutoClear	キャッシュファイルの自動削除の設定
_xmouseabs	マウスカーソルの水平位置
_yabs	ガジェットの垂直位置
_ymouseabs	マウスカーソルの垂直位置
イベント	説明
onActive	ガジェットがアクティブになった
onClose	ガジェットが終了されようとした
onConfigupdate	config.xmlをロードした／ガジェット設定ダイアログで設定変更された
onDeactive	ガジェットがアクティブでなくなった
onDialogCancel	ファイル選択をキャンセルした
onDialogSelect	ファイルオープンダイアログでファイルが選択された
onDrop	ファイルがドロップされた
onEvent	ガジェットイベントが発生した
onGetCoreEngineVersion	GIZMOコアバージョンを確認した
onGetCpu	CPUクロックを取得した
onGetGadgetList	ガジェット一覧を取得した
onGetGadState	ガジェットが起動／ガジェットが終了
onGetHide	GIZMOが隠れている／GIZMOが表示されている
onGetLang	言語情報を取得した
onGetXML	XMLを取得した
onInit	GIZMOコンポーネントの初期化が完了した
onMessage	ガジェット間メッセージを受信した
onMouseMoveABS	マウスが移動した
onMove	ガジェットが移動した
onReadEncText	暗号化テキストの復号化読み込みが完了した
onReloadXML	ローカルのXML読み込みが完了した
onResize	ステージサイズが変更された
onSjisEncoded	S-JISでURLエンコードした
onTextWritten	テキスト保存が完了した
onTopWindow	前面固定の状態を取得した
onUpdatePos	指定ガジェットが移動した
onUrlDrop	URLリンクがドロップされた
onWriteEncText	テキスト暗号化保存が完了した

ページの先頭へ

ダウンロード

下記の使用許諾に同意の上、ダウンロードしてください。

使用許諾

本ソフトウェアの作成には細心の注意を払っておりますが、インストールはご自身の判断で行ってください。
本ソフトウェアの使用、またはそれを使用できなかったことにより生じた派生的、付随的または間接的損害（営業上の利益の損失、業務の中断、営業情報の喪失などによる損害を含む）については、たとえそのような損害の発生や第三者からの賠償請求の可能性があることについて予め知らされた場合でも、一切責任を負いません。また、本ソフトウェアに不備があっても訂正する義務を負わないものとします。
本ソフトウェアに使用されているビジュアルのすべてを無断複製、無断転載、再配布などはお断りいたします。また、公共の場での使用、営利目的のための使用は一切行わないでください。
本ソフトウェアはフリーウェアですので、ご質問にお答えしたり、ツールのサポート等はいたしておりません。ご了承ください。