Module: AMS::Menu

Defined in:
Documentation/ams/menu.rb

Overview

Note:

Windows only!

The Menu namespace contains functions associated with Windows menu.

Since:

  • 2.0.0

Class Method Summary collapse

Class Method Details

.endBoolean

Deactivate active context menu.

Returns:

  • (Boolean)

    success

See Also:

Since:

  • 2.0.0

.get_commands(handle, cur_path = "") ⇒ Hash<String, Fixnum>

Get menu commands.

Parameters:

  • handle (Fixnum)

    A handle to a valid menu or sub-menu.

  • cur_path (String) (defaults to: "")

    Current menu path.

Returns:

  • (Hash<String, Fixnum>)

    { path => id, … }

Since:

  • 2.0.0

.get_item_count(handle) ⇒ Fixnum

Get menu item count.

Parameters:

  • handle (Fixnum)

    A handle to a valid menu or sub-menu.

Returns:

  • (Fixnum)

    count

See Also:

Since:

  • 2.0.0

.get_item_id(handle, index) ⇒ Fixnum

Get menu item id by item position.

Parameters:

  • handle (Fixnum)

    A handle to a valid menu or sub-menu.

  • index (Fixnum)

Returns:

  • (Fixnum)

    Menu item identifier if successful or -1 if not.

See Also:

Since:

  • 2.0.0

.get_item_string_by_id(handle, id) ⇒ String?

Get menu item string by item identifier.

Parameters:

  • handle (Fixnum)

    A handle to a valid menu or sub-menu.

  • id (Fixnum)

Returns:

  • (String, nil)

    Menu item string if successful or nil if not.

See Also:

Since:

  • 3.0.0

.get_item_string_by_pos(handle, index) ⇒ String?

Get menu item string by item position.

Parameters:

  • handle (Fixnum)

    A handle to a valid menu or sub-menu.

  • index (Fixnum)

Returns:

  • (String, nil)

    Menu item string if successful or nil if not.

See Also:

Since:

  • 3.0.0

.get_sub_menu(handle, index) ⇒ Fixnum?

Get menu sub-menu handle by sub-menu position.

Parameters:

  • handle (Fixnum)

    A handle to a valid menu or sub-menu.

  • index (Fixnum)

Returns:

  • (Fixnum, nil)

    A handle to sub-menu if successful or nil if not.

See Also:

Since:

  • 2.0.0

.is_valid?(handle) ⇒ Boolean

Determine whether handle is a reference to a valid menu.

Parameters:

  • handle (Fixnum)

    A menu handle to be tested.

Returns:

  • (Boolean)

See Also:

Since:

  • 2.0.0

.set_item_string_by_id(handle, id, string) ⇒ Boolean

Set menu item string by item identifier.

Parameters:

  • handle (Fixnum)

    A handle to a valid menu or sub-menu.

  • id (Fixnum)
  • string (String)

Returns:

  • (Boolean)

    success

See Also:

Since:

  • 3.0.0

.set_item_string_by_pos(handle, index, string) ⇒ Boolean

Set menu item string by item position.

Parameters:

  • handle (Fixnum)

    A handle to a valid menu or sub-menu.

  • index (Fixnum)
  • string (String)

Returns:

  • (Boolean)

    success

See Also:

Since:

  • 3.0.0