FRAME-NAME function

Returns the name of the frame that the cursor is in to a field that is enabled for input.

This procedure displays Customer information in one frame, then displays Order information for the Customer in a second frame. Use the FRAME-NAME function to display the name of the frame the cursor is in.

FRAME-NAME

r-frname.p
FOR EACH Customer, EACH Order OF Customer: DISPLAY Order.OrderNum WITH CENTERED ROW 2 FRAME onum. UPDATE Customer.CustNum AT 5 Customer.Name AT 30 SKIP WITH FRAME custfrm WITH CENTERED 1 DOWN EDITING: DISPLAY " You are currently editing a frame called " FRAME-NAME WITH FRAME d1 WITH 1 DOWN CENTERED. READKEY. APPLY LASTKEY. IF LASTKEY = KEYCODE("RETURN") THEN MESSAGE " Press the space bar to edit order shipdate". END. /* Editing / HIDE FRAME custfrm. HIDE FRAME d1. UPDATE Order.ShipDate AT 5 WITH FRAME orderfrm WITH CENTERED 1 DOWN EDITING: DISPLAY " Now you are editing a frame called" FRAME-NAME* WITH FRAME d2 WITH 1 DOWN CENTERED. READKEY. APPLY LASTKEY. END. HIDE FRAME orderfrm. HIDE FRAME d2. END.

r-frname.p

FOR EACH Customer, EACH Order OF Customer: 
  DISPLAY Order.OrderNum WITH CENTERED ROW 2 FRAME onum. 
  UPDATE Customer.CustNum AT 5 Customer.Name AT 30 SKIP 
    WITH FRAME custfrm WITH CENTERED 1 DOWN EDITING: 
    DISPLAY " You are currently editing a frame called " FRAME-NAME  
      WITH FRAME d1 WITH 1 DOWN CENTERED. 
    READKEY. 
    APPLY LASTKEY. 
    IF LASTKEY = KEYCODE("RETURN") THEN 
      MESSAGE " Press the space bar to edit order shipdate". 
  END. /* Editing */ 
  HIDE FRAME custfrm. 
  HIDE FRAME d1. 
  UPDATE Order.ShipDate AT 5  
    WITH FRAME orderfrm WITH CENTERED 1 DOWN EDITING: 
    DISPLAY " Now you are editing a frame called" FRAME-NAME  
      WITH FRAME d2 WITH 1 DOWN CENTERED. 
    READKEY. 
    APPLY LASTKEY. 
  END. 
  HIDE FRAME orderfrm. 
  HIDE FRAME d2. 
END.

The FRAME-NAME function returns an empty string for a frame that has not been named (the default frame). It also returns an empty string if the cursor is in a field that is not enabled for input.

When using the FRAME-NAME function, you must place it logically following the Frame phrase where it is named.

FRAME-NAME is especially useful for context-sensitive help.