--:-- LUA API

ウィジェット種別一覧

pico.createで生成できる種別と、生成直後の初期値

pico.create で生成できる28種別

生成直後の位置・大きさは仮の値です。実際に配置する前に pico.set で x/y/w/h 等を設定してください。

type_name生成直後の状態対応プロパティ(抜粋)
"Button"x=0, y=0, text=""text, w, h(枠を含む全体の大きさ), font_size, text_color, border_color, icon_id, icon_size(アイコンボタン化)
"Label"x=0, y=0, text=""text, placeholder, font_size, text_color, border_color, max_width, max_height, text_align
"Textbox"x=0, y=0, w=100, h=24, 単一行text, placeholder, font_size, text_color, border_color, max_width, max_height, is_single_line
"NumberInput"x=0, y=0, w=60text(入力された数字文字列), font_size, text_color, border_color
"Checkbox"x=0, y=0, text=""text, checked, font_size, text_color
"Icon"x=0, y=0, ICON_AppBox, 16pxicon_id, icon_size, color, icon_opaque
"Image"x=0, y=0, path="" (未設定は何も描かない)path
"NumberSlider"x=0, y=0, w=100value, min_value, max_value, w, h, color, visible_num, decimal_places
"ScrollContainer"x=0, y=0, 100×100w, h, border_color, scroll_x, scroll_y, max_scroll_x, max_scroll_y(読み取り専用)
"ScrollList"x=0, y=0, 100×100w, h, font_size, text_color, border_color, selected_index, enable_icon, item_count(読み取り専用)
"CanvasRaster"x=0, y=0, 100×100w, h, color, brush_radius, canvas_mode, filled, undo_enabled
"LayoutContainer"x=0, y=0, 100×100w, h, direction, cross_align, gap, padding
"GridContainer"x=0, y=0, 100×100, 2列w, h, cols, gap, padding, h_align, v_align
"TabBar"x=0, y=0, w=100, h=24, タブ0個w, h, tab_selected, tab_count(読み取り専用), font_size, border_color
"DropdownMenu"x=0, y=0, w=100, 項目0個w, selected_index, item_count(読み取り専用)
"Canvas"x=0, y=0, 50×50w, h(描画はrenderイベントで行う)
"Rect"x=0, y=0, 40×24w, h, color, filled, thickness
"Ellipse"x=0, y=0, 40×24w, h, color, filled, thickness
"Line"(0,0)-(40,24)color, thickness, x1, y1, x2, y2
"Triangle"(0,20)/(20,0)/(40,20)color, filled, thickness, x1, y1, x2, y2, x3, y3
"ProgressBar"x=0, y=0, 100×12(タップは素通り)w, h, value, min_value, max_value, color, border_color
"QRCode"x=0, y=0, 100×100(タップは素通り)w, h, text(QRにする文字。255Bまで。長さの分からない文字はpico.text_set), ecc, color, qr_size(読み取り専用)
"TextView"x=0, y=0, 100×100w, h, text(255Bまで。長文はpico.text_set), scroll_y, row_count(読み取り専用)
"ImageView"x=0, y=0, 100×100w, h, path(.pimg), image_w, image_h(読み取り専用)
"MarkdownView"x=0, y=0, 100×100(約40KB使うので1アプリに1つまで)w, h, path, text(255Bまで。長文はpico.text_set), scroll_y
"AnalogClock"x=0, y=0, 直径100w/h(=直径), hour, minute, second, hand_color, second_hand_color
"DurationPicker"x=0, y=0, 150×60w, h, total_ms, editable, font_size, text_color, border_color
"MonthGrid"x=0, y=0, 210×150w, h, year, month, today, selected, border_color, item_count(その月の日数・読み取り専用)

図形ウィジェット4種(Rect/Ellipse/Line/Triangle)の詳しい使い方は 図形ウィジェット を参照してください。

TextView / MarkdownView は長い文章を軽く表示できます(見えている行だけを描きます)。MarkdownView は1つで約40KBのメモリを使うので、1つのアプリに1つまでにしてください。ImageView はスクロールできる画像で、大きな画像でも表示欄ぶんのメモリしか使いません。

全プロパティの詳細は プロパティ対応表 を、共通/固有イベントは イベント対応表 を参照してください。

ダイアログ

ダイアログは pico.create では作れません。pico.show_* で開きます(ダイアログ)。

開く関数ダイアログ
pico.show_messageメッセージとボタン
pico.show_input文字の入力
pico.show_number数字の入力
pico.show_choice選択肢の一覧
pico.show_date / pico.show_time日付 / 時刻
pico.show_color16色から選ぶ
pico.show_file_select / pico.show_file_saveファイルを選ぶ / 保存先を選ぶ
pico.show_progress進み具合

Luaから作れないもの

ランチャのアイコン格子・電卓のキー・ファイル一覧・オンスクリーンキーボードなど、OSの画面専用の部品はLuaからは作れません。それらを使うOS標準のアプリ(電卓・ファイルなど)を開きたいときは pico.launch_app(name) を使ってください。