PANTALLA DE SELECCIN

5.1. PARAMETERS 5.2. SELECT-OPTIONS 5.3. SELECTION-SCREEN

5.1. PARAMETERS:

PARAMETERS parmetro [ (longitud) ] [ TYPE tipo | LIKE var ] [ DECIMALS num ][ DEFAULT valor ] [ MEMORY ID parm ] [ MODIF ID clave] [ FOR TABLE tabla][ NO-DISPLAY ] [ AS CHECKBOX ] [ LOWER CASE ] [ OBLIGATORY ][ RADIOBUTTON GROUP grupo ] [ MATCHCODE OBJECT objeto ][AS MATCHCODE STRUCTURE ] [ VALUE REQUEST ] [ HELP-REQUEST ]. Con esta sentencia se declara un parmetro en la pantalla de seleccin (es aquella, al principio de un programa, en la cual el usuario elige los criterios y condiciones con las que se va a ejecutar el programa). Un PARAMETERS permite que el usuario d un valor nico y concreto a un campo o variable del programa. Parmetros de esta sentencia: o TYPE tipo | LIKE var: Definicin del tipo del parmetro (deben tener un tipo, como las variables) de forma esttica (TYPE, dando un tipo) o dinmica (LIKE, toma el tipo de var). o DECIMALS num: N de decimales a mostrar (slo para PARAMETERS de tipo numrico). o DEFAULT se utiliza para asignar un valor por defecto al parmetro, antes del evento INITIALIZATION. Dicho valor aparecer en pantalla. El usuario puede cambiarlo si quiere. o MEMORY ID parm: Permite iniciar un parmetro con el contenido de una var. de memoria. o MODIF ID clave: La clave (de 3 caracteres mximo) es un grupo de modificacin. Esta opcin asocia un PARAMETERS a un grupo de modificacin que podr ser utilizado por las sentencias de modificacin de pantalla (como MODIFY SCREEN). Se da una clave a cada campo de la pantalla, y todos los campos que tengan igual clave (forman el grupo de modificacin) se tratarn conjuntamente, usando el campo del sistemaSCREEN-GROUP1 = clave. Esto es muy til para module pools. Ejemplo:

PARAMETERS: test1 (10) MODIF ID sc1, test2 (10) MODIF ID sc2.

AT SELECTION-SCREEN OUTPUT. PBO (por el OUTPUT)

"Evento

* Bucle que recorre todos los campos de la pantalla LOOP AT SCREEN. IF SCREEN-GROUP1 = 'SC1'. SCREEN-INTENSIFIED = '1'. MODIFY SCREEN. ENDIF. ENDLOOP.

o o o o o

NO-DISPLAY: Este PARAMETERSno ser visible, pero existe. Puede drsele valor usando la opcin DEFAULT, el evento INITIALIZATION, o al llamar al programa con SUBMIT (esta sentencia tiene opciones para dar valor a los parmetros del prog. llamado). AS CHECKBOX: Crea el parmetro con la apariencia y funcionalidad de un checkbox. LOWER-CASE: Permite distinguir en el parmetro caracteres en mayscula y minscula. Si no se especifica esta opcin, al pulsar ENTER se pasa el valor introducido a todo maysculas. OBLIGATORY: Este campo o parmetro ser obligatorio (debe drsele algn valor). RADIOBUTTON GROUPgrupo: Crea el parmetro como un botn de seleccin. Los botones van agrupados, de forma que en el mismo grupo de ellos slo se puede seleccionar 1. MATCHCODE OBJECT objeto. Asigna un objeto de matchcode a un parmetro, para que aparezca un matchcode que, al desplegarlo, nos muestre valores posibles para el campo. (mediante tabla de valores asociada). Como valor para el campo, se puede incluir como comodn el asterisco. Con F4 el efecto es el mismo.

5.2. SELECT-OPTIONS:

SELECT-OPTIONS criterio FOR campo [ DEFAULT v1 [ TO v2 ] [ OPTION o SIGN s] ][ MEMORY ID parm ] [ MODIF ID clave] [ NODISPLAY ] [LOWER CASE ][ OBLIGATORY ] [ NO-EXTENSION ] [ NO INTERVALS ] [ NO DATABASESELECTION ] [ MATCHCODE OBJECT objeto] [ VALUE REQUEST [ FOR LOW| HIGH ] ] [ HELP-REQUEST [ FOR LOW | HIGH ] ]. Con esta sentencia se declara un criterio de seleccin en la pantalla de seleccin. El nombre de dicho criterio debe tener 8 caracteres como mximo. Un SELECT-OPTIONS permite que el usuario d un rango de valores para un campo o variable, o bien varios intervalos, o bien uno o ms valores individuales, todo ello entremezclado como se desee. En las condiciones (en IF, opciones WHERE, CHECK, ) que involucren SELECT-OPTIONS se usa el operador IN, ya que chequea si un valor dado est o no en el(los) rango(s) del criterio de seleccin. La sentencia CHECK SELECT-OPTIONS equivale a CHECK var IN rango (para el SELECT-OPTIONS correspondiente). Parmetros de esta sentencia: o DEFAULT v1 [ TO v2 ] [ OPTION o SIGN s ]: Para indicar valores por defecto. v1 es el valor LOW, v2 es el valor HIGH. Para valores de seleccin simples, las OPTIONs vlidas son: EQ, NE, GE, GT, LE, LT, CP o NP (la opcin por defecto es EQ). Para intervalos de seleccin,

o o o o

las OPTIONs vlidas son BT (between) y NB (la opcin por defecto es BT). Los valores vlidos para SIGN son I (inclusive), E (exclusive). El valor por defecto esI. MEMORYID parmetro, MODIF ID clave, NO-DISPLAY, LOWERCASE, OBLIGATORY y MATCHCODE OBJECT objeto: Igual que enPARAMETERS. NO-EXTENSION: Limita el criterio de seleccin a una nica entrada en la tabla (o bien 1 valor individual, o 1 rango). Para ello elimina el icono que posibilita las entradas mltiples. NO INTERVALS: Limita el criterio de seleccin a valores simples, es decir, no admite rangos, aunque se pueden poner varios valores individuales. NO DATABASE SELECTION: El criterio de selec. no es utilizado en la base datos lgica.

5.3. SELECTION-SCREEN:

SELECTION-SCREEN [ POSITION pos ] [ FUNCTION KEY i] [ SKIP [ n ]][ BEGIN OF BLOCKbloque [WITH FRAME [ TITLEttulo ] ] [NO INTERVALS ] ][END OF BLOCKbloque] [ BEGIN OF LINE ] [ END OF LINE][ PUSHBUTTON [/] pos (long) nombre USER-COMMAND code [ MODIF ID clave ] ][COMMENT [ / ] pos (long) nombre [ FOR FIELD f ] [ MODIF ID clave ]][ ULINE [ [ / ] pos (long) ] [ MODIF ID clave ] ]. Esta sentencia se usa para cambiar la apariencia de la pantalla de seleccin. Permite colocar marcos, bloques, reorganizar los distintos elementos, ...No es el evento AT SELECTION-SCREEN. Slo se puede usar uno de sus parmetros a la vez, es decir, que para cada nuevo cambio hay que escribir una sentencia SELECTION SCREEN nueva. Slo se puede usar en reports (programas tipo 1). Parmetros: o POSITION pos: Sirve para colocar el cursor en una posicin determinada. Slo se puede usar anidado entre sentencias SELECTIONSCREEN BEGIN OF LINE y END OF LINE. o FUNCTION KEY i se usa para crear iconos en el men o barra de herramientas. Se pueden activar hasta 5 de ellos. Se decide cul ha pulsado el usuario chequeando el campo del sistema SY-UCOMM en el evento AT SELECTION-SCREEN. o SKIP [ n ]: Produce n lneas en blanco (una por defecto). o BEGIN OF BLOCK bloque : Sirve para crear bloques de elementos de pantalla (para agruparlos), los cuales se pueden anidar. La opcin WITH FRAME se usa para crear un marco visible que englobael bloque. Con TITLE se aade un ttulo identificativo en el marco creado. Con NO INTERVALSno se permite al usuario introducir intervalos en ningn campo de entrada del bloque (as no hace falta indicarlo por separado en cada uno de ellos). El bloque se cierra con END OF BLOCK, poniendo el mismo nombre para el bloque. o BEGIN OF LINE y END OF LINE: Estas dos opciones engloban un bloque de sentencias declarativas (PARAMETERS, SELECTOPTIONS y/oSELECTION-SCREEN) que aparecern en la misma lnea de la pantalla de seleccin, en lugar de en columna. o PUSHBUTTON : Sirve para crear iconos en la propia pantalla de seleccin. Con la opcin USER-COMMAND se le asocia un cdigo de funcin. Para asociar texto a un icono debe usarse una sentencia TABLES sscrfields. (tabla que contiene los campos de la

o o

pantalla). Para el botn llamado X...X poner: sscrfields-flnctxrt0x....x. COMMENT : Permite incluir comentarios en la pantalla de seleccin (textos, labels). ULINE : Permite dibujar lneas horizontales (con subrayados). Se puede asociar la lnea a un grupo de modificacin (como el resto de elementos de la pantalla de seleccin.