operawatir 0.4.3.pre1-jruby → 0.5-jruby

data/lib/operawatir/quickwidgets/quick_label.rb

@@ -6,7 +6,7 @@ module OperaWatir
     def correct_type?
       @element.getType == WIDGET_ENUM_MAP[:label]
     end
-    
+
   end
 end
 

data/lib/operawatir/quickwidgets/quick_menu.rb

@@ -0,0 +1,155 @@
+module OperaWatir
+  class QuickMenu < QuickWidget #??
+    # @private
+    # Checks the type of the widget is correct
+    #def correct_type?
+    #  @element.getType == WIDGET_ENUM_MAP[:menu]
+    #end
+
+    # @private
+    # window_id is set if constructor is called on a (parent) window
+    # location if set is this is called on a (parent) widget
+    def initialize(container, method, selector=nil, location=nil)
+
+      @container = container
+
+      if method.is_a? Java::ComOperaCoreSystems::QuickMenu
+        @elm = method
+      else
+        @method    = method
+        @selector  = selector
+        @location  = location
+      end
+    end
+
+    ####################################################################
+    #
+    # @example
+    #   browser.quick_menu(:name, "Browser Button Menu Bar").name.should == "Browser Button Menu Bar"
+    #
+    # @return the name of the menu (as found in standard_menu.ini)
+    #
+    def name
+      element.getName
+    end
+
+
+    #######################################################################
+    #
+    # @return the window_id of the window the menu is attached to
+    #
+    # Note: This only makes sense for the menubars (and not on mac where there is
+    #           only one menubar)
+    # Note: This makes it possible to distinguish between menubars in different
+    #         main windows
+    #
+    # @example:
+    #   browser.quick_menu(:name, "Main Menu").window_id
+    #   browser.quick_window(:id, <id>).quick_menu(:name, "Browser File Menu")...
+    #
+    #
+    def window_id
+      element.getParentWindowId()
+    end
+
+    #######################################################################
+    #
+    # @return string representation of menu
+    #
+    def to_s
+      window = window_id > 0 ? "window_id #{window_id}" : ""
+      "QUICKMENU #{name} #{window}" # TODO: Add rect
+    end
+
+    ########################################################################
+    #
+    # @return width of widget
+    #
+    def width
+      element.getRect().width
+    end
+
+    ########################################################################
+    #
+    # @return height of widget
+    #
+    def height
+      element.getRect().height
+    end
+
+    #@private
+    def x
+      element.getRect().x
+    end
+
+    #@private
+    def y
+      element.getRect().y
+    end
+
+    ########################################################################
+    #
+    # @return true if this menu has one or more submenus
+    #
+    # @example
+    #     menu.should be_parentmenu
+    #
+    def parentmenu?
+      element.getItemList().each do |item|
+        if item.hasSubMenu()
+          return true
+        end
+      end
+      false
+    end
+
+    ########################################################################
+    #
+    # @return array of all menuitems in this menu
+    #
+    # @example:
+    #    menu.menuitems.select { |item| item.menu != menu.name }.should be_empty
+    #    menu.menuitems.each { | item | puts item.name }
+    #
+    def quick_menuitems
+      element.getItemList().map do |java_item|
+        QuickMenuItem.new(self,java_item)
+      end
+    end
+
+    ######################################################################
+    # Checks whether a widget exists or not
+    #
+    # @return [Boolean] true if the widget exists otherwise false
+    #
+    def exist?
+      !!element
+      rescue Exceptions::UnknownObjectException
+        false
+    end
+    alias_method :exists?, :exist?
+
+    private
+
+    # Finds the element on the page.
+    def find
+      #If @method set and we do new find because of refresh, we need to get @selector first
+      #Have the java object because the construct was done on it
+      #if @selector == nil && @elm != nil
+      #  set_selector
+      #end
+      #puts "\n<find> Find Menu by " + @method.to_s + ", " + @selector.to_s + ", " + @location.to_s
+      case @method
+      when :name
+        if @location != nil && @location >= 0
+          @element = driver.getQuickMenu(@selector, @location)
+        else
+          @element = driver.getQuickMenu(@selector)
+        end
+      end
+      raise(Exceptions::UnknownObjectException, "Element #{@selector} not found using #{@method}") unless @element
+      @element
+    end
+
+  end
+end

data/lib/operawatir/quickwidgets/quick_menuitem.rb

@@ -0,0 +1,387 @@
+module OperaWatir
+  class QuickMenuItem < QuickWidget #
+    # @private
+    # Checks the type of the widget is correct
+    #def correct_type?
+    #  @element.getType == WIDGET_ENUM_MAP[:menuitem]
+    #end
+
+    # @private
+    # window_id is set if constructor is called on a (parent) window
+    # location is set is this is called on a (parent) widget
+    def initialize(container, method, selector=nil, location=nil)
+
+      #puts "QuickMenuItem initialize method #{method}, selector #{selector}"
+
+      @container = container
+
+      if method.is_a? Java::ComOperaCoreSystems::QuickMenuItem
+        @elm = method
+      else
+        @method    = method
+        @selector  = selector
+        @location  = location
+      end
+    end
+
+    #########################################################################
+    #
+    # Returns the name of the menuitem. The name is either the action name
+    # of the action the item performs, or the name of the submenu the item
+    # opens. If the item is a separator, the name is "Separator"
+    #
+    # @example (RSpec)
+    #    menuitem.name.should == "Separator"
+    #    menuitem.name.should == "Close page" #action
+    #    menuitem.name.should == "Toolbar Popup Customize Menu" #submenu
+    #
+    # @return name of menuitem
+    #
+    def name
+      element.getName();
+    end
+
+    ##########################################################################
+    #
+    # @return name of the menu this menuitem is part of
+    #
+    # @example
+    #   browser.quick_menu(:name, "Browser File Menu").quick_menuitem(:text, "Open File").menu
+    #
+    #
+    def menu
+      element.getMenu()
+    end
+
+    ##########################################################################
+    #
+    # @return the text of this menu item
+    #
+    # (Note: this should normally not be used to access the item, as it will
+    #        be language dependent)
+    #
+    def text
+      element.getText()
+    end
+
+    ######################################################################
+    #
+    # @return true if element is a checkbox item that is checked, else false
+    #
+    def checked?
+      element.isChecked()
+    end
+
+    #####################################################################
+    #
+    # @return true if this menuitem has bold text, otherwise false
+    #
+    def bold?
+      element.isBold()
+    end
+
+    #####################################################################
+    #
+    # @return true if this menuitem is a separator, else false
+    #
+    def separator?
+      element.isSeparator()
+    end
+
+    #####################################################################
+    #
+    # @return true if this item is a command/action item
+    #
+    def action_item?
+      action.length > 0
+    end
+
+    #####################################################################
+    #
+    # @return true if this menuitem opens a submenu, otherwise false
+    #
+    def submenu_item?
+      element.hasSubMenu()
+    end
+
+    #####################################################################
+    #
+    # @return shortcutletter of this menuitem (typing this letter while the
+    #           menu is open, will select the item)
+    #
+    # @example (t is shortcutletter to open submenu below)
+    #    addressfield.open_menu_with_rightclick("Toolbar Edit Item Popup Menu")
+    #    browser.open_menu_with_key_press("Toolbar Popup Customize Menu", "t")
+    #
+    # (Note: not used on mac, so not a platform dependant feature)
+    def shortcutletter
+      element.getShortcutLetter()
+    end
+
+    #####################################################################
+    #
+    # @return the shortcut of this menuitem as a string
+    #
+    # browser.quick_menuitem(:action, "Close page").shortcut # Ctrl+W
+    #
+    def shortcut
+      element.getShortcut()
+    end
+
+    #####################################################################
+    #
+    # @return position of this menuitem within the menu, also counting
+    #           separators
+    #
+    # browser.quick_menu(:name, "Browser Tools Menu").quick_menuitem(:pos, 2).name.should == "Separator"
+    #
+    def pos
+      element.getRow()
+    end
+
+    #####################################################################
+    #
+    # @return the name of the action this item executes when selected
+    #
+    def action
+      element.getActionName()
+    end
+
+    ########################################################################
+    #
+    # @return the parameters to the action that will be used for the action
+    #         executed for this item when it is selected
+    #
+    def action_params
+      element.getActionParameter()
+    end
+
+    ##########################################################################
+    #
+    # @return the name of the submenu this item opens
+    #
+    # (Note: an item will either have a submenu, or an action)
+    #
+    def submenu
+      element.getSubMenu()
+    end
+
+
+    ########################################################################
+    #
+    # @return width of the menuitem
+    #
+    def width
+      element.getRect().width
+    end
+
+    ########################################################################
+    #
+    # @return height of the menuitem
+    #
+    def height
+      element.getRect().height
+    end
+
+    #@private
+    def x
+      element.getRect().x
+    end
+
+    #@private
+    def y
+      element.getRect().y
+    end
+
+    ########################################################################
+    # Hovers the menuitem and waits for the menu with menu_name to open
+    #
+    # @example
+    #    menu.quick_menuitem(:submenu, "Toolbar Popup Customize Menu").open_menu_with_hover("Toolbar Popup Customize Menu")
+    #
+    # @param [String] name of menu that will open
+    #
+    # @return name of menu opened if it matches menu_name parameter,
+    #           otherwise returns the empty string
+    #
+    def open_menu_with_hover(menu_name)
+      if mac_internal?
+        wait_start
+        press_menu
+        wait_for_menu_pressed
+      else
+        wait_start
+        element.hover
+        wait_for_menu_shown(menu_name)
+      end
+    end
+
+    ######################################################################
+    # Use to toggle a checkbox or radio item menuitem
+    #
+    def toggle_with_click
+      if mac_internal?
+        wait_start
+        press_menu
+        wait_for_menu_pressed
+      else
+        click
+
+        # Cheat since we don't have an event yet
+        sleep(0.1)
+      end
+    end
+
+    def to_s
+      "QUICKMENUITEM #{name}, pos #{pos}, menu #{menu}, rect: #{x}, #{y}, #{width}, #{height}, checked? #{checked?}, pos #{pos}, acckey #{shortcutletter}, #{shortcut unless shortcut.nil?}, separator #{separator?}"
+    end
+
+
+    ######################################################################
+    # Clicks the button, and waits for loading to finish
+    #
+    # @return [int] Window ID of the window shown or 0 if no window is shown
+    #
+    # @raise [DesktopExceptions::WidgetNotVisibleException] if the button
+    #            is not visible
+    #
+    def load_page_with_click
+      if mac_internal?
+        wait_start
+        press_menu
+        wait_for_menu_pressed
+        wait_start
+        # Just wait for the load
+        wait_for_window_loaded("")
+      else
+        wait_start
+        click
+        # Just wait for the load
+        wait_for_window_loaded("")
+      end
+    end
+
+    ######################################################################
+    # Clicks the button, and waits for the window with window name
+    # win_name to be shown
+    #
+    # @param [String] win_name name of the window that will be opened (Pass a blank string for any window)
+    #
+    # @return [int] Window ID of the window shown or 0 if no window is shown
+    #
+    # @raise [DesktopExceptions::WidgetNotVisibleException] if the button
+    #            is not visible
+    #
+    def open_window_with_click(win_name)
+      if mac_internal?
+        wait_start
+        press_menu
+        wait_for_menu_pressed
+        wait_start
+        wait_for_window_shown(win_name)
+      else
+        wait_start
+        click
+        wait_for_window_shown(win_name)
+      end
+    end
+    alias_method :open_dialog_with_click, :open_window_with_click
+
+
+    ######################################################################
+    # Clicks item and waits for the menu to close
+    #
+    # @return name of menu closed
+    #
+    def close_menu_with_key_press(menu_name, key, *modifiers)
+      wait_start
+      key_press_direct(key, *modifiers)
+      wait_for_menu_closed(menu_name)
+    end
+
+    ######################################################################
+    # Clicks the item, and waits for the menu with menu with name
+    # menu_name to be shown
+    #
+    # @param [String] name of menu that should open
+    #
+    # @raise [DesktopExceptions::WidgetNotVisibleException] if the button
+    #            is not visible
+    #
+    # @return name of menu opened if it matches menu_name (or if menu_name is ""),
+    #             otherwise returns empty string
+    #
+    def open_menu_with_click(menu_name)
+      if mac_internal?
+        wait_start
+        press_menu
+        wait_for_menu_pressed
+      else
+        wait_start
+        click
+        wait_for_menu_shown(menu_name)
+      end
+    end
+
+    ######################################################################
+    # Clicks item and waits for the menu to close
+    #
+    # @return name of menu closed
+    #
+    def close_menu_with_click(menu_name)
+      wait_start
+      click
+      wait_for_menu_closed(menu_name)
+    end
+
+    private
+
+    # Finds the element on the page.
+    def find
+      #If @method set and we do new find because of refresh, we need to get @selector first
+      #Have the java object because the construct was done on it
+      #if @selector == nil && @elm != nil
+      #  set_selector
+      #end
+      #puts "\n<find MenuItem> Find MenuItem by " + @method.to_s + ", " + @selector.to_s + ", " + @location.to_s
+      case @method
+        # action or submenu name?
+      when :name
+        if @location.class == Fixnum && @location >= 0
+          @element = driver.getQuickMenuItemByName(@selector, @location)
+        else
+          @element = driver.getQuickMenuItemByName(@selector)
+        end
+      when :action
+        @element = driver.getQuickMenuItemByAction(@selector)
+      when :submenu
+        @element = driver.getQuickMenuItemBySubmenu(@selector)
+      when :text
+        @element = driver.getQuickMenuItemByText(@selector)
+      when :pos # only row
+        @element = driver.getQuickMenuItemByPosition(@selector, @location)
+      when :acckey
+        @element = driver.getQuickMenuItemByAccKey(@selector, @location)
+      when :shortcut
+        @element = driver.getQuickMenuItemByShortcut(@selector)
+      when :string_id
+        @element = driver.getQuickMenuItemByStringId(@selector)
+      end
+
+      raise(Exceptions::UnknownObjectException, "Element #{@selector} not found using #{@method}") unless @element
+      @element
+    end
+
+    # Presses a menu on Mac where you can't click them
+    def press_menu
+      driver.pressQuickMenuItem(text, false);
+    end
+
+    # Waits for the menu to be pressed
+    def wait_for_menu_pressed
+      name = driver.waitForMenuItemPressed(text)
+      name
+    end
+
+  end
+end