# メニューアイテムプロパティ

マニュアル > コントロールリファレンス > 基本 > サイドメニューコントロール > # メニューアイテムプロパティ |

| メニューアイテムプロパティは、サイドメニューコントロールのアイテム領域のプロパティです。アイテム領域については、「レイアウト」を参照して下さい。また、メニューアイテムプロパティは、コントロールのプロパティ設定ではなく、以下のメソッドからの設定となります。 AddMenu / InsertMenu / SetMenuProperty / GetMenuProperty / SetIdProperty / GetIdProperty / SetClassProperty これらの各メソッドの「Props」パラメータに、以下のプロパティ設定書式で指定します。
"アイテムプロパティ名:設定値"
また、一度に複数のアイテムプロパティを設定する場合は、配列で指定します。
c("アイテムプロパティ名1:設定値1", "アイテムプロパティ名2:設定値2" [, ...])
| 以下が、メニューアイテムプロパティの設定例です。 設定例)AddMenuの場合 プロパティ一つの設定
this.AddMenu( "root" , "string" , "Sample" , "_SAMPLE" , F , "enable" , "id:sampleid");
複数プロパティの設定
this.AddMenu( "root" , "string" , "Sample" , "_SAMPLE" , F , "enable" , c("id:sampleid", "class:sampleclass" ) );
アイテム（メニューアイテム/ポップアップアイテム）のプロパティ
アイテムプロパティ名 | 説明
id | アイテムのid
class | アイテムのclass。カンマで区切ることで複数のclassを設定できる。
style | アイテムのスタイル名を指定します。スタイル名は、「AddStyle」で指定するスタイル定義配列のインデックス0番目となります。
CheckState | メニューのチェックの状態。
EnableState | メニューアイテムの状態。
enable | メニューアイテムを通常表示する。
disenable | メニューアイテムを使用禁止にし、選択できないようにする。淡色表示にしない。
gray | メニューアイテムを使用禁止にし、選択できないようにする。淡色表示にする。
FillColor | メニューアイテムの塗りつぶし色。
PopupMarkColor | ポップアップアイテムの場合、Open/Close状態を示すマーク（>など）の色。
PopupMarkOpen | ポップアップアイテムがOpenの状態の時に表示させる開閉マーク。
NONE | マーク無し
LEFT | 左向き(>)
RIGHT | 右向き(<)
UP | 上向き(∧)
DOWN | 下向き(∨)
PopupMarkClose | ポップアップアイテムがCloseの状態の時に表示させる開閉マーク。
NONE | マーク無し
LEFT | 左向き(>)
RIGHT | 右向き(<)
UP | 上向き(∧)
DOWN | 下向き(∨)
ClickSelect | マウスクリック時のアイテムの選択許可。指定しないと、デフォルトでコントロールプロパティのClickSelectプロパティの値が利用される。
ClickEvent | マウスクリック時のアイテムのイベント発生許可。指定しないと、デフォルトでコントロールプロパティのClickEventプロパティの値が利用される。
ClickToggleCheck | マウスクリック時のアイテムのCheckStateの切り替えの許可。指定しないと、デフォルトでコントロールプロパティのClickToggleCheckプロパティの値が利用される。
ClickAction | 設定のみ有効。「ClickSelect」「ClickEvent」「ClickToggleCheck」をまとめて設定したい場合に本プロパティで設定します。 設定値は、ClickSelect / ClickEvent / ClickToggleCheckの順番で1 or 0 で指定する。 例）011 この例ではClickSelect=F / ClickEvent=T / ClickToggleCheck=T を設定したのと同様
Event | マウスクリック時にOnMsgイベントの引数で渡される値。OnMsgイベントはClickEventプロパティがTの時のみ発生。
アイテム（メニューアイテム/ポップアップアイテム）内の各Divisionのプロパティ
各Division（「Left Division」「Middle Division」「Right Division」）のメニューアイテムプロパティには先頭に「L(Left)」「M(Middle)」「R(Right)」が付与します。 例) DivTypeの場合、LDivType / MDivType / RDivType が実際の設定時のプロパティ名となります。
アイテムプロパティ名 (先頭にL/M/Rが付与します) | 説明
DivType | Division領域内に表示するコンテンツのタイプ
NONE | 表示しない。Divのサイズは0になります。
TEXT | 文字列
BAR | メニュー選択状態の表示バー
IMAGE | 画像
CHECK | チェック
COUNTER | 数値
HYPERLINK | ハイパーリンク
利用時のプロパティ名:LDivType/MDivType/RDivType
DivSizeX | 領域の幅 利用時のプロパティ名:LDivSizeX/MDivSizeX/RDivSizeX
DivSizeY | 領域の高さ 利用時のプロパティ名:LDivSizeY/MDivSizeY/RDivSizeY
DivPaddingX | 領域のX方向のパディング 利用時のプロパティ名:LDivPaddingX/MDivPaddingX/RDivPaddingX
DivPaddingY | 領域のY方向のパディング 利用時のプロパティ名:LDivPaddingY/MDivPaddingY/RDivPaddingY
DivAlignX | 表示コンテンツのX方向の位置(アライメント)
LEFT | 左寄せでコンテンツを描画する
CENTER | 中心にコンテンツを描画する
CENTERITEM | アイテム(ItemDiv)の中心にコンテンツを描画する
RIGHT | 右寄せでコンテンツを描画する
利用時のプロパティ名:LDivAlignX/MDivAlignX/RDivAlignX
DivAlignY | 表示コンテンツのY方向の位置(アライメント)
TOP | 上寄せでコンテンツを描画する
CENTER | 中心にコンテンツを描画する
BOTTOM | 下寄せでコンテンツを描画する
利用時のプロパティ名:LDivAlignY/MDivAlignY/RDivAlignY
ClickSelect | M/L/RDivの領域毎にそれぞれマウスクリック動作を制御したい場合に指定する。プロパティの詳細はアイテム全体のプロパティの「ClickSelect」と同様。 利用時のプロパティ名:LClickSelect/MClickSelect/RClickSelect
ClickEvent | M/L/RDivの領域毎にそれぞれマウスクリック動作を制御したい場合に指定する。プロパティの詳細はアイテム全体のプロパティの「ClickEvent」と同様。 利用時のプロパティ名:LClickEvent/MClickEvent/RClickEvent
ClickToggleCheck | M/L/RDivの領域毎にそれぞれマウスクリック動作を制御したい場合に指定する。プロパティの詳細はアイテム全体のプロパティの「ClickToggleCheck」と同様。 利用時のプロパティ名:LClickToggleCheck/MClickToggleCheck/RClickToggleCheck
ClickAction | M/L/RDivの領域毎にそれぞれマウスクリック動作を制御したい場合に指定する。プロパティの詳細はアイテム全体のプロパティの「ClickAction」と同様。 利用時のプロパティ名:LClickAction/MClickAction/RClickAction
Event | M/L/RDivの領域毎にそれぞれマウスクリック動作を制御したい場合に指定する。プロパティの詳細はアイテム全体のプロパティの「Event」と同様。 利用時のプロパティ名:LEvent/MEvent/REvent
以下のプロパティは、DivTypeのコンテンツタイプ毎で設定できるプロパティです。
コンテンツタイプ「TEXT」
アイテムプロパティ名 (先頭にL/M/Rが付与します) | 説明
Text | 表示される文字。 利用時のプロパティ名:LText/MText/RText
TextOn | 指定すると、CheckStateの状態により、Off時にTextプロパティ、On時にTextOnプロパティに自動的に表示が切り替わる。 利用時のプロパティ名:LTextOn/MTextOn/RTextOn
TextColor | テキストの色。指定しないと、デフォルトでコントロールプロパティのTextColorプロパティの値が利用される。 利用時のプロパティ名:LTextColor/MTextColor/RTextColor
TextColorOn | 指定すると、CheckStateの状態により、Off時にTextColorプロパティ、On時にTextColorOnプロパティに自動的に表示が切り替わる。 利用時のプロパティ名:LTextColorOn/MTextColorOn/RTextColorOn
TextFont | テキスト表示のフォントサイズ。
LARGE | FontLargeプロパティで指定したフォントを利用する
MEDIUM | FontMediumプロパティで指定したフォントを利用する
SMALL | FontSmallプロパティで指定したフォントを利用する
利用時のプロパティ名:LTextFont/MTextFont/RTextFont
Desc | Textプロパティ文字列の下に表示されるディスクリプション。 利用時のプロパティ名:LDesc/MDesc/RDesc
DescFont | デスクリプションのフォントサイズ。
LARGE | FontLargeプロパティで指定したフォントを利用する
MEDIUM | FontMediumプロパティで指定したフォントを利用する
SMALL | FontSmallプロパティで指定したフォントを利用する
利用時のプロパティ名:LDescFont/MDescFont/RDescFont
コンテンツタイプ「BAR」
アイテムプロパティ名 (先頭にL/M/Rが付与します) | 説明
BarColor | CheckStateがOFFの時の、バーの色。 利用時のプロパティ名:LBarColor/MBarColor/RBarColor
BarColorOn | CheckStateがONの時の、バーの色。 利用時のプロパティ名:LBarColorOn/MBarColorOn/RBarColorOn
コンテンツタイプ「IMAGE」
アイテムプロパティ名 (先頭にL/M/Rが付与します) | 説明
Text | 表示される文字。 利用時のプロパティ名:LText/MText/RText
TextOn | 指定すると、CheckStateの状態により、Off時にTextプロパティ、On時にTextOnプロパティに自動的に表示が切り替わる。 利用時のプロパティ名:LTextOn/MTextOn/RTextOn
TextColor | テキストの色。指定しないと、デフォルトでコントロールプロパティのTextColorプロパティの値が利用される。 利用時のプロパティ名:LTextColor/MTextColor/RTextColor
TextColorOn | 指定すると、CheckStateの状態により、Off時にTextColorプロパティ、On時にTextColorOnプロパティに自動的に表示が切り替わる。 利用時のプロパティ名:LTextColorOn/MTextColorOn/RTextColorOn
TextFont | テキスト表示のフォントサイズ。
LARGE | FontLargeプロパティで指定したフォントを利用する
MEDIUM | FontMediumプロパティで指定したフォントを利用する
SMALL | FontSmallプロパティで指定したフォントを利用する
利用時のプロパティ名:LTextFont/MTextFont/RTextFont
Image | イメージファイルのパス。 利用時のプロパティ名:LImage/MImage/RImage
ImageOn | 指定すると、CheckStateの状態により、Off時にImageプロパティ、On時にImageOnプロパティに自動的に表示が切り替わる。 利用時のプロパティ名:LImageOn/MImageOn/RImageOn
ImageColor | イメージの色を変更したい際に設定する。 利用時のプロパティ名:LImageColor/MImageColor/RImageColor
ImageColorOn | イメージの色を変更したい際に設定する。CheckStateがOff時にImageColorプロパティ、On時にImageColorOnプロパティに表示が切り替わる。 利用時のプロパティ名:LImageColorOn/MImageColorOn/RImageColorOn
ImageSizeX | イメージやチェックマークのサイズ。なにも指定しないとDivSizeXで描画される。 利用時のプロパティ名:LImageSizeX/MImageSizeX/RImageSizeX
ImageSizeY | DivTypeがIMAGE,CHECKの時に描画されるイメージやチェックマークのサイズ。なにも指定しないとDivSizeYで描画される。 利用時のプロパティ名:LImageSizeY/MImageSizeY/RImageSizeY
ImageCircle | TRUE時、イメージの描画時に、円（楕円）でイメージがクリップされ表示される。 利用時のプロパティ名:LImageCircle/MImageCircle/RImageCircle
ImageCheckPos | イメージ上にチェックマークを表示したい場合に表示する位置を指定する。
NONE | 表示しない
CENTER | 真ん中
LEFTTOP | 左上。イメージ内
RIGHTTOP | 右上。イメージ内
LEFTBOTTOM | 左下。イメージ内
RIGHTBOTTOM | 右下。イメージ内
LEFTTOP2 | 左上。イメージ外
RIGHTTOP2 | 右上。イメージ外
LEFTBOTTOM2 | 左下。イメージ外
RIGHTBOTTOM2 | 右下。イメージ外
利用時のプロパティ名:LImageCheckPos/MImageCheckPos/RImageCheckPos
ImageTextPos | イメージの下にテキスト(Textプロパティ）やデスクリプション（Descプロパティ）を表示したい場合に指定する。
NONE | 表示しない
BOTTOM | テキストを表示
BOTTOM2 | テキストを表示。長い文字列は自動的に省略
BOTTOM_DESC | テキストとデスクリプションを表示。
BOTTOM_DESC2 | テキストとデスクリプションを表示。長い文字列は自動的に省略
利用時のプロパティ名:LImageTextPos/MImageTextPos/RImageTextPos
ImageSwitchingType | ON/OFFの状態によりアイコンイメージ(Imageプロパティ/ImageOnプロパティ）を切り替えたい場合に指定する。
CHECKSTATE | CheckStateのON/OFF状態によりアイコンイメージを切り替える
POPUPOPEN | ポップアップアイテムの場合、Open/Closeの状態によりアイコンイメージを切り替える
利用時のプロパティ名:LImageSwitchingType/MImageSwitchingType/RImageSwitchingType
SelectImageColor | メニューアイテムを選択したときのイメージの色 利用時のプロパティ名:LSelectImageColor/MSelectImageColor/RSelectImageColor
コンテンツタイプ「CHECK」
アイテムプロパティ名 (先頭にL/M/Rが付与します) | 説明
ImageSizeX | イメージやチェックマークのサイズ。なにも指定しないとDivSizeXで描画される。 利用時のプロパティ名:LImageSizeX/MImageSizeX/RImageSizeX
ImageSizeY | DivTypeがIMAGE,CHECKの時に描画されるイメージやチェックマークのサイズ。なにも指定しないとDivSizeYで描画される。 利用時のプロパティ名:LImageSizeY/MImageSizeY/RImageSizeY
CheckMarkType | 表示するチェックマークのタイプ。以下から指定。 NONE,CHECK,LARGECHECK,RECTCHECK,RECTCHECK2,CIRCLECHECK,CIRCLECHECK2,RECTLAMP,RECTLAMP2,CIRCLELAMP,CIRCLELAMP2,CROSS,LARGECROSS 利用時のプロパティ名:LCheckMarkType/MCheckMarkType/RCheckMarkType
MarkColor | チェックマークの色。指定しないと、デフォルトでルートのMarkColorプロパティの値が利用される。 利用時のプロパティ名:LMarkColor/MMarkColor/RMarkColor
MarkColorOn | 指定すると、CheckStateの状態により、Off時にMarkColorプロパティ、On時にMarkColorOnプロパティに自動的に表示が切り替わる。 利用時のプロパティ名:LMarkColorOn/MMarkColorOn/RMarkColorOn
MarkBackColor | チェックマークの背景色。何も指定しないと背景が塗りつぶされない。 利用時のプロパティ名:LMarkBackColor/MMarkBackColor/RMarkBackColor
コンテンツタイプ「COUNTER」
アイテムプロパティ名 (先頭にL/M/Rが付与します) | 説明
Text | 表示される文字。 利用時のプロパティ名:LText/MText/RText
TextOn | 指定すると、CheckStateの状態により、Off時にTextプロパティ、On時にTextOnプロパティに自動的に表示が切り替わる。 利用時のプロパティ名:LTextOn/MTextOn/RTextOn
TextColor | テキストの色。指定しないと、デフォルトでコントロールプロパティのTextColorプロパティの値が利用される。 利用時のプロパティ名:LTextColor/MTextColor/RTextColor
TextColorOn | 指定すると、CheckStateの状態により、Off時にTextColorプロパティ、On時にTextColorOnプロパティに自動的に表示が切り替わる。 利用時のプロパティ名:LTextColorOn/MTextColorOn/RTextColorOn
TextFont | テキスト表示のフォントサイズ。
LARGE | FontLargeプロパティで指定したフォントを利用する
MEDIUM | FontMediumプロパティで指定したフォントを利用する
SMALL | FontSmallプロパティで指定したフォントを利用する
利用時のプロパティ名:LTextFont/MTextFont/RTextFont
コンテンツタイプ「HYPERLINK」
アイテムプロパティ名 (先頭にL/M/Rが付与します) | 説明
Text | 表示される文字。 利用時のプロパティ名:LText/MText/RText
TextOn | 指定すると、CheckStateの状態により、Off時にTextプロパティ、On時にTextOnプロパティに自動的に表示が切り替わる。 利用時のプロパティ名:LTextOn/MTextOn/RTextOn
TextColor | テキストの色。指定しないと、デフォルトでコントロールプロパティのTextColorプロパティの値が利用される。 利用時のプロパティ名:LTextColor/MTextColor/RTextColor
TextColorOn | 指定すると、CheckStateの状態により、Off時にTextColorプロパティ、On時にTextColorOnプロパティに自動的に表示が切り替わる。 利用時のプロパティ名:LTextColorOn/MTextColorOn/RTextColorOn
TextFont | テキスト表示のフォントサイズ。
LARGE | FontLargeプロパティで指定したフォントを利用する
MEDIUM | FontMediumプロパティで指定したフォントを利用する
SMALL | FontSmallプロパティで指定したフォントを利用する
利用時のプロパティ名:LTextFont/MTextFont/RTextFont
Desc | Textプロパティ文字列の下に表示されるディスクリプション。 利用時のプロパティ名:LDesc/MDesc/RDesc
DescFont | デスクリプションのフォントサイズ。
LARGE | FontLargeプロパティで指定したフォントを利用する
MEDIUM | FontMediumプロパティで指定したフォントを利用する
SMALL | FontSmallプロパティで指定したフォントを利用する
利用時のプロパティ名:LDescFont/MDescFont/RDescFont
ポップアップアイテム特有のプロパティ
アイテムプロパティ名 | 説明
Open | オープンかクローズか
PopupType | popupアイテムのタイプ。デフォルトは「TREE」
TREE | クリックするとOpenとCloseが切り替わり、オープン時子アイテムがツリー形式で表示される。
PAGE | クリックするとOpenとCloseが切り替わり、オープン時子アイテムがページ形式で表示される。
OUTER | クリックするとOpenとCloseが切り替わり、オープン時子アイテムが右もしくは左外側にポップアップ表示される。
NewLine | Colsプロパティにて複数列を表示させた場合、ポップアップ表示毎に改行を行うか。デフォルトはTRUE。
ToggleOpen | マウスクリック時のポップアップのオープン状態の切り替えの許可。デフォルトはTREU。
PopupType「PAGE」
アイテムプロパティ名 | 説明
PageFillColor | ページタイトルの背景色。
PageLTextFont | ページタイトルの左側テキストのフォント。
PageLTextColor | ページタイトルの左側テキストの色。
PageMTextFont | ページタイトルの中央テキストのフォント。
PageMTextColor | ページタイトルの中央テキストの色。