ラジアルメニュー

ラジアルメニューにはグローバルメニューがあり、デフォルトではzと表示され、少なくとも 1 つの項目がある場合にのみ表示される。
グローバルメニューから項目を追加したり削除したりするにはlib.addRadialItemそしてlib.removeRadialItem.
用途lib.registerRadialを使ってサブメニューを作成しmenuプロパティでサブメニューを開きます。

lib.addRadialItem

グローバルラジアルメニューに追加される項目または項目の配列。

Lua


lib.addRadialItem(items)

の項目がある：table(objectまたはarray)
- id.K.である：string
  - オプションの削除に使用される ID。
- のアイコンがある：string
  - フォント名かカスタム URI.1
- iconWidth?number
- iconHeight?number
  - カスタム URI の場合は、アイコンのサイズを調整する。
- のラベルが貼られている：string
  - ラベルの用途 \n改行を挿入する
- メニューは？string
  - 開くメニューの ID。
- を選択する：function(currentMenu: string | nil, itemIndex: number)|string
  - ユーザーがアイテムをクリックしたときに実行される関数。
- keepOpen？boolean

lib.removeRadialItem

グローバルメニューから削除する項目の ID。

Lua


lib.removeRadialItem(item)

id.K.である：string

lib.clearRadialItems

ラジアルメニューからすべての項目を削除する。

Lua


lib.clearRadialItems()

lib.registerRadial

あらかじめ定義されたオプションを持つ放射状のサブメニューを登録する。

Lua


lib.registerRadial(radial)

ラジアル：table(object)
- id.K.である：string
  - で開くためのユニークなメニュー IDmenuアイテムのプロップ。
- の項目がある：array
  - のアイコンがある：string
  - のラベルが貼られている：string
    - ラベルの用途 \n改行を挿入する
  - メニューは？string
    - 開くメニューの ID。
  - onSelect?function(currentMenu: string | nil, itemIndex: number)|string
    - ユーザーがアイテムをクリックしたときに実行される関数。

lib.hideRadial

ラジアルメニューが開いている場合は非表示にする。

Lua


lib.hideRadial()

lib.disableRadial

ラジアルメニューを開けないようにする。

Lua


lib.disableRadial(state)

の状態だ：boolean
- ラジアルメニューを無効にするかどうか

lib.getCurrentRadialId

現在開いているラジアルメニューの ID を返します。

Lua


local id = lib.getCurrentRadialId()

使用例

ラジアルメニューの項目を追加するときは、それがグローバルなものであれ、サブメニューのものであれ、できるだけ短いラベルにこだわってください。長いラベルは場違いな印象を与えるので、ラジアルメニューでは使用しないこと。

以下は、いくつかのグローバルオプションと、リブのポイントシステムを利用したオプションの使用例です。

Lua


exports('myMenuHandler', function(menu, item)
    print(menu, item)
 
    if menu == 'police_menu' and item == 1 then
        print('Handcuffs')
    end
end)
 
lib.registerRadial({
  id = 'police_menu',
  items = {
    {
      label = 'Handcuff',
      icon = 'handcuffs',
      onSelect = 'myMenuHandler'
    },
    {
      label = 'Frisk',
      icon = 'hand'
    },
    {
      label = 'Fingerprint',
      icon = 'fingerprint'
    },
    {
      label = 'Jail',
      icon = 'bus'
    },
    {
      label = 'Search',
      icon = 'magnifying-glass',
      onSelect = function()
        print('Search')
      end
    }
  }
})
 
lib.addRadialItem({
  {
    id = 'police',
    label = 'Police',
    icon = 'shield-halved',
    menu = 'police_menu'
  },
  {
    id = 'business_stuff',
    label = 'Business',
    icon = 'briefcase',
    onSelect = function()
      print("Business")
    end
  }
})
 
local coords = GetEntityCoords(cache.ped)
local point = lib.points.new(coords, 5)
 
function point:onEnter()
  lib.addRadialItem({
    id = 'garage_access',
    icon = 'warehouse',
    label = 'Garage',
    onSelect = function()
      print('Garage')
    end
  })
end
 
function point:onExit()
  lib.removeRadialItem('garage_access')
end

radial1 radial2