Purpose

This is the part II of the utilities Java Bean.



A second tab allows to manipulate some Text field properties.

  . You can set dynamically the maximum of  charaters the user can enter.
  . You can also set the cursor blink rate and the cursor style.


The Java code

      FJTextField.java


The Implementation Class property

      forms.fd.utilities.FJTextField


The properties you can set

The maximum characters the user can enter

Set_Custom_Property( 'BL.BEAN', 1, 'SETMAX', 'max_length' ) ;

The cursor blink rate

Set_Custom_Property( 'BL.BEAN', 1, 'SETBLINKRATE', 'value' ) ;

100 is very fast and 800 is very slow

The cursor style

Set_Custom_Property( 'BL.BEAN', 1, 'SETCURSOR', 'style' ) ;

Where style can be one of the following:

   . DEFAULT
   . HAND
   . CROSS
   . MOVE
   . TEXT
   . WAIT


The sample dialog

     . Download the utilities.zip file
     . Unzip the file
     . copy the fjutilities.jar file in the <ORACLE_HOME>/forms/java directory
     . Edit your /forms/server/formsweb.cfg file
     . Open the UTILITIES.fmb module (Oracle Forms 9.0.2)
     . Compile all and run the module

Purpose

This is a JavaBean that allows to handle a "HTML Map" in a Forms application.




The Java code

      MapComponent.java      zone.java


The Implementation Class property

      oracle.forms.fd.MapComponent


The properties you can set

Set a polygonal area

Set_Custom_Property('BL.BEAN',1, 'SETPOLYGON','name,url,coordinates_pairs');

e.g.
Set_Custom_Property('BL.BEAN',1, 'SETPOLYGON','Region1,url1,284,128,272,353,178,361,166,342,133');

Set a rectangular area

Set_Custom_Property('BL.BEAN',1, 'SETRECT','name,url,x,y,width,height');

name is the name that identify each area. this name is get from the GetProperty(NAME)
url is the area url (must be specified but not used in this version)

Set the background image

Set_Custom_Property('BL.BEAN',1, 'SETIMAGE','image_name' );

Image from JAR file:
Set_Custom_Property('BL.BEAN',1, 'SETIMAGE','/france.jpg' );

Image from client machine:
Set_Custom_Property('BL.BEAN',1, 'SETIMAGE','file:///d:/france.jpg' );

Image from internet url:
Set_Custom_Property('BL.BEAN',1, 'SETIMAGE','http://sheikyerbouti.developpez.com/tmp/france.jpg' );


Set the selected area color

Set_Custom_Property('BL.BEAN',1, 'SETFONTCOLOR','r,g,b' );

Set_Custom_Property('BL.BEAN',1, 'SETFONTCOLOR','255,0,100' );


The properties you can get

The area selected (clicked)

Varchar2 := Get_Custom_Property('BL.BEAN',1, 'NAME');


The events you can raise

An area has been clicked

      ZONECLICKED

The sample dialog

     . Download the map.zip file
     . Unzip the file
     . copy the fjmap.jar file in the <ORACLE_HOME>/forms/java directory
            the jar file must be signed
     . Edit your /forms/server/formsweb.cfg file
     . Open the MAP.fmb module (Oracle Forms 9.0.2)
     . Compile all and run the module


Different display of the selected area

You can "tune" the display()  function to change the display of the selected area:




 /*************************************
  *  Show/Hide the selected map part  *
  ************************************/
 void display(int iNum, boolean b) {
  float fArea = 0.1f, fText = 0.9f;
  g2 = (Graphics2D) this.getGraphics();
  String sName="" ;
  if(g2 != null && iNum >= 0)
  {
    g2.setColor(Color.white);
    g2.clearRect((int)jp.getX(),(int)jp.getY(),(int)jp.getWidth(),(int)jp.getHeight());
    image.paintIcon(null,g2,0,0);
    if(b)
    {
      // draw the selected area
      g2.setComposite(AlphaComposite.SrcOver);
      AlphaComposite ac = AlphaComposite.getInstance(AlphaComposite.SRC_OVER, fArea);
      g2.setComposite(ac);
      g2.setColor(cFontColor);
      g2.fillPolygon(tz[iNum].p);
      ac = AlphaComposite.getInstance(AlphaComposite.SRC_OVER, fText);
      g2.setComposite(ac);
      g2.setColor(Color.black);
      sName = tz[iNum].name ;
     
      Font font = new Font("Arial",Font.BOLD,14);
      FontRenderContext frc = g2.getFontRenderContext();
      TextLayout layout = new TextLayout(tz[iNum].name, font, frc);
      Rectangle2D bounds = layout.getBounds();
      // draw the text bouding box
      g2.drawRect((int)((tz[iNum].r.getX()+(tz[iNum].r.getWidth()/2))-2),
                  (int)((tz[iNum].r.getY()+(tz[iNum].r.getHeight()/2))-(int)bounds.getHeight()),
                  (int)(bounds.getWidth()+4),
                  (int)(bounds.getHeight()+4));
      g2.setColor(Color.white);
      g2.fillRect((int)((tz[iNum].r.getX()+(tz[iNum].r.getWidth()/2))-2),
                  (int)((tz[iNum].r.getY()+(tz[iNum].r.getHeight()/2))-(int)bounds.getHeight()),
                  (int)(bounds.getWidth()+4),
                  (int)(bounds.getHeight()+4));
      g2.setColor(cFontColor);     
      g2.setFont(font);
      g2.drawString(tz[iNum].name,
      (int)(tz[iNum].r.getX()+(tz[iNum].r.getWidth()/2)),
      (int)(tz[iNum].r.getY()+(tz[iNum].r.getHeight()/2)));
    }
  }
 }

Purpose

This JavaBean allows to find and handle the form windows (current window and MDI window).
With this handle, you can set some particular properties like the following:

   . setMovable()*
   . setClosable()*
   . setMaximizable()*
   . setMinimizable()*
   . setModal()*
   . setResizable()
   . setVisible()
   . enable()*
   . disable()*
   . setToolTipValue()*
   . setIcon()
   . setExtendedState() (only with SE 4.0)
   . setAlwaysOnTop() (only with SE 5.0)

    * You cannot apply this function on the MDI frame.



How to find the frames ?

You can recursively find the different layers with the getParent() function.

      Container container = this.getParent();
      while (container!=null)
      {
        // output the object hierarchy
        System.out.println("--> "+container.getName()+" ["+container.getClass()+"]") ;
        container = container.getParent() ;
      }

The FORMSFRAMES.fmb sample module shows, in the Java console, the list of all the layers.


The application Forms window class name is oracle.forms.ui.ExtendedFrame      
The application Forms MDI window class name is oracle.ewt.swing.JBufferedFrame

Notice that in future version, this class names may change.


The Java code

     formsframe.java

     The JAR file must be signed

The properties you can set

set the frame structure info
Set_Custom_Property('BL.BEAN',1, 'INFO','' ) ;

movable()
Set_Custom_Property( 'BL.BEAN', 1, 'SET', 'MOVE,true|false' ) ;

closable()
Set_Custom_Property( 'BL.BEAN', 1, 'SET', 'CLOSE,true|false' ) ;

maximizable()
Set_Custom_Property( 'BL.BEAN', 1, 'SET', 'MAX,true|false' ) ;

minimizable()
Set_Custom_Property( 'BL.BEAN', 1, 'SET', 'MIN,true|false' ) ;

resizable()
Set_Custom_Property( 'BL.BEAN', 1, 'SET', 'SIZE,true|false' ) ;

disable()
Set_Custom_Property( 'BL.BEAN', 1, 'SET','DISABLE' ) ;  

set icon for standar or MDI frame
Set_Custom_Property( 'BL.BEAN', 1, 'SETICON','target,icon_name' ) ;

    -- Set the MDI icon --
  Set_Custom_Property('BL.BEAN',1, 'SETICON','MDI,/indxicon.gif' ) ;
  
  -- Set the internal window icon --
  Set_Custom_Property('BL.BEAN',1, 'SETICON','WIN,/oracle.gif' ) ;


maximize the MDI frame (works only with the Sun Java Plug-in JRE 1.4)
Set_Custom_Property( 'BL.BEAN', 1, 'SETMAXSIZE','true|false' ) ;

Set the window always on top (works only with the Sun Java Plug-in JRE 1.5)
Set_Custom_Property( 'BL.BEAN', 1, 'SETONTOP','true|false' ) ;
(if you want to use this property, use the formsframes5.jar file instead of the formsframes.jar)


In this demo, 2 icon files are stored in the root of the jar file (indxicon.gif and oracle.gif)


The sample dialog

     . Download the formsframes.zip file
     . Unzip the file
     . copy the formsframes.jar file in the <ORACLE_HOME>/forms/java directory
       (or the formsframes5.jar if you use the 1.5 JRE)
         the jar file must be signed
     . Edit your /forms/server/formsweb.cfg file
     . Open the FORMSFRAMES.fmb module (Oracle Forms 9.0.2)
     . Compile all and run the module

     Open the Java console to see the whole frame structure of the Forms module

Purpose

Sometimes I find questions on forums on how to handle frames at runtime.
Of course, at this moment (10gR2), there is no built-in available.
This is a workaround that allows to create and handle frames at runtime.




The Java code

Get the full source code here

Implementation Class property

     oracle.forms.fd.frame

Note : The frame is not displayed inside the Forms JavaBean component, so you can set its Mouse and Keyboard navigation properties to NO.

The properties you can set

(properties with bold font are required.)

Create a new frame

Set_Custom_Property( 'BLK.BEAN', 1, 'INIT_FRAME', 'v1,...,vn' ) ;

type : line or lowered
line width : width of the line in pixels
title
font name
font size
weight :
     . N ormal
     . I talic
     . B old
     . BI bold + italic
Alignment:
     . left
     . center
     . right

The font of the title frame

Set_Custom_Property( 'BLK.BEAN', 1, 'SET_FONT', 'name[,size[,weight[,alignment]]]' ) ;

font name
font size
weight :
     . N ormal
     . I talic
     . B old
     . BI bold + italic
Alignment:
     . left
     . center
     . right

The frame title color

Set_Custom_Property( 'BLK.BEAN', 1, 'SET_FRAME_TITLE_COLOR', 'r,g,b' ) ;

The frame background color

Set_Custom_Property( 'BLK.BEAN', 1, 'SET_BACKGROUND', 'r,g,b' ) ;

The frame bounds

Set_Custom_Property( 'BLK.BEAN', 1, 'SET_BOUNDS', 'x,y,w,h' ) ;

x : x position in pixel on the canvas
y : y position in pixel on the canvas
w : width in pixel
h : height in pixel

Set the title

Set_Custom_Property( 'BLK.BEAN', 1, 'SET_TEXT', 'title[,alignment]' ) ;

title
alignment :
     . left
     . center
     . right


Hide the frame

Set_Custom_Property( 'BLK.BEAN', 1, 'HIDE', '' ) ;


Show the frame

Set_Custom_Property( 'BLK.BEAN', 1, 'SHOW', '' ) ;



The sample dialog

     . Download the frame.zip file
     . Unzip the file
     . copy the frame.jar file in the <ORACLE_HOME>/forms/java directory
     . Edit your /forms/server/formsweb.cfg file
     . Open the FRAME.fmb module (Oracle Forms 9.0.2)
     . Compile all and run the module