Palm OS Programmer's API Reference/22の変更点

• 追加された行はこのように表示されます。
• 削除された行はこのように表示されます。

{{div_begin}}
[[←　21 章に戻る|Palm OS Programmer's API Reference/21]]　[[↑トップへ|Palm OS Programmer's API Reference]]　[[23 章に進む　→|Palm OS Programmer's API Reference/23]]
----
{{div_end}}

{{anchor top}}
{{div_begin style="margin-bottom:-10px"}}
!!!22 UI コントロール
{{div_end}}

この章の索引

{{div_begin "style='position:absolute;right:0px;font-size:70%;margin-right:15px;margin-top:15px;width:250px;'"}}
*{{goto UI Control Functions,UI コントロール関数}}
**{{goto UIBrightnessAdjust,UIBrightnessAdjust}}
**{{goto UIContrastAdjust,UIContrastAdjust}}
**{{goto UIPickColor,UIPickColor}}
{{div_end}}

----

!!!22 UI コントロール

{{div_begin "style='position:relative;padding:0px;padding-right:5px;padding-left:10px;margin-right:250px;margin-top:20px;width:auto;border-right-style:dotted;border-right-width:2px;border-right-color:silver;'"}}
この章では、ヘッダファイル {{span style='color:blue;font-family:monospace;',UIControls.h}} で定義されている UI コントロールについて説明します。


!!{{anchor UI Control Functions}}UI コントロール関数 {{goto top,^TOP^}}


!{{anchor UIBrightnessAdjust}}UIBrightnessAdjust 関数 {{goto top,^TOP^}}

'''目的'''

明るさ調節ダイアログを表示します。

'''宣言されている場所'''

{{span style='color:blue;font-family:monospace;',UIControls.h}}

'''Prototype'''

 void UIBrightnessAdjust()

'''パラメータ'''

ありません。

'''返り値'''

返り値はありません。

'''コメント'''

明るさ設定をサポートするハードウェアでは、この関数はユーザが明るさのレベルを変更することを可能にするダイアログを表示します。バックライトを持つハードウェアでは、この関数はバックライトの ON/OFF を切り替えます。

'''互換性'''

{{goto 3.5 New Feature Set,3.5 New Feature Set|Palm OS Programmer's API Reference/B}} が満たされる場合にのみ、実行されます。
{{goto 3.5 New Feature Set,3.5 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実行されます。


!{{anchor UIContrastAdjust}}UIContrastAdjust 関数 {{goto top,^TOP^}}

'''目的'''

コントラスト調節ダイアログを表示します。（現在のところ、Palm OS V Connected Organizer でのみ使用可能です。）

'''宣言されている場所'''

{{span style='color:blue;font-family:monospace;',UIControls.h}}

'''Prototype'''

 void UIContrastAdjust()

'''パラメータ'''

ありません。

'''返り値'''

返り値はありません。

'''互換性'''

Palm OS リリース 3.5 で、この関数は {{span style='color:blue;font-family:monospace;',ContrastAdjust}} から {{span style='color:blue;font-family:monospace;',UIContrastAdjust}} にリネームされました。{{span style='color:blue;font-family:monospace;',ContrastAdjust}} 関数は、{{goto 3.1 New Feature Set,3.1 New Feature Set|Palm OS Programmer's API Reference/B}} が満たされる場合にのみ、実行されます。
Palm OS リリース 3.5 で、この関数は {{span style='color:blue;font-family:monospace;',ContrastAdjust}} から {{span style='color:blue;font-family:monospace;',UIContrastAdjust}} にリネームされました。{{span style='color:blue;font-family:monospace;',ContrastAdjust}} 関数は、{{goto 3.1 New Feature Set,3.1 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実行されます。


!{{anchor UIPickColor}}UIPickColor 関数 {{goto top,^TOP^}}

'''目的'''

ユーザが色を選択することを可能にするダイアログを表示します。

'''宣言されている場所'''

{{span style='color:blue;font-family:monospace;',UIControls.h}}

'''Prototype'''

 Boolean UIPickColor (
 	IndexedColorType *indexP,
 	RGBColorType *rgbP,
 	UIPickColorStartType start,
 	const Char *titleP,
 	const Char *tipP
 )

'''パラメータ'''

*{{span style='color:blue;font-family:monospace;',←→ indexP}}
**選択された色のインデックス値。（{{goto IndexedColorType,IndexedColorType|Palm OS Programmer's API Reference/59}} を参照してください。）エントリ時には、これは元々選択されていた色のインデックス値を指します。返り時には、これはユーザが選択した色のインデックス値を指します。この値をセットまたは返さない場合、{{span style='color:blue;font-family:monospace;',NULL}} を渡します。
*{{span style='color:blue;font-family:monospace;',←→ rgbP}}
**選択された色の RGB 値。（{{goto RBGColorType,RBGColorType|Palm OS Programmer's API Reference/26}} を参照してください。）エントリ時には、これはダイアログが表示されるときに元々選択されていた RGB 値を指します。返り時には、これはユーザが選択した RGB 値を指します。この値をセットまたは返さない場合、{{span style='color:blue;font-family:monospace;',NULL}} を渡します。
*{{span style='color:blue;font-family:monospace;',→ start}}
**色の付いたタイルが集まったシステム パレットを表示するための {{span style='color:blue;font-family:monospace;',UIPickColorStartPalette}} または赤、緑、青の値の別個のスライダを表示するための {{span style='color:blue;font-family:monospace;',UIPickColorStartRGB}} のどちらか。このパラメータは、{{span style='color:blue;font-family:monospace;',indexP}} と {{span style='color:blue;font-family:monospace;',rgbP}} の両方ともが {{span style='color:blue;font-family:monospace;',NULL}} である場合にのみ、使用されます。
*{{span style='color:blue;font-family:monospace;',→ titleP}}
**ダイアログのタイトルとして表示する文字列。デフォルトの文字列「Pick Color」を使用するには {{span style='color:blue;font-family:monospace;',NULL}} を指定します。
*{{span style='color:blue;font-family:monospace;',→ tipP}}
**使用されません。

'''返り値'''

新しい色が選択された場合は、{{span style='color:blue;font-family:monospace;',true}} を返します。そうで無い場合は、{{span style='color:blue;font-family:monospace;',false}} を返します。

'''コメント'''

この関数を使って、ユーザがユーザ インターフェイスの中で使用される色を選択することを可能にします。（システムは決して {{span style='color:blue;font-family:monospace;',UIPickColor}} を呼び出しません。）

この関数は 2 つのバージョンのダイアログを表示できます: パレットまたは RGB。ダイアログのパレット バージョンは、それぞれシステム パレットで定義された異なる色を持つタイルの集まりを表示します。{{span style='color:blue;font-family:monospace;',indexP}} 値は元々選択されていたタイルのインデックスを保持します。

ダイアログの RGB バージョンは、ユーザが赤、緑、青のレベルを選択することを可能にする 3 つのスライダを表示します。{{span style='color:blue;font-family:monospace;',rgbP}} パラメータはダイアログの中で示される赤、緑、青の元々の値を保持します。スライダは、現在のシステム カラー テーブルの中で定義されている値のみを許可します。

{{span style='color:blue;font-family:monospace;',indexP}} が元々 {{span style='color:blue;font-family:monospace;',NULL}} の場合、RGB ダイアログのみが表示されます。同様に、{{span style='color:blue;font-family:monospace;',rgbP}} が {{span style='color:blue;font-family:monospace;',NULL}} の場合、パレット バージョンのみが表示されます。両方のパラメータが non-{{span style='color:blue;font-family:monospace;',NULL}} の場合、システムはユーザがパレット ダイアログと RGB ダイアログを切り替えることを可能にするプル-ダウン リストを追加し、{{span style='color:blue;font-family:monospace;',start}} パラメータが最初に表示されるダイアログのバージョンを制御します。これケースでは、{{span style='color:blue;font-family:monospace;',indexP}} と {{span style='color:blue;font-family:monospace;',rgbP}} の両方が、返り時に、ユーザが選択した色の値を保持します。

Palm OS 3.5 は最大 256 色をサポートします。とり得る RGB カラーの数は、これよりもずっと大きくなります。この理由は、選択された RGB は厳密に一致する色を持たないかもしれないからです。このケースでは、色参照テーブルが完全にグレイスケール（各エントリための赤、緑、青の値が等価）である場合は {{span style='color:blue;font-family:monospace;',indexP}} パラメータは（{{span style='color:blue;font-family:monospace;',NULL}} でない場合）輝度が最も良く一致する色を保持し、また、パレットが色を保持している場合は RGB 空間の中で最短距離にある色が選択されます。

'''互換性'''

{{goto 3.5 New Feature Set,3.5 New Feature Set|Palm OS Programmer's API Reference/B}} が満たされる場合にのみ、実行されます。
{{goto 3.5 New Feature Set,3.5 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実行されます。

'''参照'''

{{goto WinSetBackColor,WinSetBackColor()|Palm OS Programmer's API Reference/59}}, {{goto WinSetForeColor,WinSetForeColor()|Palm OS Programmer's API Reference/59}}, {{goto WinSetTextColor,WinSetTextColor()|Palm OS Programmer's API Reference/59}}, {{goto UIColorSetTableEntry,UIColorSetTableEntry()|Palm OS Programmer's API Reference/21}}
{{div_end}}

----
{{div_begin "style='border-top-style:solid;border-top-width:1px;border-top-color:silver;'"}}
[[←　21 章に戻る|Palm OS Programmer's API Reference/21]]　[[↑トップへ|Palm OS Programmer's API Reference]]　[[23 章に進む　→|Palm OS Programmer's API Reference/23]]
{{div_end}}