manual ibm

528
AS/400e VisualAge ® RPG Manual de consulta de componentes Versión 4.5.1 para Windows ® SC10-3065-04 IBM

Upload: antokaje

Post on 20-Jun-2015

394 views

Category:

Documents


2 download

TRANSCRIPT

Page 1: Manual Ibm

AS/400e™

VisualAge® RPGManual de consulta de componentesVersión 4.5.1 para Windows®

SC10-3065-04

IBM

Page 2: Manual Ibm
Page 3: Manual Ibm

AS/400e™

VisualAge® RPGManual de consulta de componentesVersión 4.5.1 para Windows®

SC10-3065-04

IBM

Page 4: Manual Ibm

ImportanteAntes de utilizar esta información y el producto al que da soporte, asegúrese de leer la información general que figura en elapartado “Avisos” en la página 507.

Quinta edición (Abril 2000)

Esta edición se aplica a la Versión 4, Release 5, Nivel de modificación 1, de IBM WebSphere Development Toolspara AS/400 (Programa 5769-CL3) y a todos los releases y modificaciones posteriores hasta que se indique locontrario en nuevas ediciones.

Esta edición sustituye a la publicación SC10-3065-03.

Los cambios y adiciones realizados en el texto y en las ilustraciones vienen indicados por una línea vertical a laizquierda del cambio o adición.

Puede efectuar pedidos de publicaciones a su representante de IBM o en la sucursal de IBM de su localidad. En ladirección que figura más abajo no hay existencias de publicaciones.

IBM agradece sus comentarios. Puede enviar los comentarios a:

IBM, S.A.National Language Solutions CenterAvda. Diagonal, 57108029 BarcelonaEspaña

También puede enviar sus comentarios a IBM electrónicamente o por fax (a la atención del coordinador RCF).Consulte el apartado “Cómo enviar comentarios” en la página xi para ver una descripción de los métodos.

Cuando envía información a IBM, otorga a IBM un derecho no exclusivo de utilizar o distribuir dicha informacióndel modo que crea oportuno sin incurrir en ninguna obligación hacia usted.

© Copyright International Business Machines Corporation 1994, 2000. Reservados todos los derechos.

Page 5: Manual Ibm

Contenido

Acerca de este manual . . . . . . . . ixConvenios de resaltado que se utilizan en estemanual . . . . . . . . . . . . . . . . ixRequisito previo e información relacionada . . . . ixLa biblioteca VisualAge RPG. . . . . . . . . ixCómo enviar comentarios . . . . . . . . . . xiAcceso a la información en línea . . . . . . . xi

Utilización de manuales en línea . . . . . . xiPublicaciones en formato PDF . . . . . . . xiUtilización de ayuda en línea . . . . . . . xii

Novedades de este Release . . . . . . xv

Capítulo 1. Componentes . . . . . . . 1ActiveX . . . . . . . . . . . . . . . . 1Control de animación . . . . . . . . . . . 3Calendario . . . . . . . . . . . . . . . 4Lienzo . . . . . . . . . . . . . . . . 5Recuadro de selección . . . . . . . . . . . 7Recuadro de combinación . . . . . . . . . . 8*Component . . . . . . . . . . . . . . 10Referencia a componente lógico. . . . . . . . 11Contenedor . . . . . . . . . . . . . . 12Cliente DDE . . . . . . . . . . . . . . 13Campo de entrada . . . . . . . . . . . . 14Gráfica . . . . . . . . . . . . . . . . 16Pulsador gráfico . . . . . . . . . . . . . 17Recuadro de grupo . . . . . . . . . . . . 19Barra de desplazamiento horizontal . . . . . . 20Imagen . . . . . . . . . . . . . . . . 21Bean Java . . . . . . . . . . . . . . . 23Recuadro de lista . . . . . . . . . . . . 24Medios . . . . . . . . . . . . . . . . 25Panel de medios . . . . . . . . . . . . . 26Barra de menús . . . . . . . . . . . . . 27Elemento de menú . . . . . . . . . . . . 28Subarchivo de mensajes . . . . . . . . . . 29Edición de múltiples líneas . . . . . . . . . 30Cuaderno . . . . . . . . . . . . . . . 31Página de cuaderno . . . . . . . . . . . 32Página de cuaderno con lienzo . . . . . . . . 33Interfaz ODBC/JDBC . . . . . . . . . . . 34Recuadro de contorno . . . . . . . . . . . 36Menú emergente. . . . . . . . . . . . . 37Barra de progreso . . . . . . . . . . . . 38Pulsador . . . . . . . . . . . . . . . 39Botón de selección . . . . . . . . . . . . 40Graduador . . . . . . . . . . . . . . 41Selector cíclico . . . . . . . . . . . . . 42Texto estático . . . . . . . . . . . . . . 43Barra de estado . . . . . . . . . . . . . 44Subarchivo . . . . . . . . . . . . . . 45Submenú . . . . . . . . . . . . . . . 46Temporizador . . . . . . . . . . . . . 47Barra de desplazamiento vertical . . . . . . . 48

Ventana. . . . . . . . . . . . . . . . 49Ventana con lienzo . . . . . . . . . . . . 50

Capítulo 2. Atributos de componente 51Activate . . . . . . . . . . . . . . . 52Active . . . . . . . . . . . . . . . . 53AddEvent . . . . . . . . . . . . . . . 54AddItemEnd . . . . . . . . . . . . . . 55AddLineEnd . . . . . . . . . . . . . . 56AddLink . . . . . . . . . . . . . . . 57AddMsgID . . . . . . . . . . . . . . 59AddMsgText . . . . . . . . . . . . . . 60AddOffset . . . . . . . . . . . . . . . 61AddRcd . . . . . . . . . . . . . . . 62AddSrcEvt. . . . . . . . . . . . . . . 64Alarm . . . . . . . . . . . . . . . . 65Alignment . . . . . . . . . . . . . . . 66AllowChg . . . . . . . . . . . . . . . 68AllowEdit . . . . . . . . . . . . . . . 69AllowLink . . . . . . . . . . . . . . . 70AppData . . . . . . . . . . . . . . . 72AppName . . . . . . . . . . . . . . . 73Arrange . . . . . . . . . . . . . . . 74AttrValue . . . . . . . . . . . . . . . 75AudioMode . . . . . . . . . . . . . . 76AutoInc . . . . . . . . . . . . . . . 77AutoScroll . . . . . . . . . . . . . . . 78AutoSelect . . . . . . . . . . . . . . . 80BackColor . . . . . . . . . . . . . . . 81BackMix . . . . . . . . . . . . . . . 83BarLabel . . . . . . . . . . . . . . . 84Bass . . . . . . . . . . . . . . . . . 85BindPart . . . . . . . . . . . . . . . 86BlankChar . . . . . . . . . . . . . . . 87Border . . . . . . . . . . . . . . . . 88Bottom . . . . . . . . . . . . . . . . 89BufferDec . . . . . . . . . . . . . . . 90BufferLen . . . . . . . . . . . . . . . 91BufferPtr . . . . . . . . . . . . . . . 92BufferType. . . . . . . . . . . . . . . 93Button . . . . . . . . . . . . . . . . 95ButtonIdx . . . . . . . . . . . . . . . 96Buttons . . . . . . . . . . . . . . . . 97ButtonTip . . . . . . . . . . . . . . . 98CanUndo . . . . . . . . . . . . . . . 99CapsLock. . . . . . . . . . . . . . . 100Case . . . . . . . . . . . . . . . . 101CellBGClr . . . . . . . . . . . . . . 102CellBGMix . . . . . . . . . . . . . . 104CellFGClr . . . . . . . . . . . . . . 105CellFGMix . . . . . . . . . . . . . . 107Center . . . . . . . . . . . . . . . . 108CharData . . . . . . . . . . . . . . . 109CharOffset . . . . . . . . . . . . . . 110Checked . . . . . . . . . . . . . . . 111

© Copyright IBM Corp. 1994, 2000 iii

||

Page 6: Manual Ibm

ChildCount . . . . . . . . . . . . . . 112ChildList . . . . . . . . . . . . . . . 113ClearAll . . . . . . . . . . . . . . . 114ClearDate. . . . . . . . . . . . . . . 115ClearMonth . . . . . . . . . . . . . . 116ClearYear . . . . . . . . . . . . . . . 117ClipBoard . . . . . . . . . . . . . . 118ColBGClr . . . . . . . . . . . . . . . 119ColBGMix . . . . . . . . . . . . . . 121ColFGClr . . . . . . . . . . . . . . . 122ColFGMix . . . . . . . . . . . . . . 124Collapsed . . . . . . . . . . . . . . 125ColNumber . . . . . . . . . . . . . . 126Color . . . . . . . . . . . . . . . . 127ColorArea . . . . . . . . . . . . . . 129ColorMix . . . . . . . . . . . . . . . 131Column . . . . . . . . . . . . . . . 132ColumnDec . . . . . . . . . . . . . . 133ColumnLen . . . . . . . . . . . . . . 134ColumnName . . . . . . . . . . . . . 135Columns . . . . . . . . . . . . . . . 136ColumnType . . . . . . . . . . . . . 137ColWidth . . . . . . . . . . . . . . . 138CompName . . . . . . . . . . . . . . 139Connect . . . . . . . . . . . . . . . 140Connected . . . . . . . . . . . . . . 141ConnectStr . . . . . . . . . . . . . . 142Copy . . . . . . . . . . . . . . . . 143Count . . . . . . . . . . . . . . . . 144CsrAtEnd . . . . . . . . . . . . . . 145CsrLine . . . . . . . . . . . . . . . 146CsrPos . . . . . . . . . . . . . . . 147CurrentDir . . . . . . . . . . . . . . 148CurrentRow . . . . . . . . . . . . . . 149Cut . . . . . . . . . . . . . . . . . 150DataGroup . . . . . . . . . . . . . . 151DataPoint . . . . . . . . . . . . . . 152DataType . . . . . . . . . . . . . . . 153DataValue . . . . . . . . . . . . . . 154Date . . . . . . . . . . . . . . . . 155DateIdx . . . . . . . . . . . . . . . 156DateText . . . . . . . . . . . . . . . 157DateUnder . . . . . . . . . . . . . . 158Day . . . . . . . . . . . . . . . . 159DayIdx . . . . . . . . . . . . . . . 160DayLen . . . . . . . . . . . . . . . 161DayNumPos. . . . . . . . . . . . . . 162DayNumRect . . . . . . . . . . . . . 163DayStart . . . . . . . . . . . . . . . 164DDEAddLink . . . . . . . . . . . . . 165DDEMode . . . . . . . . . . . . . . 167DDERmvLink . . . . . . . . . . . . . 168DeActivate . . . . . . . . . . . . . . 169Delete . . . . . . . . . . . . . . . . 170DeleteRow . . . . . . . . . . . . . . 171DelimChar . . . . . . . . . . . . . . 172DeSelect . . . . . . . . . . . . . . . 173Dialog . . . . . . . . . . . . . . . . 174DIRName . . . . . . . . . . . . . . 175DlgOwner . . . . . . . . . . . . . . 176DoEvents . . . . . . . . . . . . . . . 177

DragEnable . . . . . . . . . . . . . . 178DropEnable . . . . . . . . . . . . . . 179DspHeight . . . . . . . . . . . . . . 180DspWidth . . . . . . . . . . . . . . 181EditItem . . . . . . . . . . . . . . . 182EnableBtn . . . . . . . . . . . . . . 183Enabled . . . . . . . . . . . . . . . 184Execute . . . . . . . . . . . . . . . 186ExecuteSQL . . . . . . . . . . . . . . 187ExtSelect . . . . . . . . . . . . . . . 188Fetch . . . . . . . . . . . . . . . . 189FetchNext . . . . . . . . . . . . . . 190FetchPrior . . . . . . . . . . . . . . 191FieldExit . . . . . . . . . . . . . . . 192FileName. . . . . . . . . . . . . . . 193FillStyle . . . . . . . . . . . . . . . 195FirstSel . . . . . . . . . . . . . . . 197Focus . . . . . . . . . . . . . . . . 198FontArea . . . . . . . . . . . . . . . 200FontBold . . . . . . . . . . . . . . . 202FontItalic . . . . . . . . . . . . . . . 204FontName . . . . . . . . . . . . . . 206FontSize . . . . . . . . . . . . . . . 207FontStrike . . . . . . . . . . . . . . 208FontUnder . . . . . . . . . . . . . . 210ForeColor . . . . . . . . . . . . . . 212ForeMix . . . . . . . . . . . . . . . 214Format . . . . . . . . . . . . . . . 216FrameRate . . . . . . . . . . . . . . 217FrmtString . . . . . . . . . . . . . . 218GetItem . . . . . . . . . . . . . . . 219GetNewID . . . . . . . . . . . . . . 220GetRcdFld . . . . . . . . . . . . . . 221GetRcdIcon . . . . . . . . . . . . . . 222GetRcdText . . . . . . . . . . . . . . 223GetTables. . . . . . . . . . . . . . . 224

Ejemplo de GetTables. . . . . . . . . . 225GnEqGrpCol . . . . . . . . . . . . . 226GnEqPntCol . . . . . . . . . . . . . . 227GraphType . . . . . . . . . . . . . . 228GrphHiLite . . . . . . . . . . . . . . 229GroupLabel . . . . . . . . . . . . . . 230Handle . . . . . . . . . . . . . . . 231HasPrpPage . . . . . . . . . . . . . . 232HdgBGClr . . . . . . . . . . . . . . 233HdgBGMix . . . . . . . . . . . . . . 235HdgFGClr . . . . . . . . . . . . . . 236HdgFGMix . . . . . . . . . . . . . . 238HdgIdx . . . . . . . . . . . . . . . 239HdgText . . . . . . . . . . . . . . . 240Height. . . . . . . . . . . . . . . . 241HelpEnable . . . . . . . . . . . . . . 242HelpWindow . . . . . . . . . . . . . 244Hidden . . . . . . . . . . . . . . . 245HighLight . . . . . . . . . . . . . . 246HitItem . . . . . . . . . . . . . . . 248HlitPoints . . . . . . . . . . . . . . 250HRule . . . . . . . . . . . . . . . . 251IconHandle . . . . . . . . . . . . . . 252Index . . . . . . . . . . . . . . . . 253InPlace . . . . . . . . . . . . . . . 254

iv VisualAge RPG Manual de consulta de componentes

||

Page 7: Manual Ibm

InsertItem . . . . . . . . . . . . . . 255InsertLine . . . . . . . . . . . . . . 256InsertMode . . . . . . . . . . . . . . 257InsertRow . . . . . . . . . . . . . . 258InsertText. . . . . . . . . . . . . . . 259Interval . . . . . . . . . . . . . . . 260InUse . . . . . . . . . . . . . . . . 261InvName . . . . . . . . . . . . . . . 262InvPName . . . . . . . . . . . . . . 263IsData . . . . . . . . . . . . . . . . 264Item . . . . . . . . . . . . . . . . 265ItemCount . . . . . . . . . . . . . . 267ItemKey . . . . . . . . . . . . . . . 268Label . . . . . . . . . . . . . . . . 269LabelPlace . . . . . . . . . . . . . . 271Left. . . . . . . . . . . . . . . . . 272LegendType . . . . . . . . . . . . . . 273Length . . . . . . . . . . . . . . . 274LineNumber. . . . . . . . . . . . . . 275LineText . . . . . . . . . . . . . . . 276LookNFeel . . . . . . . . . . . . . . 277Magnify . . . . . . . . . . . . . . . 278Masked . . . . . . . . . . . . . . . 279Maximum . . . . . . . . . . . . . . 280Method . . . . . . . . . . . . . . . 281

Ejemplo de Method . . . . . . . . . . 281MiniIcon . . . . . . . . . . . . . . . 282Minimum . . . . . . . . . . . . . . 283Mode . . . . . . . . . . . . . . . . 284Month. . . . . . . . . . . . . . . . 285MonthArrow . . . . . . . . . . . . . 286MonthIdx . . . . . . . . . . . . . . 287MonthLen . . . . . . . . . . . . . . 288MouseIcon . . . . . . . . . . . . . . 289MouseShape. . . . . . . . . . . . . . 290MsgData . . . . . . . . . . . . . . . 292MsgFile . . . . . . . . . . . . . . . 293MsgID. . . . . . . . . . . . . . . . 294MsgSubText . . . . . . . . . . . . . . 295MsgText . . . . . . . . . . . . . . . 296Multiplier . . . . . . . . . . . . . . 297MultSelect . . . . . . . . . . . . . . 298Name . . . . . . . . . . . . . . . . 299NbrOfImage. . . . . . . . . . . . . . 300NbrOfLines . . . . . . . . . . . . . . 301NbrOfSel . . . . . . . . . . . . . . . 302NextLine . . . . . . . . . . . . . . . 303NextPage . . . . . . . . . . . . . . . 304NotSrcEvt . . . . . . . . . . . . . . 305NotSrcPart . . . . . . . . . . . . . . 306NotSrcWin . . . . . . . . . . . . . . 307OCXProp . . . . . . . . . . . . . . . 308OCXValue . . . . . . . . . . . . . . 309OpenEdit . . . . . . . . . . . . . . . 310OS . . . . . . . . . . . . . . . . . 311OutlineRcl . . . . . . . . . . . . . . 312PageNumber . . . . . . . . . . . . . 313PageSize . . . . . . . . . . . . . . . 314Panel . . . . . . . . . . . . . . . . 315PanelItem . . . . . . . . . . . . . . 317PanelMode . . . . . . . . . . . . . . 319

Parent . . . . . . . . . . . . . . . . 320ParentId . . . . . . . . . . . . . . . 322ParentList . . . . . . . . . . . . . . 323ParentName . . . . . . . . . . . . . . 324PartCount . . . . . . . . . . . . . . 325PartList . . . . . . . . . . . . . . . 326PartName . . . . . . . . . . . . . . 327PartType . . . . . . . . . . . . . . . 328Paste . . . . . . . . . . . . . . . . 329PBRange . . . . . . . . . . . . . . . 330PBSetPos . . . . . . . . . . . . . . . 331PBStep . . . . . . . . . . . . . . . 332PBStepSize . . . . . . . . . . . . . . 333Platform . . . . . . . . . . . . . . . 334PlugCmd . . . . . . . . . . . . . . . 335PlugDLL . . . . . . . . . . . . . . . 336PlugID . . . . . . . . . . . . . . . 337PlugRC . . . . . . . . . . . . . . . 338PlugResult . . . . . . . . . . . . . . 339Poke . . . . . . . . . . . . . . . . 340Position . . . . . . . . . . . . . . . 341PrevLine . . . . . . . . . . . . . . . 342PrevPage . . . . . . . . . . . . . . . 343Print . . . . . . . . . . . . . . . . 344Printer. . . . . . . . . . . . . . . . 345ProgresBar . . . . . . . . . . . . . . 346Range . . . . . . . . . . . . . . . . 347ReadOnly . . . . . . . . . . . . . . 348RecordID . . . . . . . . . . . . . . . 350RefAttr . . . . . . . . . . . . . . . 351RefParent. . . . . . . . . . . . . . . 352RefPart . . . . . . . . . . . . . . . 353Refresh . . . . . . . . . . . . . . . 354RemoveItem. . . . . . . . . . . . . . 355RemoveLink. . . . . . . . . . . . . . 356RemoveMsg . . . . . . . . . . . . . . 357RemoveRcd . . . . . . . . . . . . . . 358Request . . . . . . . . . . . . . . . 359RmvSrcEvt . . . . . . . . . . . . . . 360RmvEvent . . . . . . . . . . . . . . 361RowBGClr . . . . . . . . . . . . . . 362RowBGMix . . . . . . . . . . . . . . 364RowFGClr . . . . . . . . . . . . . . 365RowFGMix . . . . . . . . . . . . . . 367Rows . . . . . . . . . . . . . . . . 368SBIndex . . . . . . . . . . . . . . . 369SBLabel . . . . . . . . . . . . . . . 370SBPanes . . . . . . . . . . . . . . . 371SBPosition . . . . . . . . . . . . . . 372SBStyle . . . . . . . . . . . . . . . 373Scale . . . . . . . . . . . . . . . . 374Search . . . . . . . . . . . . . . . . 375SearchType . . . . . . . . . . . . . . 376Selected . . . . . . . . . . . . . . . 377SelectIdx . . . . . . . . . . . . . . . 378SelectItem . . . . . . . . . . . . . . 379SelectList . . . . . . . . . . . . . . . 380

Ejemplo de SelectList . . . . . . . . . . 380SelectRcd . . . . . . . . . . . . . . . 381SelPrinter. . . . . . . . . . . . . . . 382Sequence . . . . . . . . . . . . . . . 383

Contenido v

||

||

Page 8: Manual Ibm

SetItem . . . . . . . . . . . . . . . 385SetRcdFld . . . . . . . . . . . . . . 386SetRcdIcon . . . . . . . . . . . . . . 387SetRcdText . . . . . . . . . . . . . . 388SetTop. . . . . . . . . . . . . . . . 389SflNxtChg . . . . . . . . . . . . . . 390ShData . . . . . . . . . . . . . . . 391ShDataLen . . . . . . . . . . . . . . 392ShDataName . . . . . . . . . . . . . 393ShDataPos . . . . . . . . . . . . . . 394ShowMsgID . . . . . . . . . . . . . . 395ShowProp . . . . . . . . . . . . . . 396ShowRects . . . . . . . . . . . . . . 397ShowTabs . . . . . . . . . . . . . . 398ShowText. . . . . . . . . . . . . . . 399ShowTips. . . . . . . . . . . . . . . 400SizeToFit . . . . . . . . . . . . . . . 401SortAsc . . . . . . . . . . . . . . . 402SortDesc . . . . . . . . . . . . . . . 403SQLError . . . . . . . . . . . . . . . 404SQLMsgBox . . . . . . . . . . . . . . 405SQLQuery . . . . . . . . . . . . . . 406StartAt . . . . . . . . . . . . . . . 407

Ejemplo de StartAt . . . . . . . . . . 408StartNew . . . . . . . . . . . . . . . 409StatusBar . . . . . . . . . . . . . . . 410SwitchTo . . . . . . . . . . . . . . . 411TabImage. . . . . . . . . . . . . . . 412TabLabel . . . . . . . . . . . . . . . 413Text . . . . . . . . . . . . . . . . 414TextEnd . . . . . . . . . . . . . . . 415TextLength . . . . . . . . . . . . . . 416TextSelect. . . . . . . . . . . . . . . 417TextStart . . . . . . . . . . . . . . . 418TextString . . . . . . . . . . . . . . 419TickLabel . . . . . . . . . . . . . . . 420TickNumber . . . . . . . . . . . . . . 421Tile . . . . . . . . . . . . . . . . . 422TimeOut . . . . . . . . . . . . . . . 423TimerMode . . . . . . . . . . . . . . 424TimerTicks . . . . . . . . . . . . . . 425TipText . . . . . . . . . . . . . . . 426Title . . . . . . . . . . . . . . . . 427TitlePlace . . . . . . . . . . . . . . . 428Top. . . . . . . . . . . . . . . . . 429Topic . . . . . . . . . . . . . . . . 430TopLine . . . . . . . . . . . . . . . 431TopRecord . . . . . . . . . . . . . . 432Treble . . . . . . . . . . . . . . . . 433UnBind . . . . . . . . . . . . . . . 434UnderPoint . . . . . . . . . . . . . . 435Undo . . . . . . . . . . . . . . . . 436UpdateRow . . . . . . . . . . . . . . 437UseData . . . . . . . . . . . . . . . 438UseDelim. . . . . . . . . . . . . . . 439UserData . . . . . . . . . . . . . . . 440Validate . . . . . . . . . . . . . . . 441Value . . . . . . . . . . . . . . . . 443View . . . . . . . . . . . . . . . . 444Visible. . . . . . . . . . . . . . . . 445VisTitle . . . . . . . . . . . . . . . 447

VisTitlSep . . . . . . . . . . . . . . 448Volume . . . . . . . . . . . . . . . 449VRule . . . . . . . . . . . . . . . . 450WeekDay . . . . . . . . . . . . . . . 451WeekDayIdx. . . . . . . . . . . . . . 452Width . . . . . . . . . . . . . . . . 453WindowMode . . . . . . . . . . . . . 454WordWrap . . . . . . . . . . . . . . 455WrkStnName . . . . . . . . . . . . . 456X . . . . . . . . . . . . . . . . . 457XAxisLabel . . . . . . . . . . . . . . 458Y . . . . . . . . . . . . . . . . . 459YAxisLabel . . . . . . . . . . . . . . 460Year . . . . . . . . . . . . . . . . 461YearIdx . . . . . . . . . . . . . . . 462YearLen . . . . . . . . . . . . . . . 463Yinc . . . . . . . . . . . . . . . . 464

Capítulo 3. Eventos de componentes 465Activate . . . . . . . . . . . . . . . 465BeanEvent . . . . . . . . . . . . . . 465Change . . . . . . . . . . . . . . . 466Click . . . . . . . . . . . . . . . . 466Close . . . . . . . . . . . . . . . . 467Collapsed . . . . . . . . . . . . . . 467ColSelect . . . . . . . . . . . . . . . 467Complete. . . . . . . . . . . . . . . 467Create . . . . . . . . . . . . . . . . 468Data . . . . . . . . . . . . . . . . 468DblClick . . . . . . . . . . . . . . . 469DeActivate . . . . . . . . . . . . . . 469Destroy . . . . . . . . . . . . . . . 469Drop . . . . . . . . . . . . . . . . 470DropDown . . . . . . . . . . . . . . 470Enter . . . . . . . . . . . . . . . . 471ExecuteAck . . . . . . . . . . . . . . 471Expanded . . . . . . . . . . . . . . 471FirstRec . . . . . . . . . . . . . . . 472GotFocus . . . . . . . . . . . . . . . 472KeyPress . . . . . . . . . . . . . . . 472LastRec . . . . . . . . . . . . . . . 473LClickTray . . . . . . . . . . . . . . 473Link . . . . . . . . . . . . . . . . 473LostFocus . . . . . . . . . . . . . . 473MenuSelect . . . . . . . . . . . . . . 474MouseDown. . . . . . . . . . . . . . 474MouseEnter . . . . . . . . . . . . . . 474MouseExit . . . . . . . . . . . . . . 475MouseMove . . . . . . . . . . . . . . 475MouseUp. . . . . . . . . . . . . . . 476Moved . . . . . . . . . . . . . . . 476MthChange . . . . . . . . . . . . . . 476NextRec . . . . . . . . . . . . . . . 476Notify . . . . . . . . . . . . . . . . 477OCXEvent . . . . . . . . . . . . . . 477PageDown . . . . . . . . . . . . . . 477PageEnd . . . . . . . . . . . . . . . 478PageSelect . . . . . . . . . . . . . . 478PageTop . . . . . . . . . . . . . . . 478PageUp . . . . . . . . . . . . . . . 478PokeAck . . . . . . . . . . . . . . . 479

vi VisualAge RPG Manual de consulta de componentes

||

Page 9: Manual Ibm

Popup . . . . . . . . . . . . . . . . 479Press . . . . . . . . . . . . . . . . 480PrevRec . . . . . . . . . . . . . . . 480RClickTray . . . . . . . . . . . . . . 480ReSize . . . . . . . . . . . . . . . . 480Scroll . . . . . . . . . . . . . . . . 481Select . . . . . . . . . . . . . . . . 481ShutDown . . . . . . . . . . . . . . 481SpinDown . . . . . . . . . . . . . . 482SpinEnd . . . . . . . . . . . . . . . 482SpinUp . . . . . . . . . . . . . . . 482Terminate . . . . . . . . . . . . . . 482Tick . . . . . . . . . . . . . . . . 483Timeout . . . . . . . . . . . . . . . 483VKeyPress . . . . . . . . . . . . . . 484YearChange . . . . . . . . . . . . . . 484

Capítulo 4. Atributos de eventos . . . 485%Alt . . . . . . . . . . . . . . . . 486%Button . . . . . . . . . . . . . . . 486%Character . . . . . . . . . . . . . . 486%ColNumber . . . . . . . . . . . . . 487%Complete . . . . . . . . . . . . . . 487%Control . . . . . . . . . . . . . . . 487%Data . . . . . . . . . . . . . . . . 488%EventName . . . . . . . . . . . . . 488

%Index . . . . . . . . . . . . . . . 488%Item . . . . . . . . . . . . . . . . 488%MouseX . . . . . . . . . . . . . . 488%MouseY . . . . . . . . . . . . . . 489%NewHeight . . . . . . . . . . . . . 489%NewMode . . . . . . . . . . . . . . 489%NewWidth. . . . . . . . . . . . . . 489%Page. . . . . . . . . . . . . . . . 490%Part . . . . . . . . . . . . . . . . 490%Position . . . . . . . . . . . . . . 490%RealName . . . . . . . . . . . . . . 490%Shift . . . . . . . . . . . . . . . . 490%SrcCompName . . . . . . . . . . . . 491%SrcEvtName . . . . . . . . . . . . . 491%SrcPartName . . . . . . . . . . . . . 491%SrcWinName . . . . . . . . . . . . . 491%Window . . . . . . . . . . . . . . 492

Glosario . . . . . . . . . . . . . 493

Bibliografía . . . . . . . . . . . . 505

Avisos . . . . . . . . . . . . . . 507Información de interfaz de programación . . . . 508Marcas registradas y marcas de servicio . . . . 508

Contenido vii

||

Page 10: Manual Ibm

viii VisualAge RPG Manual de consulta de componentes

Page 11: Manual Ibm

Acerca de este manual

Este manual proporciona información de consulta sobre los componentes deVisualAge® para RPG, que se utilizan para crear la aplicación de interfaz gráficade usuario (GUI); los atributos y los eventos asociados con cada componente; ylos atributos de evento que puede consultar en la aplicación VARPG. Estádestinado a aquellas personas que programan aplicaciones mediante VisualAgeRPG.

Antes de utilizar este manual, debería leer la publicación Iniciación a VisualAge RPGy CODE/400.

Convenios de resaltado que se utilizan en este manualA lo largo de este manual, todos los nombres de atributos, eventos y atributos deeventos aparecen en el tipo negrita, al igual que un término en su primeraaparición, otros términos enfatizados y cualquier referencia a texto que aparezca enla interfaz de VisualAge RPG. Las variables aparecen en cursiva. Los códigos deoperación de VisualAge RPG aparecen TOTALMENTE EN MAYÚSCULAS.

Requisito previo e información relacionadaUtilice el centro de información de AS/400® como punto de partida para consultarinformación técnica sobre AS/400. Puede acceder al Information Center desde elCD-ROM AS/400e™ Information Center (versión en español: SK3T-1330-02(SK3T-2027-03)) o desde una de las páginas Web siguientes:http://www.as400.ibm.com/infocenterhttp://publib.boulder.ibm.com/pubs/html/as400/infocenter.htm

El centro de información de AS/400 contiene temas importantes como, porejemplo, particiones lógicas, sistemas en clusters, Java, TCP/IP, servicios de Web yredes seguras. También contiene enlaces de Internet a páginas Web como, porejemplo, la biblioteca en línea de AS/400 y el estudio técnico de AS/400. En elcentro de información hay un enlace que describe a un nivel superior lasdiferencias de información entre el centro de información y la biblioteca en línea.

Para obtener una versión en copia software de las publicaciones de AS/400,consulte la publicación CD-ROM AS/400e Biblioteca en soporte software, SK3T-1325-04(SK3T-0118-04).

La biblioteca VisualAge RPG

*Nota: Se han actualizado todas las versiones en línea de las publicaciones deWebSphere Development Tools para AS/400. Las publicaciones cuyo títuloestá marcado con un asterisco (*) no se han vuelto a imprimir en esterelease.

La biblioteca VisualAge RPG contiene las publicaciones siguientes:

*Iniciación a VisualAge RPG y CODE/400

© Copyright IBM Corp. 1994, 2000 ix

Page 12: Manual Ibm

Utilice esta publicación para familiarizarse con los conceptos y la interfaz deVisualAge RPG y como consulta de tareas al utilizar VisualAge RPG.

*Programación con VisualAge para RPG

Esta publicación contiene información específica acerca de la creación deaplicaciones con VisualAge RPG. Describe los pasos a seguir en cada fase del ciclode desarrollo de aplicaciones, desde el diseño al empaquetado y la distribución. Seincluyen ejemplos de programación para aclarar los conceptos y el proceso deldesarrollo de aplicaciones VisualAge RPG.

*VisualAge RPG Manual de consulta de componentes

Esta publicación proporciona información sobre los componentes, atributos decomponente, eventos de componente y atributos de evento de VisualAge RPG. Esun manual de consulta para todos aquellos que desarrollan aplicaciones conVisualAge RPG.

*VisualAge RPG Manual de consulta del lenguaje

Esta publicación proporciona información acerca del lenguaje RPG IV tal como seimplementa utilizando el compilador VisualAge RPG. Contiene:v Conceptos básicos del lenguaje como el juego de caracteres, nombres simbólicos

y palabras reservadas, directivas del compilador e indicadores.v Tipos y formatos de datosv Manejo de errores y de excepcionesv Especificacionesv Funciones incorporadas, expresiones y códigos de operación.

Para obtener una lista de publicaciones relacionadas, consulte la bibliografía alfinal de esta publicación.

VA RPG y CODE/400 Tutorial

Hay una guía de aprendizaje en formato HTML disponible en el URL siguiente:http://www.ibm.com/software/ad/varpg/download/#interactive

Esta guía de aprendizaje interactiva registra la evolución del usuario para podervolver fácilmente al último ejercicio realizado. Hay unas pruebas al final de cadalección que sirven de ayuda para probar los conocimientos adquiridos de launidad.

Nota: Para poder utilizar esta guía de aprendizaje, necesitará un navegador queadmita marcos, Java® y Javascript. También necesitará una herramienta deextracción de archivos, como es WinZip, que pueda manejar nombres largosde archivos.

También puede encontrar la información más reciente sobre VA RPG y CODE/400en las siguientes fuentes en línea:

La página de presentación de VisualAge RPG y CODE/400http://www.ibm.com/software/ad/varpg/

x VisualAge RPG Manual de consulta de componentes

Page 13: Manual Ibm

Cómo enviar comentariosSus opiniones son importantes para ayudarnos a proporcionar la información másexacta y de mayor calidad posible. IBM agradece todos los comentarios sobre estapublicación o cualquier otra documentación de AS/400.v Si prefiere enviar los comentarios por correo, puede utilizar la dirección

siguiente:

IBM, S.A.National Language Solutions CenterAvda. Diagonal, 57108029 BarcelonaEspaña

Si envía una hoja de comentarios del cliente desde un país fuera de EstadosUnidos, puede entregar la hoja de comentarios a la sucursal IBM local o alrepresentante de IBM para enviarla por correo pagado.

v Si prefiere enviar los comentarios por fax, puede utilizar el número siguiente:– +34 93 321 61 34

v Si prefiere enviar los comentarios por correo electrónico, puede utilizar una delas direcciones siguientes:– Comentarios sobre publicaciones

[email protected]: to toribm(torrcf)

– Comentarios sobre el centro de información de AS/400:[email protected]

Asegúrese de indicar lo siguiente:v El título del librov El número de la publicaciónv El número de página o el tema al que hace referencia el comentario.

Acceso a la información en líneaVisualAge RPG tiene varios manuales en línea y ayuda en línea. Puede acceder ala ayuda mientras utiliza el producto, y puede visualizar los manuales tanto si estáutilizando el producto como si no.

Utilización de manuales en líneaPara visualizar un manual en línea,realice una de las acciones siguientes:v Seleccione el nombre del manual desde el menú desplegable Ayuda del

Diseñador GUI de VisualAge RPG o de la ventana del editor.v Puede acceder a las publicaciones desde el menú Inicio. Seleccione Programas →

VisualAge RPG y CODE400. Después, seleccione Información de VARPG yCODE400.

Publicaciones en formato PDFTodas las publicaciones de VA RPG y CODE/400 se incluyen como parte de laayuda habitual para el producto. Además del formato normal, el producto tambiéncontiene la versión PDF de las publicaciones.

Nota: Debe disponer del programa Adobe Acrobat Reader, Versión 3.01 o superiorpara Windows, para ver el formato PDF de las publicaciones en la estación

Acerca de este manual xi

Page 14: Manual Ibm

de trabajo. Si no dispone de dicho programa, puede descargar una copia dela página Web de Adobe Systems (http://www.adobe.com).

En la ayuda en línea están disponibles las siguientes publicaciones en formatoPDF:v Iniciación a VisualAge RPG y CODE/400

v Programación con VisualAge para RPG

v VisualAge RPG Manual de consulta de componentes

v VisualAge RPG Manual de consulta del lenguaje

Nota: Se han actualizado todas las versiones en línea de las publicaciones deWebSphere Development Tools para AS/400.

Utilización de ayuda en líneaHay ayuda en línea disponible para todas las áreas de VisualAge RPG. Paraobtener ayuda para una ventana determinada, un recuadro de diálogo o uncuaderno de propiedades, seleccione el pulsador Ayuda (si está disponible).

Nota: Para ver la ayuda que está en formato HTML, la estación de trabajo debetener un navegador Web que soporte marcos como, por ejemplo NetscapeNavigator 4.04 o superior, o Microsoft® Internet Explorer 4.01 o superior. (Elnavegador recomendado es Netscape Navigator 4.6 o Internet Explorer 5.0)

Utilización de ayuda según el contextoPara obtener ayuda sensible al contexto en cualquier momento, pulse F1. La ayudaque aparece es específica del área de la interfaz que tiene foco de entrada. El focode entrada puede estar en elementos de menú, ventanas, recuadros de diálogo ycuadernos de propiedades, o en componentes específicos de los mismos.

Para obtener ayuda según contexto en los recuadros de diálogo, pulse el botónsobre el signo de interrogación (si está disponible) en el extremo superior derechode la ventana. Aparece un signo de interrogación al lado de la flecha del ratón.Pulse el botón sobre una palabra o un campo y aparecerá la información de ayudasobre ese determinado campo.

Utilización de hipertextoAlgunas ventanas de ayuda contienen palabras, frases o gráficos que aparecenresaltados. Son enlaces de hipertexto que llevan de un tema a otro. Para visualizarayuda específica de un tema resaltado, pulse en él. Cuando siga un enlace dehipertexto, puede aparecer un botón Sincronizar en la esquina superior derechadel tema de ayuda. (Quizás deba retroceder páginas para verlo). Si pulsa el botónSincronizar, la lista de temas del marco izquierdo se renueva a fin de mostrarle ellugar que ocupa el tema actual en la tabla de contenido general.

Utilización de la tabla de contenido de la ayudaCuando se visualice la ventana de Ayuda, pulse el botón Sincronizar (cuando estédisponible) para visualizar la sección Componentes en el marco de la izquierda.Pulse los símbolos más + y menos − para expandir y contraer la seccióncorrespondiente al componente deseado. Para ver un tema, pulse en él.

Utilización del recurso de búsquedaEl sistema de ayuda VisualAge RPG y CODE/400 utiliza un motor de búsquedaavanzado de texto completo, que devuelve ″aciertos″ o ″coincidencias″ HTMLbasados en la petición de búsqueda. Para buscar un tema:

xii VisualAge RPG Manual de consulta de componentes

Page 15: Manual Ibm

1. Escriba una palabra, frase o pregunta (no incluya los interrogantes) en el áreade texto situada junto a las +Opciones de búsqueda. Pulse Intro.

2. Si la palabra o frase no se encuentra, se visualiza información acerca del intentode búsqueda. De lo contrario, aparece la página Resultado de la búsqueda conuna lista de temas en los que se ha encontrado la palabra o frase. Pulse elenlace que desee ver.

3. Puede utilizar las +Opciones de búsqueda para especificar el número dedocumentos que debe devolverse.

Si desea obtener consejos para refinar las búsquedas, puede ver el tema Cómobuscar información en la ayuda en línea.

Utilización de ayuda según el lenguajePara obtener ayuda según el lenguaje, pulse F1 en una ventana de edición. Si elcursor está en un código de operación, recibirá ayuda para ese código deoperación; de lo contrario, recibirá ayuda para la especificación actual.

Acerca de este manual xiii

Page 16: Manual Ibm

xiv VisualAge RPG Manual de consulta de componentes

Page 17: Manual Ibm

Novedades de este Release

Las siguientes funciones nuevas de VisualAge RPG se han añadido en este releasede IBM VisualAge RPG y CODE (Cooperative Development Environment) paraAS/400:v Los campos de subarchivo soportan la palabra clave VALUE.v Se dispone de un nuevo atributo StartAt en el componente subarchivo. Ahora

puede forzarse que la operación READC empiece en el registro especificado.v El carácter de sustitución de etiqueta (|) se soporta ahora en las cabeceras de

columna de los subarchivos.v Puede establecerse un tabulador en el componente subarchivo.v Se ha añadido la validación y formato automáticos en los campos de entrada.v Los componentes subarchivo, contenedor y recuadro de lista soportan los

eventos KeyPress y VKeyPress.v El atributo Tablabel de la página de cuaderno ahora también es de lectura.v Un nuevo atributo ShowTabs para el componente Cuaderno permite ocultar las

pestañas.v Un valor nuevo del diálogo Preferencias del usuario determina si deben

mostrarse todas las pestañas en los cuadernos de propiedades.v Se soportan posibilidades adicionales de espaciado de los componentes, en

relación con una área circundante.v El componente Lienzo ahora soporta el atributo Enabled.v El nuevo atributo de componente *component, Platform, devuelve el entorno en

el que se ejecuta la aplicación (Java o Windows).v La posibilidad de especificar el tamaño y la posición de un componente dentro

de una ventana.v La posibilidad de invocar mandatos de usuario en el último paso de

construcción.v La ayuda en línea se visualiza ahora en formato HTML. (Deberá tener instalado

un navegador en la estación de trabajo para ver la ayuda).v Se da soporte a Personal Communications (PCOMM) para Windows.v Un nuevo diálogo ’¿Quién soy?’ del Diseñador GUI proporciona información

sobre el proyecto y VARPG.v Se ha añadido el nuevo componente Bean Java a la paleta de componentes.

Ahora pueden utilizarse componentes JavaBean en la aplicación.v Las opciones de menú dan soporte a la ayuda ¿Qué es esto? en las aplicaciones

Java.v Los componentes Campo de entrada y Edición de múltiples líneas proporcionan

un nuevo valor que conserva la selección de texto aunque la ventana en la queestán pierda el foco.

v Se ha añadido un botón Buscar en el diálogo Empaquetar componente.v Para cada proyecto puede especificarse el directorio TEST.

© Copyright IBM Corp. 1994, 2000 xv

Page 18: Manual Ibm

xvi VisualAge RPG Manual de consulta de componentes

Page 19: Manual Ibm

Capítulo 1. Componentes

Los componentes son los bloques de construcción que se utilizan al crear unaaplicación GUI (interfaz gráfica de usuario). Actúan como plantillas sobre las quese construye, permitiendo al usuario crear diseños de forma rápida y sencilla. Cadacomponente tiene asociados atributos y eventos.

Este capítulo describe los componentes de VisualAge®

RPG. Cada una de lasdescripciones contiene lo siguiente:v Una descripción general del componentev Una lista de los atributos que se aplican al componentev Una lista de los eventos que se aplican al componentev Cualquier restricción que se aplique

ActiveX

* Restricción: Este componente no está soportado en las aplicaciones Java®.

Utilice el componente ActiveX™ para añadir objetos de control ActiveX al proyecto.Las aplicaciones podrán acceder a los atributos y supervisar los eventos. (Otrosproveedores se encargan del desarrollo y suministro de los controles ActiveX.)

Debe estar familiarizado con los controles ActiveX que añade. El Diseñador GUI deVARPG no puede controlar las funciones que proporcionan estos componentes.

Nota: VARPG sólo trabaja con controles ActiveX que tengan interfaces escritas enC++. Consulte con su suministrador de controles ActiveX para asegurarse deque VARPG funcionará con el control ActiveX que desea utilizar.

© Copyright IBM Corp. 1994, 2000 1

Page 20: Manual Ibm

Atributos de componente

Activate AddEvent Bottom DeActivateHasPrpPage Height Left MethodOCXProp OCXValue ParentName PartNamePartType Refresh RmvEvent ShowPropTop UserData Visible Width

Eventos a los que puede aplicarse

Create Destroy OCXEvent

2 VisualAge RPG Manual de consulta de componentes

Page 21: Manual Ibm

Control de animación

En las aplicaciones de Windows®, el componente control de animación reproducelos archivos de vídeo con la extensión AVI. Este componente se distingue delcomponente medios en que el vídeo se reproduce independientemente de la lógicadel programa. Un uso habitual de este componente es visualizar un archivo AVIque muestre un progreso como, por ejemplo, un archivo que se traspase de unacarpeta a otra.

El componente control de animación reproduce los archivos de vídeo sin sonido. Elarchivo AVI no puede estar en formato comprimido a menos que se hayacomprimido con el método RLE (Running-Length Encoded).

En las aplicaciones Java, el componente control de animación se utiliza parareproducir una secuencia de archivos GIF utilizando el atributo NbrOfImage.

Atributos de componente

FileName FrameRate Handle* LeftMode NbrOfImage ParentName PartNamePartType Top UserData Visible

* Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Create Destroy

Capítulo 1. Componentes 3

|

Page 22: Manual Ibm

Calendario

El componente calendario presenta un calendario por meses. Al efectuar unapulsación sobre una de las flechas de los meses, el usuario puede navegar por elcalendario y desplazarse al mes anterior o posterior.

También tiene un control del programa absoluto sobre el calendario paradesplazarse hasta una fecha específica, determinar qué fecha ha seleccionado elusuario y añadir breves comentarios de texto a días individuales en el calendario.

Atributos de componente

Border Bottom ClearAll ClearDateClearMonth ClearYear Color ColorAreaColorMix Date DateIdx DateTextDateUnder Day DayIdx DayLenDayNumPos DayNumRect DayStart EnabledFontArea FontBold FontItalic FontNameFontSize FontStrike* FontUnder* FrmtStringHandle* Height HRule LeftMonth MonthArrow MonthIdx MonthLenOutlineRcl ParentName PartName PartTypeRefresh ShowRects ShowText TipTextTop UserData Visible VRuleWeekDay WeekDayIdx Width YearYearIdx YearLen

* Nota:: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Click Create Destroy DblClickMouseDown MouseEnter MouseExit MouseMoveMouseUp MthChange YearChange

4 VisualAge RPG Manual de consulta de componentes

Page 23: Manual Ibm

Lienzo

Utilice el componente lienzo con una ventana o una página de cuaderno si deseaponer más de un componente en la ventana o en la página de cuaderno. Puedecolocar diversos componentes en el lienzo señalándolos y pulsando el botón delratón y cambiarlos de posición para crear una interfaz gráfica de usuario.

El componente lienzo ocupa el área de cliente de una ventana o de una página decuaderno. Si en la ventana o en la página de cuaderno no hay lienzo, sólo puedecolocar un componente en el área de cliente, a menos que sean extensiones de laventana, como barras de menús y subarchivos de mensajes.

A menudo creará ventanas y páginas de cuaderno que contendrán más de uncomponente. En este caso, deberá utilizar los componentes página de cuaderno ycon lienzo y la ventana con lienzo. Así se ahorrará un paso, ya que estoscomponentes ya contienen el componente lienzo.

En tiempo de creación de la aplicación, también puede incluir una imagen debitmap a modo de fondo del lienzo; para ello, especifique el atributo FileName.Esta imagen puede ponerse en mosaico estableciendo el atributo Tile. En lasaplicaciones Java, puede incluir imágenes GIF o JPG como fondo.

Notas:

1. Los componentes lienzo, ventana (sin lienzo) y página de cuaderno (sin lienzo)se encuentran en el catálogo de componentes, no en la paleta de componentes.Si desea utilizarlos con frecuencia, puede añadirlos a la paleta de componentes.

2. Si los componentes situados en un componente lienzo tienen especificado elvalor de font por omisión (Font del sistema por omisión), heredarán la definiciónde font especificada en el componente lienzo. Para aplicar un font determinadoa la mayor parte de componentes de un lienzo, especifique ese font en elcomponente lienzo en lugar de hacerlo en cada componente individual.

Para obtener información relacionada, consulte el apartado:v “Ventana” en la página 49v “Ventana con lienzo” en la página 50v “Página de cuaderno” en la página 32v “Página de cuaderno con lienzo” en la página 33.

Capítulo 1. Componentes 5

Page 24: Manual Ibm

Atributos de componente

BackColor BackMix Bottom* EnabledFileName FontBold FontItalic FontNameFontSize FontStrike* FontUnder* Handle*Height Left ParentName PartNamePartType ReadOnly Refresh TileTop* UserData Width

* Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Click Create DblClick DestroyMouseDown MouseMove MouseUp Popup

6 VisualAge RPG Manual de consulta de componentes

Page 25: Manual Ibm

Recuadro de selección

Utilice el componente recuadro de selección si desea que el usuario elija entre dosestados claramente diferenciados; por ejemplo, activado y desactivado.

Una etiqueta asociada con el recuadro de selección describe el valor del mismocuando se selecciona.

Normalmente, se utiliza un grupo de recuadros de selección para proporcionar unalista de opciones. El usuario puede seleccionar uno, varios o ningún recuadro. Lasopciones no son mutuamente excluyentes; por lo tanto, marcar un recuadro deselección no tiene ningún efecto en otros recuadros de la ventana. Si desea que elusuario pueda seleccionar sólo una opción de un grupo de dos o más, utilicebotones de selección. Consulte el apartado “Botón de selección” en la página 40 sidesea más información.

Para definir el estado de un recuadro de selección, el usuario puede pulsar elbotón del ratón en el mismo, pulsar la barra espaciadora cuando el recuadro tengael foco o pulsar la tecla correspondiente al nemotécnico (si le ha asignado una).Para obtener información sobre la asignación de teclas nemotécnicas, consulte lapublicación Programación con VisualAge para RPG, SC10-3067-02 (SC09-2449-02).

Atributos de componente

AddLink* AllowLink* BackColor BackMixBottom Checked Enabled FocusFontBold FontItalic FontName FontSizeFontStrike* FontUnder* ForeColor ForeMixHandle* Height Highlight* LabelLeft ParentName PartName PartTypeRefresh RemoveLink* ShowTips TipTextTop UserData Visible Width

* Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Create Destroy MouseEnter MouseExitMouseMove Popup Select

Capítulo 1. Componentes 7

Page 26: Manual Ibm

Recuadro de combinación

Un recuadro de combinación ofrece al usuario la opción de escribir informaciónespecífica o de seleccionarla en una lista de opciones utilizadas con frecuencia.

Se compone de un campo de entrada con un recuadro de lista adjunto quepresenta una lista de valores por la que el usuario puede desplazarse. Si el usuarioselecciona uno de estos valores, aparecerá en el campo de entrada sustituyendocualquier texto que hubiese antes. De manera alternativa, el usuario puede escribirun valor, que no tiene por qué coincidir con ninguno de los que aparecen en lalista, directamente en el campo de entrada.

Hay disponibles varios estilos de recuadros de combinación. Puede seleccionar elestilo que desee en el cuaderno de propiedades del componente.

Para obtener información relacionada, consulte los apartados:v “Recuadro de lista” en la página 24v “Campo de entrada” en la página 14

Atributos de componente

AddItemEnd AutoScroll* BackColor BackMixBottom Case* Count DelimCharDeSelect* DragEnable* DropEnable* EnabledFieldExit FirstSel Focus FontBoldFontItalic FontName FontSize FontStrike*FontUnder* ForeColor ForeMix GetItemHandle* Height Index InsertItem*ItemKey Left ParentName PartNamePartType ReadOnly Refresh RemoveItemSearch* SearchType* Selected SelectItemSequence* SetItem SetTop* ShowtipsSizeToFit* Text TipText TopUseDelim UserData Visible Width

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

8 VisualAge RPG Manual de consulta de componentes

Page 27: Manual Ibm

Eventos a los que puede aplicarse

Change Create Destroy Drop*DropDown* Enter GotFocus KeyPressLostFocus MouseEnter MouseExit MouseMovePopup Select VKeyPress

*Nota: Consulte la descripción del evento si desea saber cuáles son lasrestricciones.

Capítulo 1. Componentes 9

Page 28: Manual Ibm

*Component

Este componente permite a los programadores acceder y utilizar atributos decomponente lógico y del sistema.

Un componente *component es la ″representación del componente″ delcomponente lógico. Para cada componente lógico se crea un componente*component; no se ve y no está en la paleta.

Atributos de componente

Active* Alarm AppData ButtonClipBoard CurrentDir Dialog DIRName*DlgOwner DoEvents* DspHeight DspWidthFileName HelpWindow LookNFeel* MsgDataMsgFile* MsgID MsgText NameOS Parent PartCount PartListPlatform PlugCmd* PlugDLL* PlugID*PlugRC* PlugResult* Printer* SelPrinter*ShData ShDataLen ShDataName ShDataPosShowMsgID SwitchTo* WrkStnName*

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarseEste componente no tiene eventos asociados.

10 VisualAge RPG Manual de consulta de componentes

Page 29: Manual Ibm

Referencia a componente lógico

El componente referencia a componente lógico permite que un componente lógicode VARPG se comunique con otro. Utilice el componente referencia a componentelógico para afectar a un componente del otro componente lógico. El componentelógico al que se hace referencia debe estar ejecutándose en la misma aplicación queel componente referencia a componente lógico.

El componente referencia a componente lógico también supervisa un eventoespecificado en el otro componente lógico. Cuando se produzca el eventosupervisado, el componente referencia a componente lógico señalará un eventoNotify.

Atributos de componente

AddSrcEvt AttrValue Bottom CompNameLeft NotSrcEvt NotSrcPart NotSrcWinParentName PartName PartType RefAttrRefParent RefPart RmvSrcEvt UserDataVisible

Eventos a los que puede aplicarse

Create Destroy Notify

Capítulo 1. Componentes 11

|

|

Page 30: Manual Ibm

Contenedor

Utilice el componente contenedor para almacenar registros relacionados. Losregistros se pueden mostrar en una vista de iconos, de árbol, de árbol de texto o dedetalles.

Atributos de componente

AddRcd Arrange BackColor BackMixBlankChar Bottom ChildCount ChildListCollapsed ColNumber Count DeSelectEditItem Enabled ExtSelect* FirstSelFocus FontBold FontItalic FontNameFontSize FontStrike* FontUnder* ForeColorForeMix GetNewID GetRcdFld GetRcdIconGetRcdText Handle* Height InUse*Label Left MiniIcon ParentIdParentList ParentName PartName PartTypeReadOnly RecordID Refresh RemoveRcdSelected SelectRcd SetRcdFld SetRcdIconSetRcdText SetTop* ShowTips SortAscSortDesc TipText Top UserDataView* Visible VisTitle VisTitlSepWidth

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Click Collapsed ColSelect CreateDblClick Destroy Enter ExpandedGotFocus KeyPress LostFocus MouseDownMouseEnter MouseExit MouseMove MouseUpPopup Select VKeyPress

12 VisualAge RPG Manual de consulta de componentes

|

Page 31: Manual Ibm

Cliente DDE

* Restricción: Este componente no está soportado en las aplicaciones Java.

Utilice el componente cliente DDE para intercambiar datos con otras aplicaciones(por ejemplo, hojas de cálculo), que den soporte al protocolo de intercambiodinámico de datos (DDE).

Este intercambio recibe el nombre de conversación DDE. La aplicación que iniciala conversación es el cliente y la aplicación que responde es el servidor. Paradeterminar si una aplicación da soporte a DDE, consulte la documentación que seha entregado con ella.

El componente cliente DDE da soporte a las conversaciones de enlace estático yenlace dinámico. Una conversación de enlace estático consta de un programacliente que realiza peticiones explícitas al programa servidor. Una conversación deenlace dinámico consta de un programa servidor que actualiza automáticamente elprograma cliente cuando se modifican sus datos.

Puede configurar conversaciones de enlace estático o dinámico en el cuaderno depropiedades del componente cliente DDE y en la lógica del programa.

Atributos de componente

AppName Bottom DDEAddLink DDEModeDDERmvLink Execute Format ItemLeft ParentName PartName PartTypePoke Request TimeOut TopTopic UserData Visible

Eventos a los que puede aplicarse

Create Data Destroy ExecuteAckPokeAck Terminate TimeOut

Capítulo 1. Componentes 13

Page 32: Manual Ibm

Campo de entrada

Utilice el componente campo de entrada si desea que el usuario pueda especificarvalores que no se pueden predecir. Un campo de entrada es un área en la que elusuario puede escribir o colocar texto. Sus límites suelen estar indicados. Elusuario puede desplazarse por el texto del campo de entrada si hay másinformación disponible de la que resulta visible.

Puede configurar el componente campo de entrada para que acepte datos de tipocarácter, numéricos o de doble byte (DBCS).

También puede hacer que el campo de entrada sea de sólo lectura, para que elusuario no pueda modificar la información que contiene directamente.

Puede señalar y pulsar un componente campo de entrada en la paleta decomponentes y después pulsar el botón del ratón en el componente subarchivopara crear un campo de entrada de subarchivo.

Atributos de componente

AddLink* Alignment AllowLink* AutoScroll*AutoSelect BackColor BackMix BottomCapsLock Copy CsrAtEnd CutDataType Delete DragEnable* DropEnable*Enabled FieldExit Focus FontBoldFontItalic FontName FontSize FontStrike*FontUnder* ForeColor ForeMix Handle*Height InsertMode* Left MaskedParentName PartName PartType PasteReadOnly Refresh RemoveLink* ShowTipsText TextEnd TextLength TextSelectTextStart TipText Top UserDataVisible Width

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

14 VisualAge RPG Manual de consulta de componentes

Page 33: Manual Ibm

Eventos a los que puede aplicarse

Change Click Create DblClickDestroy Drop GotFocus KeyPressLink* LostFocus MouseDown MouseEnterMouseExit MouseMove MouseUp PopupVKeyPress

*Nota: Consulte la descripción del evento si desea saber cuáles son lasrestricciones.

Capítulo 1. Componentes 15

Page 34: Manual Ibm

Gráfica

El componente gráfica le permite crear y diseñar un gráfico en el proyecto.Durante la ejecución podrá enviar datos al gráfico y modificar los atributos degráfico y el tipo de gráfico. El componente gráfica da soporte a los tipos de gráficacircular, de líneas, de barras y de líneas y barras.

Los tipos de gráfica de barras y de líneas permiten utilizar el control de textoToolTip. Si está habilitado, al mover el ratón sobre un punto de datos se visualizael control de texto de ayuda flotante. Para utilizar este soporte en la lógica delprograma, debe establecer el valor del punto en el atributo TipText y activar elatributo ShowTips para la ventana que contiene el componente gráfica.

Atributos de componente

AutoInc BarLabel Bottom ColorColorArea ColorMix DataGroup DataPointDataValue Enabled FillStyle* FontAreaFontBold FontItalic FontName FontSizeFontStrike* FontUnder* GnEqGrpCol GnEqPntColGraphType GroupLabel GrphHiLite Handle*Height HitItem* HlitPoints* LabelPlaceLeft LegendType ParentName PartNamePartType Refresh StartNew TipTextTitle TitlePlace Top UnderPoint*UseData UserData Visible WidthXAxisLabel YAxisLabel YInc

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Click Create Destroy DblClickMouseDown MouseEnter MouseExit MouseMoveMouseUp

16 VisualAge RPG Manual de consulta de componentes

|

Page 35: Manual Ibm

Pulsador gráfico

Utilice pulsadores gráficos para proporcionar un acceso fácil a las accionesutilizadas con frecuencia.

El pulsador gráfico proporciona la misma función que un pulsador. Indica unaacción que se iniciará cuando el usuario lo seleccione, pero en lugar de visualizaruna etiqueta que describa su función, muestra una imagen. El atributo FileNameespecifica el nombre de la imagen que debe utilizarse.

Los formatos válidos de imágenes de Windows son:v Bitmaps de Windows® y OS/2 (BMP, VGA, BGA, RLE, DIB, RL4, RL8)v Icono (ICO)v TIF, TIFF (Formato de Archivo de Imagen Codificada) de Microsoft/Aldusv GIF (Formato de Intercambio de Gráficos) de CompuServev PCX (Formato de Archivo de Imagen) de ZSoft PC Paintbrushv TGA, VST, AFI (Bitmap Targa/Vista) de Truevisionv IFF, ILBM (Formato de Bitmap Intercalado) de Amigav XBM (Bitmap) de X Windowsv PSE, PSEG, PSEG38PP, PSEG3820 (Segmento de Página de Impresora) de IBM

Los formatos válidos de imágenes Java son:v GIF (Formato de Intercambio de Gráficos) de CompuServev JPG, JPEG (formato Joint Photographic Experts Group)

Para obtener información relacionada, consulte el apartado “Pulsador” en lapágina 39.

Capítulo 1. Componentes 17

Page 36: Manual Ibm

Atributos de componente

Bottom Enabled FileName FocusHandle* Height HelpEnable HighLightLeft ParentName PartName PartTypeRefresh ShowTips TipText TopUserData Validate Visible Width

* Nota:: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Create Destroy GotFocus LostFocusMouseEnter MouseExit MouseMove PopupPress

18 VisualAge RPG Manual de consulta de componentes

Page 37: Manual Ibm

Recuadro de grupo

Utilice un recuadro de grupo para distinguir visualmente un grupo decomponentes de una ventana.

Un recuadro de grupo es un rectángulo trazado alrededor de un grupo decomponentes para indicar que están relacionados. Por lo general, es recomendableponer una etiqueta a un recuadro de grupo. Si no se precisa una etiqueta, puedeutilizar un recuadro de contorno.

Atributos de componente

Bottom Enabled FontBold FontItalicFontName FontSize FontStrike* FontUnder*ForeColor ForeMix Handle* HeightLabel Left ParentName PartNamePartType Refresh Top UserDataVisible Width

Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Create Destroy

Capítulo 1. Componentes 19

Page 38: Manual Ibm

Barra de desplazamiento horizontal

Utilice el componente barra de desplazamiento horizontal para poder desplazarsepor un panel de información de izquierda a derecha o viceversa. La informaciónpuede ser una lista de archivos, los registros de una base de datos, las columnas deun documento, etcétera. Puede utilizar el atributo Range para representar elnúmero total de los objetos por los que se efectuará el desplazamiento y el atributoPageSize para determinar el número de objetos que pueden visualizarse en unapágina.

Atributos de componente

Bottom Enabled Focus Handle*Height Left NextLine NextPagePageSize ParentName PartName PartTypePosition PrevLine PrevPage RangeTop UserData Visible Width

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Create Destroy Scroll

20 VisualAge RPG Manual de consulta de componentes

Page 39: Manual Ibm

Imagen

Utilice el componente imagen para visualizar imágenes. El atributo FileNameespecifica el nombre de la imagen que debe utilizarse.

Los formatos válidos de imágenes de Windows son:v Bitmaps de Windows y OS/2 (BMP, VGA, BGA, RLE, DIB, RL4, RL8)v Icono (ICO)v TIF, TIFF (Formato de Archivo de Imagen Codificada) de Microsoft/Aldusv GIF (Formato de Intercambio de Gráficos) de CompuServev PCX (Formato de Archivo de Imagen) de ZSoft PC Paintbrushv TGA, VST, AFI (Bitmap Targa/Vista) de Truevisionv IFF, ILBM (Formato de Bitmap Intercalado) de Amigav XBM (Bitmap) de X Windowsv PSE, PSEG, PSEG38PP, PSEG3820 (Segmento de Página de Impresora) de IBM

Los formatos válidos de imágenes Java son:v GIF (Formato de Intercambio de Gráficos) de CompuServev JPG, JPEG (formato Joint Photographic Experts Group)

Estos archivos residen en la estación de trabajo programable (PWS), no en elsistema principal. Debe almacenar los archivos de bitmap y de icono específicosdel sistema en el directorio de tiempo de ejecución adecuado (RT_JAVA oRT_WIN32) para que el programa de utilidad de empaquetado los incluya al crearel paquete de la aplicación.

Nota: El componente imagen sólo se puede soltar en una página de cuaderno conlienzo o en una ventana con lienzo.

Capítulo 1. Componentes 21

Page 40: Manual Ibm

Atributos de componente

AddLink* AllowLink* BackColor BackMixBorder Bottom Enabled FileNameHandle* Height Left MagnifyPanel ParentName PartName PartTypePrint Refresh RemoveLink* ShowTipsTipText Top UserData VisibleWidth

* Nota:: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Click Create DblClick DestroyLink* MouseEnter MouseExit MouseMove

* Nota:: Consulte la descripción del evento si desea saber cuáles son lasrestricciones.

22 VisualAge RPG Manual de consulta de componentes

Page 41: Manual Ibm

Bean Java

* Restricción: Este componente no está soportado en las aplicaciones Windows.

Utilice el componente bean Java para añadir beans JavaBeans® al proyecto. Losbeans Java sirven para llamar de forma directa a métodos Java. Si desea obtenermás información sobre las llamadas a métodos Java, consulte la publicaciónProgramación con VisualAge para RPG, SC10-3067-02 (SC09-2449-02).

Para desarrollar aplicaciones que utilicen el componente bean Java, debe tenerinstalado Java 2 Software Development Kit (J2SDK), Standard Edition, versión 1.2 osuperior, de JavaSoft, en la estación de trabajo. Si no tiene el J2SDK, puede bajarlode Sun Microsystems en el URL siguiente:http://www.javasoft.com/products/

Tras instalar el J2SDK, establezca la variable de entorno PATH de modo queapunte a la ubicación tanto del compilador Java como de jvm.dll, que forma partedel J2SDK y del JRE (Java Runtime Environment). Por ejemplo, si el directorioinicial de J2SDK es x:\jdk1.2, añada las siguientes sentencias en la variable PATH:x:\jdk1.2\bin

x:\jdk1.2\jre\bin\classic

Atributos de componente

AddEvent Bottom Enabled HeightLeft ParentName PartName PartTypeRmvEvent ShowProp Top UserDataVisible Width

Eventos a los que puede aplicarse

Create Destroy BeanEvent

Capítulo 1. Componentes 23

Page 42: Manual Ibm

Recuadro de lista

Utilice el componente recuadro de lista para proporcionar al usuario una lista deelementos de los que se pueden seleccionar uno o más. Un recuadro de lista constade elementos de sólo lectura. Un elemento de un recuadro de lista es una serie decaracteres.

Las barras de desplazamiento verticales y horizontales permiten al usuario verpartes de la lista que no están visualizadas. Puede configurar el recuadro de listade modo que el usuario pueda seleccionar un solo elemento o varios. Puedeutilizar los atributos Search, SearchType, and Case para buscar fácilmente en lalista un elemento determinado.

Atributos de componente

AddItemEnd AddLink* AllowLink* BackColorBackMix Bottom Case* CountDelimChar DeSelect DragEnable* DropEnable*Enabled ExtSelect* FirstSel FocusFontBold FontItalic FontName FontSizeFontStrike* FontUnder* ForeColor ForeMixGetItem Handle* Height IndexInsertItem* ItemKey Left MultSelectNbrOfSel ParentName PartName PartTypeRefresh RemoveItem RemoveLink* Search*SearchType* Selected SelectItem SelectListSequence* SetItem SetTop ShowTipsSizeToFit TipText Top UseDelimUserData Visible Width

* Nota:: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Create Destroy Drop* Enter*GotFocus KeyPress LostFocus MouseEnterMouseExit MouseMove Popup SelectVKeyPress

* Nota:: Consulte la descripción del evento si desea saber cuáles son lasrestricciones.

24 VisualAge RPG Manual de consulta de componentes

Page 43: Manual Ibm

Medios

Utilice el componente medios para reproducir o grabar información de audio opara reproducir archivos de vídeo.

El componente medios ofrece a los programas la posibilidad de procesar archivosde ondas (.WAV), MIDI (.MID) y QuickTime Movie (.MOV). Si desea utilizar estosarchivos de audio, el PC debe estar equipado con una tarjeta de sonido que puedaprocesar estos archivos. Para grabar un archivo de sonido, necesitará un micrófonoo algún otro dispositivo de entrada soportado por la tarjeta de sonido. Losarchivos MIDI no pueden grabarse con el componente medios.

Las aplicaciones Java deben tener instalada la API JMF (Java Media Framework).El componente medios sólo permite reproducir los archivos de audio y de vídeo enel entorno Java.

Los formatos de archivo de vídeo que se pueden procesar son: MPEG (*.mpg),QUICKTIME Movie (*.mov), *.dat y *.avi de Microsoft® Video para Windows enWindows NT/95/98. Para reproducir estos archivos de vídeo, el sistema debe tenerlos controladores adecuados.

Atributos de componente

AddLink* AllowLink* AudioMode Bass*Bottom FileName Handle* InPlaceLeft Length Panel ParentNamePartName PartType Position RemoveLink*Top Treble* UserData VisibleVolumen

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Complete Create Destroy Link*

*Nota: Consulte la descripción del evento si desea saber cuáles son lasrestricciones.

Capítulo 1. Componentes 25

Page 44: Manual Ibm

Panel de medios

Nota: Este componente no se utiliza en las aplicaciones Java.

Utilice el componente panel de medios para proporcionar un acceso rápido a lasacciones más utilizadas.

También puede utilizarlo para dar al usuario control sobre otros componentes sinnecesidad de crear lógica de programa. Por ejemplo, puede utilizarlo para crearpulsadores o controles de graduador que controlen el volumen o la modalidad deun componente medios.

En el cuaderno de propiedades del componente panel de medios, puede indicar losiguiente:v Qué botones, de un grupo definido, contendrá el panel de mediosv Si los graduadores de posición y volumen se visualizarán

Nota: El componente panel de medios sólo se puede soltar en una página decuaderno con lienzo o en una ventana con lienzo.

Atributos de componente

AddLink AllowLink BackColor BackMixBottom Enabled Handle HeightLeft PanelItem PanelMode ParentNamePartName PartType Position RemoveLinkTop UserData Visible VolumeWidth

Eventos a los que puede aplicarse

Change Create Destroy LinkMouseEnter MouseExit MouseMove PopupPress

26 VisualAge RPG Manual de consulta de componentes

Page 45: Manual Ibm

Barra de menús

Utilice el componente barra de menús para proporcionar a los usuarios acceso alos menús desplegables. Puede añadir componentes submenú y opción de menú ala barra de menús.

Las barras de menús aparecen en la parte superior del marco de la ventana, debajode la barra de título. Cuando el usuario selecciona un menú en ella, aparece unmenú desplegable con todas sus opciones. Al seleccionar una de ellas se iniciainmediatamente la acción que describe.

Nota: Las propiedades, los eventos, etcétera de este componente sólo se puedenmanipular desde su menú emergente de la vista de árbol de proyectos.

Para obtener información relacionada, consulte el apartado:v “Elemento de menú” en la página 28v “Submenú” en la página 46v “Menú emergente” en la página 37

Atributos de componente

PartType PartName ParentName UserData

Eventos a los que puede aplicarse

Create Destroy

Capítulo 1. Componentes 27

Page 46: Manual Ibm

Elemento de menú

Utilice los elementos de menú para crear menús desplegables o emergentes.

Una opción de menú describe una acción que se inicia cuando el usuarioselecciona esa opción.

Para crear un menú:1. Suelte un componente submenú en una barra de menús o en un menú

emergente.2. Suelte opciones de menú en el submenú.

Nota: Las propiedades, los eventos, etcétera de este componente sólo se puedenmanipular desde su menú emergente de la vista de árbol de proyectos.

Para obtener información relacionada, consulte el apartado:v “Barra de menús” en la página 27v “Menú emergente” en la página 37v “Submenú” en la página 46

Atributos de componente

Checked Enabled FileName LabelParentName PartName PartType UserData

Eventos a los que puede aplicarse

Create Destroy MenuSelect

28 VisualAge RPG Manual de consulta de componentes

Page 47: Manual Ibm

Subarchivo de mensajes

Utilice el componente subarchivo de mensajes para visualizar mensajespredefinidos o para visualizar texto proporcionado en la lógica del programa: porejemplo, información de error o de estado.

Este componente está situado siempre en la parte inferior de la ventana y ocupa laanchura de la ventana. No se puede cambiar la anchura de este componente; sinembargo, sí se puede cambiar la altura para que se visualicen más mensajes. Entiempo de ejecución, los usuarios pueden utilizar las barras de desplazamientopara ver todos los mensajes.

Atributos de componente

AddMsgID AddMsgText Count DragEnable*DropEnable* Enabled FirstSel FontBoldFontItalic FontName FontSize FontStrike*FontUnder* ForeColor ForeMix GetItemHandle* Height Index MsgSubTextNbrOfSel ParentName PartName PartTypeRemoveMsg Selected ShowTips TipTextUserData Visible

* Nota:: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Create Destroy Drop EnterMouseEnter MouseExit MouseMove PopupSelect

Capítulo 1. Componentes 29

Page 48: Manual Ibm

Edición de múltiples líneas

Utilice el componente edición de múltiples líneas si desea que el usuario puedaescribir varias líneas de texto.

El componente edición de múltiples líneas tiene límites definidos. A veces no sevisualiza todo el texto que contiene. El usuario puede desplazar el texto vertical yhorizontalmente para ver la parte que no se visualiza.

Atributos de componente

AddLineEnd AddOffset BackColor BackMixBottom CanUndo CharOffset CopyCsrLine CsrPos Cut DeleteDragEnable* DropEnable* Enabled FocusFontBold FontItalic FontName FontSizeFontStrike* FontUnder* ForeColor ForeMixHandle* Height InsertLine InsertTextLeft LineNumber LineText NbrOfLinesParentName PartName PartType PasteReadOnly Refresh ShowTips TextTextEnd TextLength TextSelect TextStartTextString TipText Top TopLineUndo UserData Visible WidthWordWrap

* Nota:: Consulte la descripción del atributo para conocer las restricciones.

Eventos a los que puede aplicarse

Change Click Create DblClickDestroy Drop GotFocus KeyPressLostFocus MouseDown MouseEnter MouseExitMouseMove MouseUp Popup VKeyPress

30 VisualAge RPG Manual de consulta de componentes

Page 49: Manual Ibm

Cuaderno

Utilice el componente cuaderno para presentar datos que se pueden agruparlógicamente por temas: por ejemplo, información de cliente dividida en categoríastales como Nombre, Dirección de envío, Pedidos y Créditos.

Un componente cuaderno es una representación gráfica de un cuaderno de espiral.(En aplicaciones Windows, recibe el nombre de control de separadores). Puedeañadir páginas al cuaderno y agruparlas en secciones separadas por hojasseparadoras con pestañas. Si la página de cuaderno tiene lienzo, puede añadir másde un componente a la misma. Si no tiene lienzo, sólo se puede añadir uncomponente.

El usuario puede pasar las páginas de un cuaderno para ir de una página a otra oir directamente a una sección del cuaderno pulsando el botón del ratón sobre lapestaña.

Puede añadir páginas de cuaderno del modo siguiente:v Utilizando el cuaderno de propiedades del componente cuadernov Señalando y pulsando (o arrastrando y soltando) una página de cuaderno o una

página de cuaderno con lienzo en el componente cuaderno.

Para obtener información relacionada, consulte el apartado:v “Página de cuaderno” en la página 32v “Página de cuaderno con lienzo” en la página 33

Atributos de componente

BackColor BackMix Bottom CountEnabled Focus FontBold FontItalicFontName FontSize FontStrike* FontUnder*ForeColor ForeMix Handle* HeightLeft PageNumber ParentName PartNamePartType Refresh ShowTabs* TopUserData Visible Width

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Create Destroy

Capítulo 1. Componentes 31

Page 50: Manual Ibm

Página de cuaderno

Utilice el componente página de cuaderno para añadir páginas a un cuaderno.

Solamente puede añadir un componente a una página de cuaderno; el tamaño delmismo se adaptará a la página. Si desea añadir más de un componente en unapágina, debe colocar un componente lienzo en la página de cuaderno. Tambiénpuede utilizar el componente página de cuaderno con lienzo para ahorrarse unpaso.

Nota: Las propiedades, los eventos, etcétera de este componente sólo se puedenmanipular desde su menú emergente de la vista de árbol de proyectos.

El usuario puede pulsar las teclas de flecha izquierda y derecha para ir de unapágina a otra.

Para obtener información relacionada, consulte los apartadosv “Cuaderno” en la página 31v “Página de cuaderno con lienzo” en la página 33

Atributos de componente

Enabled ParentName PartName PartTypeRefresh TabImage TabLabel UserDataVisible

Eventos a los que puede aplicarse

Create Destroy PageSelect

32 VisualAge RPG Manual de consulta de componentes

Page 51: Manual Ibm

Página de cuaderno con lienzo

Utilice la página de cuaderno con lienzo para añadir páginas a un componentecuaderno.

El componente lienzo ocupa el área de cliente de un componente página decuaderno. Si se añaden componentes al lienzo se puede crear una interfaz gráficade usuario.

Si sólo desea añadir un componente a la página, puede utilizar el componentepágina de cuaderno en lugar del componente página de cuaderno con lienzo.Puesto que dicho componente no tiene lienzo, el tamaño del componente que seañada se ajustará automáticamente.

Para obtener información relacionada, consulte el apartado:v “Página de cuaderno” en la página 32v “Cuaderno” en la página 31

Atributos de componente

Enabled ParentName PartName PartTypeTabImage TabLabel UserData Visible

Eventos a los que puede aplicarse

Create Destroy PageSelect

Capítulo 1. Componentes 33

Page 52: Manual Ibm

Interfaz ODBC/JDBC

El componente Interfaz ODBC/JDBC proporciona la posibilidad de procesararchivos de base de datos que den soporte a la API ODBC de Windows o la APIJDBC de JavaSoft. Foxpro, Access y Paradox son ejemplos de estos tipos dearchivos de base de datos.

Para desarrollar aplicaciones que puedan utilizar el componente InterfazODBC/JDBC, debe estar familiarizado con SQL y tener instalado el SDK ODBC deWindows o el Java 2 Software Development Kit (J2SDK), Standard Edition, deJavaSoft en la estación de trabajo.

Si no tiene el SDK ODBC, puede bajarlo de Microsoft en el URL siguiente:http://www.microsoft.com/odbc/download.htm

El soporte de JDBC forma parte del Java™ 2 Software Development Kit (J2SDK)Versión 1.2 para Windows. Si no tiene el J2SDK, puede bajarlo de SunMicrosystems en el URL siguiente:http://www.javasoft.com/products/

Las aplicaciones que acceden y manipulan datos de una base de datos JDBCnecesitan el controlador de conformidad con JDBC 2.0 adecuado. Puede encontrarel controlador JDBC y más información en el URL siguiente:http://java.sun.com/products/jdbc/

Nota: JDBC no se puede utilizar en applets.

Una base de datos ODBC o JDBC se compone de una o varias tablas. Los datos sealmacenan en una tabla como una serie de filas. Cada fila, o registro, contiene unnúmero de columnas con datos. El programa puede someter sentencias SQL juntocon los atributos del componente Interfaz ODBC/JDBC para manipular filas, opara traspasar datos entre campos del programa y columnas de tablas.

Para poder procesar una base de datos existente, el programa VARPG debeconectarse antes a la base de datos e indicar a qué tabla hace referencia. Paramanipular las filas de una tabla, el programa debe crear un conjunto de registrosque identifique los registros que el componente interfaz ODBC/JDBC debedevolver y mantener. Para acceder a los datos de una fila, debe enlazar cada unade las columnas utilizadas en la fila de la tabla con un campo del programa. En lasaplicaciones Java no se pueden utilizar los punteros. Una columna está enlazada aun componente; para enlazar sólo se pueden utilizar los componentes texto estáticoy campo de entrada.

Si crea una aplicación Java que utiliza el componente Interfaz ODBC/JDBC, losusuarios finales que ejecuten la aplicación deben instalar el archivo varpgjdb.jar ensus estaciones de trabajo y añadir su ubicación en la sentencia classpath. Elprograma de utilidad de empaquetamiento no incluye este archivo JAR. El archivoJAR está ubicado en el subdirectorio adtswin\java.

34 VisualAge RPG Manual de consulta de componentes

Page 53: Manual Ibm

Atributos de componente

AllowChg* BindPart Bottom BufferDec*BufferLen* BufferPtr* BufferType* CharDataColumn ColumnDec ColumnLen ColumnNameColumns ColumnType Connect ConnectedConnectStr CurrentRow DeleteRow ExecuteSQLFetch FetchNext FetchPrior GetTablesHandle* Height InsertRow IsDataLeft ParentName PartName PartTypeRefresh Rows* SQLError SQLMsgBoxSQLQuery Top UnBind UpdateRowUserData Visible Width

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Create Destroy

Capítulo 1. Componentes 35

Page 54: Manual Ibm

Recuadro de contorno

Utilice un recuadro de contorno alrededor de un grupo de componentes paraindicar que están relacionados.

Un recuadro de contorno no tiene etiqueta. Si en el recuadro debe aparecer unaetiqueta, utilice el componente recuadro de grupo en lugar de éste.

Para obtener información relacionada, consulte el apartado “Recuadro de grupo”en la página 19.

Atributos de componente

Bottom Handle* Height LeftParentName PartName PartType RefreshTop UserData Visible Width

Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Create Destroy

36 VisualAge RPG Manual de consulta de componentes

Page 55: Manual Ibm

Menú emergente

Utilice el componente menú emergente para visualizar las opciones que pertenecena un componente determinado de la interfaz. Puede añadir opciones de menú ysubmenús a los menús emergentes.

Este menú se llama “emergente” porque aparece cuando el usuario pulsa la tecla oel botón del ratón adecuados.

Nota: Las propiedades, los eventos, etcétera de este componente sólo se puedenmanipular desde su menú emergente de la vista de árbol de proyectos.

Para obtener información relacionada, consulte el apartado:v “Barra de menús” en la página 27v “Elemento de menú” en la página 28v “Submenú” en la página 46

Atributos de componente

Handle* InvName InvPName ParentNamePartName PartType UserData Visible*X Y

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarseNo hay eventos para este componente.

Capítulo 1. Componentes 37

Page 56: Manual Ibm

Barra de progreso

Utilice el componente barra de progreso para indicar de forma gráfica el progresode un proceso como, por ejemplo, copiar archivos, cargar una base de datos, etc.

Por ejemplo, para mostrar el progreso de copiar 100 archivos, puede establecer elatributo PBRange en 100 y el atributo PBStepSize en 10. El código podríasupervisar el proceso de copiar archivos y el indicador de barra de progresoavanzaría en pasos por cada diez archivos copiados.

En las aplicaciones Java, si el ancho de la barra de progreso es menor que la altura,la barra de progreso será vertical.

Atributos de componente

Bottom Handle* Height LeftParentName PartName PartType PBRangePBSetPos PBStep PBStepSize TopUserData Visible Width

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Create Destroy

38 VisualAge RPG Manual de consulta de componentes

Page 57: Manual Ibm

Pulsador

Utilice pulsadores para proporcionar un acceso rápido a las acciones másutilizadas.

Cada componente pulsador controla una acción determinada. Cuando el usuario lopulsa, la acción se inicia inmediatamente. La etiqueta de texto del pulsadordescribe la acción que éste realiza.

Comparese con el componente “Pulsador gráfico” en la página 17.

Atributos de componente

BackColor BackMix Border* BottomEnabled Focus FontBold FontItalicFontName FontSize FontStrike* FontUnder*ForeColor ForeMix Handle* HeightHelpEnable HighLight Label LeftParentName PartName PartType RefreshShowTips TipText Top UserDataValidate Visible Width

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Create Destroy GotFocus LostFocusMouseEnter MouseExit MouseMove PopupPress

Capítulo 1. Componentes 39

Page 58: Manual Ibm

Botón de selección

Utilice botones de selección si desea que el usuario seleccione sólo una opción deun grupo de opciones relacionadas pero que se excluyen mutuamente. Cuando elusuario efectúa una selección, la opción seleccionada anteriormente en el grupo sedeselecciona.

Un botón de selección tiene forma circular con los bordes en relieve y a su ladohay texto. Cuando está seleccionado, contiene un punto.

No utilice botones de selección si desea que el usuario pueda seleccionar más deuna opción al mismo tiempo. En este caso, consulte el apartado “Recuadro deselección” en la página 7.

Atributos de componente

BackColor BackMix Bottom CheckedEnabled Focus FontBold FontItalicFontName FontSize FontStrike* FontUnder*ForeColor ForeMix Handle* HeightHighLight* Label Left ParentNamePartName PartType Refresh SelectIdxShowTips TipText Top UserDataVisible Width

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Create Destroy Enter MouseEnterMouseExit MouseMove Popup Select

40 VisualAge RPG Manual de consulta de componentes

Page 59: Manual Ibm

Graduador

Utilice el componente graduador si desea que el usuario visualice, establezca omodifique un valor moviendo el eje del graduador.

Los graduadores suelen utilizarse para valores con incrementos habituales, comolos segundos o los grados, o con el fin de mostrar qué porcentaje se ha realizadode una tarea.

Por omisión, el graduador se sitúa horizontalmente en el centro de un recuadrocon su eje en el lado izquierdo. Se puede visualizar una escala para mostrar lasunidades de medida del graduador.

Utilice el cuaderno de propiedades del componente graduador para:v Definir el rango de valores que un graduador puede devolver.v Colocar el graduador en posición vertical u horizontal en una ventana.v Proporcionar una escala para indicar la unidad de medida del graduador.

Atributos de componente

AddLink* AllowLink* BackColor BackMixBottom Enabled Focus FontBoldFontItalic FontName FontSize FontStrike*FontUnder* ForeColor ForeMix Handle*Height Left Maximum MinimumParentName PartName PartType RefreshRemoveLink* ShowTips TickLabel TickNumberTipText Top UserData ValueVisible Width

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Change Create Destroy GotFocusLink* LostFocus MouseEnter MouseExitMouseMove Popup

*Nota: Consulte la descripción del evento si desea saber cuáles son lasrestricciones.

Capítulo 1. Componentes 41

Page 60: Manual Ibm

Selector cíclico

Utilice el componente selector cíclico para visualizar, de forma secuencial, ungrupo de opciones relacionadas, pero que se excluyen mutuamente, que tienen unorden consecutivo lógico; por ejemplo, los meses del año. Las opciones sevisualizan como si estuvieran organizadas en forma de anillo. El usuario puedemover (o “girar”) las opciones pulsando la flecha arriba para ir al valor superiorsiguiente o la flecha abajo para ir al valor inferior siguiente. También puedeescribir una opción directamente en el campo de entrada del selector cíclico.

Atributos de componente

AddItemEnd Alignment* BackColor BackMixBottom Enabled Focus FontBoldFontItalic FontName FontSize FontStrike*FontUnder* ForeColor ForeMix Handle*Height Left Maximum MinimumParentName PartName PartType ReadOnlyRefresh RemoveItem ShowTips TextTipText Top UserData ValueVisible Width

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Change Create Destroy GotFocusLink* LostFocus MouseEnter MouseExitMouseMove Popup SpinDown SpinEndSpinUp

*Nota: Consulte la descripción del evento si desea saber cuáles son lasrestricciones.

42 VisualAge RPG Manual de consulta de componentes

Page 61: Manual Ibm

Texto estático

Utilice el componente texto estático como etiqueta de otros componentes, porejemplo, como mensaje de solicitud de un componente campo de entrada. Loscomponentes texto estático no aceptan la entrada de datos por parte del usuario.En las aplicaciones Java, el texto estático se visualiza únicamente en una sola línea.

Atributos de componente

Alignment BackColor BackMix BottomDataType DragEnable* DropEnable* EnabledFontBold FontItalic FontName FontSizeFontStrike* FontUnder* ForeColor ForeMixHandle* Height Label LeftParentName PartName PartType RefreshShowTips TipText Top UserDataVisible Width

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Click Create DblClick DestroyDrop Link* MouseDown MouseEnterMouseExit MouseMove MouseUp Popup

*Nota: Consulte la descripción del evento si desea saber cuáles son lasrestricciones.

Capítulo 1. Componentes 43

Page 62: Manual Ibm

Barra de estado

Utilice el componente barra de estado para proporcionar información adicionalsobre un proceso o una acción de la ventana. Puede crear hasta cinco paneles parala barra de estado. El componente barra de estado proporciona al componenteventana mayor flexibilidad que el atributo StatusBar.

Por omisión, la barra de estado se crea en la parte inferior de la ventana. Noobstante, puede utilizar el cuaderno de propiedades para colocarla en la partesuperior. También puede establecer el estilo del borde, el número de paneles y laalineación del texto.

Atributos de componente

Handle* ParentName PartName PartTypeSBIndex SBLabel SBPanes UserDataVisible

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Create Destroy

44 VisualAge RPG Manual de consulta de componentes

Page 63: Manual Ibm

Subarchivo

Utilice el componente subarchivo para visualizar una lista de registros, cada unode los cuales consta de uno o más campos.

La función del componente subarchivo es similar a la de un subarchivo deAS/400

®

. El usuario puede desplazar el contenido de la lista en sentido horizontalo vertical utilizando las barras de desplazamiento del subarchivo.

Para crear un campo de entrada de subarchivo, añada un campo de la ventanaDefinir campos de referencia o de la paleta de componentes en el componentesubarchivo. También puede añadir campos utilizando el cuaderno de propiedades.

Nota: El componente subarchivo sólo se puede colocar en una página de cuadernocon lienzo o en una ventana con lienzo.

Atributos de componente

AddItemEnd AllowEdit AutoSelect BackColorBackMix Bottom ButtonIdx ButtonsButtonTip CapsLock CellBGClr CellBGMixCellFGClr CellFGMix ColBGClr ColBGMixColFGClr ColFGMix ColNumber ColWidthCount DeSelect EnableBtn EnabledExtSelect* FirstSel Focus FontAreaFontBold FontItalic FontName FontSizeFontStrike* FontUnder* ForeColor ForeMixHandle* HdgBGClr HdgBGMix HdgFGClrHdgFGMix HdgIdx HdgText HeightHidden HRule Index ItemCountLeft MultSelect NbrOfSel OpenEditPageSize ParentName PartName PartTypeRemoveItem RowBGClr RowBGMix RowFGClrRowFGMix Scale Selected SelectItemSelectList SetTop SflNxtChg ShowTipsSizeToFit StartAt TipText TopTopRecord UserData Visible VRuleWidth

* Nota:: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Change ColSelect Create DestroyEnter FirstRec GotFocus KeyPressLastRec LostFocus MouseEnter MouseExitMouseMove NextRec PageDown PageEndPageTop PageUp Popup PrevRecSelect VKeyPress

Capítulo 1. Componentes 45

Page 64: Manual Ibm

Submenú

Utilice un submenú para:v Iniciar un menú en cascada nuevo a partir de una opción de menú de un menú

ya existente.v Iniciar un menú desplegable a partir de una opción de menú de la barra de

menús.

Tras crear un submenú, puede añadirle opciones de menú colocando componentesopción de menú, pero solamente en la vista de árbol.

Nota: Las propiedades, los eventos, etcétera de este componente sólo se puedenmanipular desde su menú emergente de la vista de árbol de proyectos.

Para obtener información relacionada, consulte el apartado “Elemento de menú” enla página 28.

Atributos de componente

ParentName PartName PartType UserData

Eventos a los que puede aplicarse

Create Destroy

46 VisualAge RPG Manual de consulta de componentes

Page 65: Manual Ibm

Temporizador

Utilice el componente temporizador si el programa debe realizar determinadasoperaciones en intervalos de tiempo preestablecidos. Por ejemplo, puede utilizarlopara cerrar una ventana o para finalizar una aplicación después de un periododeterminado de inactividad.

El componente temporizador cuenta unidades de tiempo e inspecciona el intervalode tiempo preestablecido entre dos eventos, desencadenando el segundo eventocuando ha pasado el tiempo necesario.

Cuando se crea un componente temporizador en el constructor GUI, elcomponente aparece en forma de icono en la ventana de diseño. Sin embargo, en elcuaderno de propiedades de un componente temporizador, puede especificar queno desea que el icono se visualice mientras el programa se ejecuta.

Nota: No utilice el componente temporizador cuando precise un control exacto deltiempo. El evento Tick puede no producirse en el intervalo exacto que haespecificado, a causa de otros programas que estén ejecutándose en elsistema.

Atributos de componente

AddLink* AllowLink* Bottom IntervalLeft Multiplier ParentName PartNamePartType RemoveLink* TimerMode TimerTicksTop UserData Visible

* Nota:: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Create Destroy Link* Tick

* Nota:: Consulte la descripción del evento si desea saber cuáles son lasrestricciones.

Capítulo 1. Componentes 47

Page 66: Manual Ibm

Barra de desplazamiento vertical

Utilice el componente barra de desplazamiento vertical para poder desplazarse porun panel de información de arriba abajo. La información puede ser una lista dearchivos, los registros de una base de datos, las columnas de un documento,etcétera. Puede utilizar el atributo Range para representar el número total de losobjetos por los que se efectuará el desplazamiento y el atributo PageSize paradeterminar el número de objetos que pueden visualizarse en una página.

Atributos de componente

Bottom Enabled Focus Handle*Height Left NextLine NextPagePageSize ParentName PartName PartTypePosition PrevLine PrevPage RangeTop UserData Visible Width

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Create Destroy Scroll

48 VisualAge RPG Manual de consulta de componentes

Page 67: Manual Ibm

Ventana

Las ventanas son el medio primordial que tiene el usuario de interactuar con elprograma. Las aplicaciones deben contener al menos una ventana.

Sólo puede añadir un componente al área de cliente de una ventana, con laexcepción de los componentes que son extensiones del marco de la ventana, comolas barras de menús, los menús emergentes y los subarchivos de mensajes. Eltamaño del componente que añada se ajusta automáticamente al área de cliente.

Si desea que una ventana contenga más de un componente, deberá añadirle uncomponente lienzo. Puede utilizar el componente ventana con lienzo paraahorrarse un paso.

Nota: El componente ventana se encuentra en el apartado Marcos del catálogo decomponentes, no en la paleta de componentes.

Para obtener información relacionada, consulte los apartados:v “Lienzo” en la página 5v “Ventana con lienzo” en la página 50

Atributos de componente

Bottom Center Enabled FileName*Focus* FontBold* FontItalic* FontName*FontSize* FontStrike* FontUnder* Handle*Height IconHandle* Label LeftMouseIcon* MouseShape* ParentName PartNamePartType PBRange PBSetPos PBStepPBStepSize Print ProgresBar RefreshSBLabel SBPosition SBStyle ShowTipsStatusBar Top UserData VisibleWidth WindowMode*

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Activate Close Create DeActivateDestroy LClickTray Moved RClickTrayReSize ShutDown

Capítulo 1. Componentes 49

|

Page 68: Manual Ibm

Ventana con lienzo

Las ventanas son el medio primordial que tiene el usuario final para interactuarcon el programa. El lienzo, en un componente ventana con lienzo, le permiteañadir varios componentes a la ventana.

Puede colocar diversos componentes en el lienzo señalándolos y pulsando el botóndel ratón y cambiarlos de posición para crear una interfaz gráfica de usuario.También puede añadir componentes que sean extensiones del marco de la ventana,como barras de menús, menús emergentes y subarchivos de mensajes.

Si sólo precisa colocar un componente en el área de cliente de la ventana, nonecesita el componente ventana con lienzo: en lugar de éste, debe usar elcomponente ventana (que se encuentra en la sección Marcos del catálogo decomponentes). Sin lienzo, el tamaño del componente añadido se ajustaautomáticamente al área de cliente.

Para obtener información relacionada, consulte los apartados:v “Lienzo” en la página 5v “Ventana” en la página 49

Atributos de componente

Bottom Center Enabled FileName*Focus* FontBold* FontItalic* FontName*FontSize* FontStrike* FontUnder* Handle*Height IconHandle* Label LeftMouseIcon* MouseShape* ParentName PartNamePartType PBRange PBSetPos PBStepPBStepSize Print ProgresBar RefreshSBLabel SBPosition SBStyle ShowTipsStatusBar Top UserData VisibleWidth WindowMode*

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

Eventos a los que puede aplicarse

Activate Close Create DeActivateDestroy LClickTray Moved RClickTrayReSize ShutDown

50 VisualAge RPG Manual de consulta de componentes

|

Page 69: Manual Ibm

Capítulo 2. Atributos de componente

Al crear la interfaz gráfica de usuario (GUI) mediante VisualAge RPG, puedeestablecer o cambiar la mayor parte de los atributos de un componente abriendo elcuaderno de propiedades de ese componente.

También puede establecer los atributos de la mayoría de los componentes entiempo de ejecución en el programa de aplicación VisualAge RPG mediante lasfunciones incorporadas o los códigos de operación. Para ello, codifique la funciónincorporada %setatr en el código de operación EVAL de formato libre, o utilice elcódigo de operación SETATR. Para recuperar los valores de los atributos decomponente, codifique la función incorporada %getatr en el código de operaciónEVAL de formato libre o utilice el código de operación GETATR.

Este apartado describe los atributos de componente. Cada una de las descripcionescontiene lo siguiente:v Una descripción general del atributo.v El tipo de datos del atributo.v Una lista de los componentes a los que se aplica el atributo.v Una tabla que indica si el usuario puede establecer u obtener el atributo

mediante las funciones incorporadas o los códigos de operación. Esta tablatambién indica si se puede establecer un atributo utilizando el cuaderno depropiedades de un componente.

v Los valores permitidos para el atributo.v Ejemplos de sintaxis de formato libre y de códigos de operación. Para conocer

los detalles de la sintaxis, consulte la publicación VisualAge RPG Manual deconsulta del lenguaje.

Nota: Algunos ejemplos utilizados en este capítulo utilizan texto en mayúsculasúnicamente. No obstante, la lógica se puede entrar en mayúsculas o enminúsculas.

v Cualquier restricción aplicable.

© Copyright IBM Corp. 1994, 2000 51

Page 70: Manual Ibm

ActivateEstablezca este atributo en 1 para activar un objeto ActiveX.

Tipo Numérico

Se aplica a los componentes

ActiveX

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'AX1': 'Activate') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'AX1' SETATR 1 'ACTIVATE'*

52 VisualAge RPG Manual de consulta de componentes

Page 71: Manual Ibm

Active

*Restricción: Este atributo no está soportado en las aplicaciones Java.

Determina si hay otra instancia del componente lógico en ejecución.

Tipo Numérico

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor permitido

El valor de Active puede ser uno de los siguientes:

0 La instancia actual es la única instancia del componente lógico

1 Se está ejecutando otra instancia del componente lógico

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Act=%getatr('*Component':'*Component':'Active')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*COMPONENT' GETATR 'Active' Act*

Capítulo 2. Atributos de componente 53

Page 72: Manual Ibm

AddEventAñade el nombre de evento a la lista de filtro de eventos. Puede utilizar el valorespecial *ALL para que el componente ActiveX o bean Java direccione al programaVARPG todos los eventos disponibles almacenados en la lista. Por omisión, elcomponente ActiveX o bean Java no direcciona ningún evento.

Para crear una nueva lista de eventos parcial después de haber emitidoAddEvent(*ALL), primero debe vaciar la lista con el atributo RmvEvent.

Tipo Serie

Se aplica a los componentes

ActiveX Bean Java

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'AX1':'AddEvent')='EVT2'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'AX1' SETATR 'EVT2' 'ADDEVENT'*

54 VisualAge RPG Manual de consulta de componentes

Page 73: Manual Ibm

AddItemEndAñade un nuevo elemento al final de la lista.

En un componente subarchivo, este atributo se aplica a un campo de entrada desubarchivo que tenga valores definidos como tipo de validación. Utilice esteatributo para añadir valores a la lista de validación del campo de entrada delsubarchivo. Primero ha de establecer el atributo ColNumber a fin de identificar lacolumna con la que se debe trabajar.

Tipo Serie

Se aplica a los componentes

Recuadro decombinación

Recuadro de lista Selector cíclico Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl elemento que se añadirá a la lista o el valor de validación del campo deentrada del subarchivo

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'LB1':'AddItemEnd')=newitem*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' SETATR 'NEWITEM' 'ADDITEMEND'*

Capítulo 2. Atributos de componente 55

Page 74: Manual Ibm

AddLineEndAñade una nueva línea después de la última línea de un campo de edición demúltiples líneas.

Tipo Serie

Se aplica a

Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoLa nueva línea de texto

Ejemplo de formato libre

Obtener el valor de texto de un campo de entrada y añadirlo al final de uncampo de edición de múltiples líneas*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'MLE1':'AddLineEnd')=newtext*

Ejemplo de formato fijo

Añadir una línea al final de un campo de edición de múltiples líneas.*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' SETATR 'NEWTEXT' 'ADDLINEEND'*

56 VisualAge RPG Manual de consulta de componentes

Page 75: Manual Ibm

AddLink

*Restricción: Este atributo no está soportado en las aplicaciones Java.

Enlaza un componente destino con su componente origen. Si el atributoAllowLink también está establecido, el componente destino genera un evento Linkcuando este componente se modifica.

Para obtener una lista de tipos de componentes que se pueden enlazar, consulte laTabla 1.

Tabla 1. Componentes origen y destino permitidos

Cuando Componenteorigen

Respuesta del componente de destinoenlazado

Cambio de modalidad oposición

Medios El Panel de medios responde al cambio demodalidad del componente Medios.

Se selecciona Recuadro deselección

El componente Temporizador se habilita o seinhabilita.

Valor modificado Campo deentrada

Medios: se establece el nombre de archivo.

Campo de entrada: se actualiza el valor detexto.

Imagen: se establece el nombre de archivo.

Graduador: se actualiza el valor numérico.

Selector cíclico: se actualiza el valor numérico.

Texto estático: se actualiza el valor de texto.

Cambios nombre archivo Imagen Texto estático: se actualiza el valor de texto.

Se selecciona Recuadro delista

Medios: se establece el nombre de archivo.

Campo de entrada: se actualiza el valor detexto.

Imagen: se establece el nombre de archivo.

Texto estático: se actualiza el valor de texto.

Cambio de control Panel demedios

El componente Medios responde al cambio demodalidad del componente Panel de medios.

Cambio de nivel Graduador Campo de entrada: se actualiza el valor detexto.

Graduador: se actualiza el valor numérico.

Texto estático: se actualiza el valor de texto.

Tick Temporizador Texto estático: se actualiza el valor de texto.

El contador del temporizador se pone a cero.

Capítulo 2. Atributos de componente 57

Page 76: Manual Ibm

Tipo Serie

Se aplica a los componentes

Recuadro de selección Campo de entrada Imagen Recuadro de listaMedios Panel de medios Graduador Temporizador

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR no

* Nota: Puede definirse utilizando el cuaderno de propiedades deldiseñador GUI. Para ello, utilice la página Enlace y rellene loscampos Nombre de componente de destino y Nombre decomponente padre de destino.

Valor permitidoNombre del componente con el que se va a enlazar.

El nombre del componente debe tener el formato:'ventana|componente'

donde ventana es la ventana donde está ubicado el componente ycomponente es el nombre del componente.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'CB1':'AddLink')='WIN1|TIMER1'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CB1' SETATR 'WIN1|TIMER1' 'ADDLINK'*

58 VisualAge RPG Manual de consulta de componentes

Page 77: Manual Ibm

AddMsgIDAñade un mensaje al componente subarchivo de mensajes.

Los mensajes se añaden después de los mensajes existentes en el componentesubarchivo de mensajes.

Tipo Numérico

Se aplica a los componentes

Subarchivo demensajes

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

El identificador de mensaje (msgid), que es un número de cuatro dígitos delongitud como máximo.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'MSG1': 'AddMsgID') = 1234*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MSG1' SETATR 1234 'ADDMSGID'*

Capítulo 2. Atributos de componente 59

Page 78: Manual Ibm

AddMsgTextAñade un mensaje al componente subarchivo de mensajes. El mensaje se añade enforma de serie.

Los mensajes se añaden después de los mensajes existentes en el componentesubarchivo de mensajes.

Tipo Serie

Se aplica a los componentes

Subarchivo demensajes

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoSerie de texto del mensaje

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'MSG1':'AddMsgText')='Help!'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MSG1' SETATR 'Help!' 'ADDMSGTEXT'*

60 VisualAge RPG Manual de consulta de componentes

Page 79: Manual Ibm

AddOffsetInserta el texto especificado en el campo de edición de múltiples líneas en eldesplazamiento de caracteres especificado mediante el atributo CharOffset.

Tipo Serie

Se aplica a los componentes

Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoSerie a insertar en el campo de edición de múltiples líneas

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'MLE1': 'CharOffset') = 10C EVAL %setatr('win01': 'MLE1': 'AddOffset') = 'XXX'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' SETATR 10 'CHAROFFSET'C 'MLE1' SETATR 'XXX' 'ADDOFFSET'*

Capítulo 2. Atributos de componente 61

Page 80: Manual Ibm

AddRcdAñade un registro nuevo a un contenedor

Tipo Serie

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

El valor que se transfiere a este atributo debe ser una serie que conste delos parámetros siguientes, cada uno separado por un espacio:

Estructura de registro

ID Valor numérico utilizado para identificar el registro. Declare estevalor de modo que pueda contener la cantidad máxima deregistros que espera que contenga el contenedor.

Nota: Puede utilizar el atributo GetNewID para que VisualAgeRPG genere un identificador exclusivo para usted.

Text Texto que aparecerá junto al icono del registro cuando elcontenedor esté en la vista de iconos o en la vista de árbol.

FileNameNombre de archivo del icono.

ParentIDIdentificador del registro padre de este registro. Si el registro notiene padre, este parámetro tendrá el valor 0.

field_dataEste valor es opcional. Si se especifica, los datos se situarán en loscampos correspondientes del registro. Es necesario proporcionardatos para todos los campos del registro. El número de campos decada registro del componente contenedor en el diseñador GUI yaestá definido; por tanto, sólo debe especificar ese número.

Nota: Si los datos de un campo no están disponibles, utilice elcarácter de subrayado ( _ ) como reserva de posición para elcampo. Si un campo contiene blancos intercalados, debensustituirse por el carácter de subrayado antes de añadir elregistro. Los blancos intercalados aparecerán en los datos delcampo del registro añadido.

Los datos de los campos se pueden actualizar después de añadir elregistro utilizando el atributo SetRcdFld.

Ejemplo de formato libre

62 VisualAge RPG Manual de consulta de componentes

Page 81: Manual Ibm

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+.DName+++++++++++ETDsFrom+++To/L+++IDc.Keywords+++++++++++++++++++++++++D NewRecordD RecordID 1 6D FileName 8 64D Parent 1 6 INZ(0)D Text 8 20 INZ('Next record')**...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C Eval RecordID=%getatr('win01': 'CN1': 'GetNewID')C Eval FileName = 'D:\VRPG\NEW.ICO'C Eval %setatr('win01': 'CN1': 'AddRcd') = NewRecord*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' SETATR NewRecord 'ADDRCD'*

Capítulo 2. Atributos de componente 63

Page 82: Manual Ibm

AddSrcEvtAñade un nuevo evento de origen a la lista actual de eventos que supervisa elcomponente de referencia a componente lógico. Este atributo permite que uncomponente de referencia a componente lógico supervise varios eventos. Paraeliminar eventos de origen de la lista, utilice el atributo RmvSrcEvt.

Para identificar el evento de origen que se añade, especifique juntos los nombresdel componente lógico, la ventana, el componente y el evento. El formato de laserie es:'NOMBRECOMPLÓGICO | NOMBREVENTANA | NOMBRECOMP | NOMBREVENTO'

Dado que el compilador no realiza ninguna comprobación de validez, deberáidentificar correctamente cada evento de origen.

Tipo Serie

Se aplica a los componentes

Referencia acomponente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+.DName+++++++++++ETDsFrom+++To/L+++IDc.Keywords+++++++++++++++++++++++++D Event S 100**...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Event='compb|win02|ef02|change'C EVAL %setatr('win01': 'CRP1':C 'AddSrcEvt')=Event*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+.DName+++++++++++ETDsFrom+++To/L+++IDc.Keywords+++++++++++++++++++++++++D Event S 100**...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Event='compb|win02|ef02|change'C 'CRP1' SETATR Event 'ADDSRCEVT'*

64 VisualAge RPG Manual de consulta de componentes

|

||||

|||

|

||

||

|

||||||

|

|

|||

||

|||

|

|||||||||||

|

||||||||||

|

Page 83: Manual Ibm

AlarmHace que el altavoz emita un pitido.

Tipo Numérico

Se aplica a los componentes

*Componente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl valor de este atributo debe establecerse en 1.

Ejemplo de formato libre

Hacer que se oiga un pitido:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*Component':'*Component':'Alarm')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*COMPONENT' SETATR 1 'ALARM'*

Capítulo 2. Atributos de componente 65

Page 84: Manual Ibm

AlignmentEste atributo determina cómo se alinean el texto y las etiquetas en loscomponentes.

Tipo Numérico

Se aplica a los componentes

Campo de entrada* Selector cíclico* Texto estático

* Restricciones:: Una vez establecido este atributo, no puede cambiarse entiempo de ejecución.

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

El valor de Alignment puede ser uno de los siguientes:

1 Texto alineado a la izquierda

2 Texto alineado a la derecha

3 Texto centrado

66 VisualAge RPG Manual de consulta de componentes

Page 85: Manual Ibm

Ejemplo de formato libre

Si el texto de un componente está justificado a la izquierda, hacer que estéalineado a la derecha:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL align = %getatr('win01': 'ST1': 'Alignment')*C align IFEQ 1C EVAL %setatr('win01': 'ST1': 'Alignment') = 2*C ELSEC EVAL %setatr('win01': 'ST1': 'Alignment') = 1C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ST1' GETATR 'ALIGNMENT' ALIGN 1 0C ALIGN IFEQ 1C 'ST1' SETATR 2 'ALIGNMENT'*C ELSEC 'ST1' SETATR 1 'ALIGNMENT'**C ENDIF*

Capítulo 2. Atributos de componente 67

Page 86: Manual Ibm

AllowChg

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Identifica los datos de columna como un tipo de datos VARPG no soportado. Enesta columna de datos no se realizan actualizaciones.

Al ejecutar una acción FetchNext, FetchPrior, InsertRow o UpdateRow, los datosse traspasan del almacenamiento intermedio del campo de programa a la columnade tabla correspondiente, o viceversa. Si la columna tiene un tipo de datos VARPGno soportado, debe establecer el atributo AllowChg en 0. El valor por omisión es1. (Consulte el apartado “BufferType” en la página 93 para obtener una lista de lostipos de datos soportados).

Establezca el atributo Column en la columna deseada antes de establecer el valorAllowChg.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de AllowChg puede ser uno de los siguientes:

0 Tipo de datos VARPG no soportado.

1 Tipo de datos VARPG soportado. Por omisión, esta opción estáseleccionada.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'ODBC1': 'AllowChg') = 0*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' SETATR 0 'AllowChg'*

68 VisualAge RPG Manual de consulta de componentes

Page 87: Manual Ibm

AllowEditDetermina si se pueden editar los campos de entrada de subarchivo. El estado deedición se puede especificar para el subarchivo, el registro, la columna o la casilla.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

AllowEdit puede tener uno de estos valores:

1 Impide editar el subarchivo completo.

2 Impide editar el registro que especifica el atributo Index.

3 Impide editar la columna que especifica el atributo ColNumber.

4 Impide editar la casilla que especifican los atributos ColNumber eIndex.

11 Permite editar el subarchivo completo.

12 Permite editar el registro que especifica el atributo Index.

13 Permite editar la columna que especifica el atributo ColNumber.

14 Permite editar la casilla que especifican los atributos ColNumber eIndex.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'SFL1': 'Index') = 5C EVAL %setatr('win01': 'SFL1': 'AllowEdit') = 12*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' SETATR 5 'INDEX'C 'SFL1' SETATR 12 'ALLOWEDIT'*

Capítulo 2. Atributos de componente 69

Page 88: Manual Ibm

AllowLink

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Este atributo determina si el componente destino especificado por el atributoAddLink o DDEAddLink generará un evento Link cuando el componente origense modifique.

Tipo Numérico

Se aplica a los componentes

Recuadro de selección Campo de entrada Imagen Recuadro de listaMedios Panel de medios Graduador Temporizador

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

* Nota: Puede definirse utilizando el cuaderno de propiedades deldiseñador GUI. Para ello, utilice la página Enlace y seleccioneHabilitar notificación al destino.

Valor permitido

El valor de AllowLink puede ser uno de los siguientes:

0 El evento Link no se señala

1 El evento Link se señala

70 VisualAge RPG Manual de consulta de componentes

Page 89: Manual Ibm

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL allow = %getatr('win01': 'EF1': 'AllowLink')*C allow IFEQ 1C EVAL %setatr('win01': 'EF1': 'AllowLink') = 0*C ELSEC EVAL %setatr('win01': 'EF1': 'AllowLink') = 1C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF01' GETATR 'ALLOWLINK' ALLOW 1 0*C ALLOW IFEQ 1C 'EF01' SETATR 0 'ALLOWLINK'*C ELSEC 'EF01' SETATR 1 'ALLOWLINK'*C ENDIF*

Capítulo 2. Atributos de componente 71

Page 90: Manual Ibm

AppDataContiene datos globales a los que cualquier componente puede hacer referencia.Este atributo proporciona una alternativa a la transferencia de parámetros que, encaso contrario, deben declararse.

Tipo Serie

Se aplica a los componentes

*Componente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*Component': '*Component': 'AppData')C = NDataC EVAL TmpFld=%getatr('*Component':'*Component':C 'AppData')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*COMPONENT' SETATR NData 'APPDATA'C '*COMPONENT' GETATR 'APPDATA' TmpFld*

72 VisualAge RPG Manual de consulta de componentes

Page 91: Manual Ibm

AppName

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Es el nombre de la aplicación del servidor a la que se conectará el componenteCliente DDE en una conversación DDE. La aplicación del servidor determina elnombre del servidor. Consulte la documentación de la aplicación para averiguar elvalor de AppName que se utilizará para dicha aplicación.

El establecimiento de AppName no inicia la conversación DDE. Para obtenerinformación acerca del inicio de una conversación DDE, consulte el apartado“DDEMode” en la página 167.

Tipo Serie

Se aplica a los componentes

Cliente DDE

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitidoNombre de la aplicación del servidor

Si el programa del servidor es una aplicación VisualAge RPG, este atributoserá el nombre de la aplicación, incluida la extensión. Por ejemplo, si laaplicación VisualAge RPG se llama server, el atributo AppName debedefinirlo como se indica a continuación:EVAL %setatr('WIN':'DDE1':'AppName') = 'SERVER.EXE'

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'DDE1': 'AppName') = 'APP01'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'DDE1' SETATR 'APP01' 'APPNAME'*

Capítulo 2. Atributos de componente 73

Page 92: Manual Ibm

ArrangeOrdena los elementos de un contenedor en la vista de iconos de manera que losiconos quedan alineados en filas.

Tipo Numérico

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl valor de este atributo debe ser 1.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C Eval %setatr('window': 'CN1': 'Arrange') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' SETATR 1 'ARRANGE'*

74 VisualAge RPG Manual de consulta de componentes

Page 93: Manual Ibm

AttrValueValor del atributo al que hace referencia el componente referencia a componente.En primer lugar, debe establecer el componente referencia a componente a fin deidentificar el componente, la ventana y el nombre del componente para el atributo.

Tipo Serie

Se aplica a los componentes

Referencia acomponente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'COMP1': 'AttrValue')='Test'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'COMP1' SETATR 'Test' 'ATTRVALUE'*

Capítulo 2. Atributos de componente 75

Page 94: Manual Ibm

AudioModeEstablece la modalidad de operación para el componente.

Tipo Numérico

Se aplica a los componentes

Medios

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

El valor de AudioMode puede ser uno de los siguientes:

1 Pausa

2 Reproducir

3 Grabar

4 Parar

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'AUDIO01': 'AudioMode') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'AUDIO01' SETATR 1 'AUDIOMODE'*

76 VisualAge RPG Manual de consulta de componentes

Page 95: Manual Ibm

AutoIncEste atributo hace que se incremente el valor actual de DataPoint cada vez que seestablece el atributo DataValue.

Tipo Numérico

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El atributo AutoInc devuelve uno de los valores siguientes:

0 DataPoint no se incrementa automáticamente

1 DataPoint se incrementa automáticamente.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL auto = %getatr('win01': 'GP1': 'AutoInc')*C auto IFEQ 1C EVAL %setatr('win01': 'GP1': 'AutoInc') = 0*C ELSEC EVAL %setatr('win01': 'GP1': 'AutoInc') = 1C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GP01' GETATR 'AUTOINC' Auto 1 0*C AUTO IFEQ 1C 'GP01' SETATR 0 'AUTOINC'*C ELSEC 'GP01' SETATR 1 'AUTOINC'*C ENDIF*

Capítulo 2. Atributos de componente 77

Page 96: Manual Ibm

AutoScroll

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Permite que un usuario pueda desplazar datos en un campo de entrada cuando sepuede escribir más texto o cuando hay más información disponible de la que sepuede visualizar en el campo de entrada.

Tipo Numérico

Se aplica a los componentes

Recuadro decombinación

Campo de entrada

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de AutoScroll puede ser uno de los siguientes:

0 Desplazamiento automático no permitido

1 Desplazamiento automático permitido

78 VisualAge RPG Manual de consulta de componentes

|||

||

|||

|

Page 97: Manual Ibm

Ejemplo de formato libre

Conmutar el atributo AutoScroll de un campo de entrada.*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL rc = %getatr('win01': 'EF1': 'AutoScroll')*C rc IFEQ 1C EVAL %setatr('win01': 'EF1': 'AutoScroll') = 0*C ELSEC EVAL %setatr('win01': 'EF1': 'AutoScroll') = 1C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' GETATR 'AUTOSCROLL' rc 1 0*C rc IFEQ 1C 'EF1' SETATR 0 'AUTOSCROLL'*C ELSEC 'EF1' SETATR 1 'AUTOSCROLL'C ENDIF*

Capítulo 2. Atributos de componente 79

Page 98: Manual Ibm

AutoSelectIndica si se resalta el texto que figura en el campo de entrada cuando éste recibe elfoco. En el caso de un componente subarchivo, establezca primero el atributoColNumber para identificar la columna con la que se debe trabajar.

Tipo Numérico

Se aplica a los componentes

Campo de entrada Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

El valor de AutoSelect puede ser uno de los siguientes:

0 No se resalta el valor del campo de entrada

1 Sí se resalta el valor del campo de entrada

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL highlight=%getatr('win01':'EF1':'AutoSelect')*C highlight IFEQ 0C EVAL %setatr('win01':'EF1':'AutoSelect')=1C ELSEC EVAL %setatr('win01':'EF1':'AutoSelect')=0C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' GETATR 'AUTOSELECT' highlight 1 0*C 'EF1' SETATR 1 'AUTOSELECT'*

80 VisualAge RPG Manual de consulta de componentes

Page 99: Manual Ibm

BackColorValor numérico que determina el color de fondo de un componente.

Si el atributo de color de fondo se había establecido mediante el atributo BackMix,se devuelve el índice de colores que representa de manera más aproximada elvalor de mezcla de colores de fondo.

Tipo Numérico

Se aplica a los componentes

Lienzo Recuadro de selección Recuadro decombinación

Contenedor

Campo de entrada Imagen Recuadro de lista Panel de mediosEdición de múltipleslíneas

Cuaderno Pulsador Botón de selección

Graduador Selector cíclico Texto estático Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

El color del fondo debe ser uno de los siguientes:

-1 Por omisión (no se utiliza en las aplicaciones Java)

0 Blanco

1 Negro

2 Azul (Blue)

3 Rojo (Red)

4 Rosa

5 Verde

6 Cian

7 Amarillo (Yellow)

8 Gris oscuro

9 Azul oscuro

10 Rojo oscuro

Capítulo 2. Atributos de componente 81

Page 100: Manual Ibm

11 Rosa oscuro

12 Verde oscuro

13 Cian oscuro

14 Marrón

15 Gris claro

Nota: No se puede utilizar el color por omisión (-1) para SETATR.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL color = %getatr('win01': 'EF1': 'BackColor')*C color IFEQ *RedC EVAL %setatr('win01': 'EF1': 'BackColor') = *BlueC ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' SETATR *BLUE 'BACKCOLOR'*

82 VisualAge RPG Manual de consulta de componentes

Page 101: Manual Ibm

BackMixConsulta o establece la mezcla del color de fondo.

Tipo Serie

Se aplica a los componentes

Lienzo Recuadro de selección Recuadro decombinación

Contenedor

Campo de entrada Imagen Recuadro de lista Panel de mediosEdición de múltipleslíneas

Cuaderno Pulsador Botón de selección

Graduador Selector cíclico Texto estático Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

La mezcla del color de fondo debe tener el formato siguiente:'rojo:verde:azul'

donde rojo, verde y azul son valores situados entre 0 y 255 que representanla intensidad del color respectivo.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL color=%getatr('win01':'EF1':'BackMix')*C color IFNE '10:23:200'C EVAL %setatr('win01':'EF1':'BackMix')='10:23:200'C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' SETATR '10:23:200' 'BACKMIX'*

Capítulo 2. Atributos de componente 83

Page 102: Manual Ibm

BarLabelIndica cuál es la etiqueta del elemento de datos actual (según lo especificado enDataPoint y DataGroup).

Tipo Serie

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'GPH1': 'BarLabel') = 'BAR01'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GPH1' SETATR 'BAR01' 'BARLABEL'*

84 VisualAge RPG Manual de consulta de componentes

Page 103: Manual Ibm

Bass

Nota: Este atributo sólo se utiliza en Windows NT/95/98.

Establece el nivel de bajos del componente medios.

Tipo Numérico

Se aplica a los componentes

Medios

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de Bass puede estar entre 0 y 100.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'AUD1': 'Bass') = 37**

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'AUD1' SETATR 37 'BASS'*

Capítulo 2. Atributos de componente 85

Page 104: Manual Ibm

BindPart

Restricción: Este atributo sólo se utiliza en las aplicaciones Java.

Identifica el componente que se va a enlazar o que está enlazado a la columna dedatos. En el entorno Java, sólo se permite enlazar en los componentes campo deentrada y texto estático.

Tipo Serie

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

El formato del nombre de padre/componente que se va a enlazar es elsiguiente:

'FRAMEWINDOW|PARTNAME'

donde FrameWindow es el nombre de la ventana propietaria de PartName.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'WIN1': 'BindPart')C = 'WIN1|ENT2'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN1' SETATR 'WIN1|ENT2' 'BINDPART'*

86 VisualAge RPG Manual de consulta de componentes

|||

||

|||

|

Page 105: Manual Ibm

BlankCharEspecifica el carácter que representará el espacio en blanco en una serie.

El componente contenedor utiliza un blanco como delimitador de elementos en unregistro. Si el elemento que añade contiene blancos como, por ejemplo, el texto delicono, establezca el atributo BlankChar en un carácter que no sea blanco.

El carácter de blanco por omisión es el subrayado (_).

Tipo Serie

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'CTR1':'BlankChar')='&'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CTR1' SETATR '&' 'BLANKCHAR'*

Capítulo 2. Atributos de componente 87

|||

||

|||

|

Page 106: Manual Ibm

BorderDetermina si el componente tiene un borde.

Tipo Numérico

Se aplica a los componentes

Calendario Imagen Pulsador*

* Restricción: Este atributo sólo se puede establecer y obtener para elcomponente pulsador en las aplicaciones Java.

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

El valor de Border puede ser uno de los siguientes:

0 El componente no tiene borde

1 El componente tiene borde

Ejemplo de formato libre

Conmutar el atributo Border de un componente:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL brdval = %getatr('win01': 'IMG1': 'Border')C brdval IFEQ 0C EVAL %setatr('win01': 'IMG1': 'Border') = 1*C ELSEC EVAL %setatr('win01': 'IMG1': 'Border') = 0C ENDIF*

Ejemplo de formato fijo

Conmutar el valor de borde actual de un pulsador:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'IMG1' GETATR 'BORDER' brdval 1 0C brdval IFEQ 1C 'IMG1' SETATR 0 'BORDER'*C ELSEC 'IMG1' SETATR 1 'BORDER'C ENDIF

88 VisualAge RPG Manual de consulta de componentes

Page 107: Manual Ibm

BottomEspecifica en pixels la coordenada inferior de pantalla del componente u objeto.

Nota: El punto de origen es el ángulo superior izquierdo y empieza por cero.

Tipo Numérico

Se aplica a los componentes

ActiveX Calendario Lienzo* Recuadro de selecciónRecuadro decombinación

Referencia acomponente lógico

Contenedor Cliente DDE

Campo de entrada Gráfica Pulsador gráfico Recuadro de grupoBarra dedesplazamientohorizontal

Imagen Bean Java Recuadro de lista

Medios Panel de medios Edición de múltipleslíneas

Cuaderno

Interfaz ODBC/JDBC Recuadro de contorno Barra de progreso PulsadorBotón de selección Graduador Selector cíclico Texto estáticoSubarchivo Temporizador Barra de

desplazamientovertical

Ventana

* Restricción: Este atributo sólo se puede obtener en tiempo de ejecuciónpara el componente lienzo.

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoNúmero de pixels

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL bot = %getatr('win01': 'Image1': 'Bottom')C bot SUB 100 newbotC EVAL %setatr('win01': 'Image1': 'Bottom') = newbot*

Ejemplo de formato fijo

Mover una imagen 200 pixels dentro de su ventana.*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'IMAGE1' GETATR 'BOTTOM' OldBot 4 0C OldBot ADD 200 NewBot 4 0C 'IMAGE' SETATR NewBot 'BOTTOM'*

Capítulo 2. Atributos de componente 89

Page 108: Manual Ibm

BufferDec

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Especifica el número de posiciones decimales del almacenamiento intermedio de lacolumna.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL%setatr('win01':'ODBC1':'BufferDec')=4*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' SETATR 4 'BufferDec'*

90 VisualAge RPG Manual de consulta de componentes

|||

||

|||

|

Page 109: Manual Ibm

BufferLen

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Especifica la longitud del campo de programa disponible para los datos decolumna. El componente Interfaz ODBC/JDBC necesita conocer la longitud de losdatos establecida y entrar en el campo de programa al traspasar los datos haciauna columna y desde una columna.

Establezca el atributo Column en la columna deseada antes de utilizar esteatributo.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'ODBC1':'BufferLen')=20*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' SETATR 20 'BufferLen'*

Capítulo 2. Atributos de componente 91

Page 110: Manual Ibm

BufferPtr

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Especifica el valor de puntero para el campo de programa. El componente InterfazODBC/JDBC utiliza este valor para traspasar datos de la base de datos al campode programa.

Establezca el atributo Column en la columna deseada antes de utilizar esteatributo.

Para obtener la dirección de un campo de programa, utilice la función %ADDRincorporada según se muestra a continuación:D FieldPtr S * INZ(%Addr(Campo))

Nota: Este atributo no se utiliza en el entorno Java.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Nota: En el caso de la operación SETATR, el atributo BufferPtr puedecodificarse solamente con sintaxis de formato fijo.

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' SETATR FieldPtr 'BufferPtr'*

92 VisualAge RPG Manual de consulta de componentes

Page 111: Manual Ibm

BufferType

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Indica el tipo de datos del campo del programa VisualAge RPG al que hacereferencia el atributo BufferPtr. El componente Interfaz ODBC/JDBC utiliza elatributo BufferType para realizar la conversión de datos correcta al traspasar datosentre el campo del programa y la columna de la tabla. Es importante establecercorrectamente este atributo, ya que no se comprueba si los tipos de campo sonadecuados.

Establezca el atributo Column antes de utilizar el atributo BufferType. Si el campode programa está asociado a un componente de la interfaz, puede utilizar elatributo DataType para obtener el tipo de almacenamiento intermedio.

Si una columna contiene un tipo de datos que el componente Interfaz ODBC/JDBCno soporta, establezca el atributo AllowChg en 0 para esa columna. El componenteInterfaz ODBC/JDBC no traspasará datos entre ningún campo de programa y lacolumna. No se efectuará ningún cambio en los datos.

Utilice el siguiente diagrama para establecer el tipo de datos VARPG en elcorrespondiente tipo de datos SQL soportado. Especifique los atributos BufferLeny BufferDec sólo como se listan en el diagrama.

Tipo de datos SQL Tipo de datosVARPG

Especifica la longituddel campo de

programa (utiliceBufferLen)

Especifica las posicionesdecimales de la columna

del almacenamientointermedio (utilice

BufferDec)Carácter CHAR XDecimal Decimal con zona XEntero Decimal con zona X

Entero pequeño Decimal con zona XDoble 8FDoble Decimal con zona X X

Coma flotante 4FComa flotante Decimal con zona X X

Real 4FReal Decimal con zona X X

Para los tipos de datos carácter, decimal, entero o entero pequeño, especifique sóloel atributo BufferLen.

Tenga en cuenta que los tipos de datos doble, flotante y real pueden definirse enVARPG, como flotante (F) o decimal con zona. Si los define como decimal conzona, el tiempo de ejecución de VARPG sólo utilizará el número de posicionesdecimales que especifica el atributo BufferDec cuando traslade datos de lacolumna. Esto puede provocar una pérdida de precisión si el origen de datos tienemás posiciones decimales que las especificadas por el atributo BufferDec. Si defineestos campos como flotantes (F), NO especifique los atributos BufferLen niBufferDec.

Tipo Numérico

Capítulo 2. Atributos de componente 93

Page 112: Manual Ibm

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de BufferType puede ser uno de los siguientes:

0 Datos numéricos.

Los tipos de datos SQL que se pueden utilizar son:v Decimalv Enterov Entero pequeñov Coma flotantev Realv Doble

1 Datos de tipo carácter.

Los tipos de datos SQL que se pueden utilizar son:v Carácterv Carácter de longitud variablev Fechav Horav Indicación de la hora

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'ODBC1':'BufferType')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' SETATR 1 'BUFFERTYPE'*

94 VisualAge RPG Manual de consulta de componentes

Page 113: Manual Ibm

ButtonAverigua si se ha pulsado el botón ACEPTAR o CANCELAR o bien si se hacerrado el diálogo de archivo.

Tipo Numérico

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor permitido

El estado de Button puede ser uno de los siguientes:

0 No se ha cerrado el diálogo de archivo

1 Se ha pulsado el botón ACEPTAR

2 Se ha pulsado el botón CANCELAR

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL But=%getatr('*Component':'*Component':'Button')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*COMPONENT' GETATR 'Button' But*

Capítulo 2. Atributos de componente 95

Page 114: Manual Ibm

ButtonIdxEstablece y obtiene el índice para los botones de navegación. El índice debeestablecerse antes de activar el atributo EnableBtn.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El índice puede establecerse con los valores siguientes:

1 Botón de inicio de página

2 Botón de retroceso de página

3 Botón de registro anterior

4 Botón de registro siguiente

5 Botón de avance de página

6 Botón de fin de página

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'SFI1': 'ButtonIdx') = 4*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFI1' SETATR 4 'BUTTONIDX'*

96 VisualAge RPG Manual de consulta de componentes

Page 115: Manual Ibm

ButtonsAmplía o contrae la barra de navegación.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de Buttons puede ser uno de los siguientes:

0 No mostrar los botones

1 Mostrar los botones

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL btnval = %getatr('win01': 'SF1': 'Buttons')C btnval IFEQ 0C EVAL %setatr('win01': 'SF1': 'Buttons') = 1*C ELSEC EVAL %setatr('win01': 'SF1': 'Buttons') = 0C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SF1' GETATR 'BUTTONS' btnval 1 0C btnval IFEQ 1C 'SF1' SETATR 0 'BUTTONS'*C ELSEC 'SF1' SETATR 1 'BUTTONS'C ENDIF

Capítulo 2. Atributos de componente 97

Page 116: Manual Ibm

ButtonTipDefine el texto de la ayuda flotante de los botones de navegación correspondientesestablecidos con ButtonIdx.

Este texto puede ser una serie o un mensaje (*MSGnnnn).

Tipo Serie

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

Texto de ayuda flotante

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'SFI1': 'ButtonTip') = string*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFI1' SETATR STRING 'BUTTONTIP'*

98 VisualAge RPG Manual de consulta de componentes

Page 117: Manual Ibm

CanUndoIndica si se puede deshacer la última acción. Si se devuelve 1, la última acción sepuede deshacer. El valor 0 indica que no se puede.

Tipo Numérico

Se aplica a los componentes

Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Chng=%getatr('win01':'ML1':'CanUndo')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ML1' GETATR 'CANUNDO' CHNG*

Capítulo 2. Atributos de componente 99

Page 118: Manual Ibm

CapsLockDetermina si el texto que se escribe en un campo de entrada o en un subarchivo deun campo de entrada se convertirá en mayúsculas.

Nota: Para obtener o establecer CapsLock en un campo de entrada de subarchivo,debe establecerse el atributo ColNumber en un número de columnacorrecto.

Tipo Numérico

Se aplica a los componentes

Campo de entrada Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

El valor de CapsLock puede ser uno de los siguientes:

0 El texto no se convierte en mayúsculas

1 El texto se convierte en mayúsculas

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'EF1': 'CapsLock') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' SETATR 1 'CAPSLOCK'*

100 VisualAge RPG Manual de consulta de componentes

Page 119: Manual Ibm

Case

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Determina si la comparación de búsqueda es sensible a las mayúsculas yminúsculas.

Tipo Numérico

Se aplica a los componentes

Recuadro decombinación

Recuadro de lista

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de Case puede ser uno de los siguientes:

0 La comparación no es sensible a las mayúsculas y minúsculas.

1 La comparación sí es sensible a las mayúsculas y minúsculas.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CB1': 'Case') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CB1' SETATR 1 'CASE'*

Capítulo 2. Atributos de componente 101

Page 120: Manual Ibm

CellBGClrValor numérico que determina el color de fondo de una casilla de un subarchivo.Debe utilizar los atributos Index y ColNumber para identificar la casilla en la quese establecerá el color.

Si el color de fondo se ha establecido mediante el atributo CellBGMix, el color defondo devuelto es el que se parece más al color de mezcla.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El color debe ser uno de los siguientes:

-1 Por omisión (no se utiliza en las aplicaciones Java)

0 Blanco

1 Negro

2 Azul (Blue)

3 Rojo (Red)

4 Rosa

5 Verde

6 Cian

7 Amarillo (Yellow)

8 Gris oscuro

9 Azul oscuro

10 Rojo oscuro

102 VisualAge RPG Manual de consulta de componentes

Page 121: Manual Ibm

11 Rosa oscuro

12 Verde oscuro

13 Cian oscuro

14 Marrón

15 Gris claro

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL CBcolor = %getatr('win01': 'SFL1': 'CellBGClr')*C EVAL %setatr('win01': 'SFL1': 'ColNumber') = 1C EVAL %setatr('win01': 'SFL1': 'Index') = 4C EVAL %setatr('win01': 'SFL1': 'CellBGClr') = 5*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' GETATR 'CELLBGCLR' 'CBcolor' 2 0*C 'SFL1' SETATR 1 'COLNUMBER'C 'SFL1' SETATR 4 'INDEX'C 'SFL1' SETATR 5 'CELLBGCLR'*

Capítulo 2. Atributos de componente 103

Page 122: Manual Ibm

CellBGMixConsulta o establece la mezcla de colores de fondo de una casilla de unsubarchivo. Debe utilizar los atributos Index y ColNumber para identificar lacasilla en la que se consultará o se establecerá la mezcla de colores.

Tipo Serie

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

La mezcla del color de fondo debe tener el formato siguiente:'rojo:verde:azul'

donde rojo, verde y azul son valores situados entre 0 y 255 que representanla intensidad del color respectivo.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL CBclrMx = %getatr('win01': 'SFL1': 'CellBGMix')*C CBclrMx IFNE '10:23:200'C EVAL %setatr('win01': 'SFL1': 'CellBGMix') = '10:23:200'C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' SETATR '10:23:200' 'CELLBGMIX'*

104 VisualAge RPG Manual de consulta de componentes

Page 123: Manual Ibm

CellFGClrValor numérico que determina el color de primer plano de una casilla de unsubarchivo. Debe utilizar los atributos Index y ColNumber para identificar lacasilla en la que se establecerá el color.

Si el color de primer plano se ha establecido mediante el atributo CellFGMix, elcolor de primer plano devuelto es el que se parece más al color de mezcla.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El color debe ser uno de los siguientes:

-1 Por omisión (no se utiliza en las aplicaciones Java)

0 Blanco

1 Negro

2 Azul (Blue)

3 Rojo (Red)

4 Rosa

5 Verde

6 Cian

7 Amarillo (Yellow)

8 Gris oscuro

9 Azul oscuro

10 Rojo oscuro

Capítulo 2. Atributos de componente 105

Page 124: Manual Ibm

11 Rosa oscuro

12 Verde oscuro

13 Cian oscuro

14 Marrón

15 Gris claro

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL CFcolor = %getatr('win01': 'SFL1': 'CellFGClr')*C EVAL %setatr('win01': 'SFL1': 'ColNumber') = 1C EVAL %setatr('win01': 'SFL1': 'Index') = 4C EVAL %setatr('win01': 'SFL1': 'CellFGClr') = 5*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' GETATR 'CELLFGCLR' 'CFcolor' 2 0*C 'SFL1' SETATR 1 'COLNUMBER'C 'SFL1' SETATR 4 'INDEX'C 'SFL1' SETATR 5 'CELLFGCLR'*

106 VisualAge RPG Manual de consulta de componentes

Page 125: Manual Ibm

CellFGMixConsulta o establece la mezcla de colores de primer plano de una casilla de unsubarchivo. Debe utilizar los atributos Index y ColNumber para identificar lacasilla en la que se consultará o se establecerá la mezcla de colores.

Tipo Serie

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

La mezcla de colores de primer plano debe tener el formato siguiente:'rojo:verde:azul'

donde rojo, verde y azul son valores situados entre 0 y 255 que representanla intensidad del color respectivo.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL CFclrMx=%getatr('win01':'SFL1':'CellFGMix')*C CFclrMx IFNE '10:23:200'C EVAL %setatr('win01':'SFL1':'CellFGMix')='10:23:200'C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' SETATR '10:23:200' 'CELLFGMIX'*

Capítulo 2. Atributos de componente 107

Page 126: Manual Ibm

CenterCuando se establece en 1, la ventana se centrará al visualizarse por primera vez. Elusuario podrá mover después esta ventana como desee.

Si después de centrar la ventana, la coordenada x o y del ángulo superiorizquierdo es negativa, ambas coordenadas se establecerán en (0,0) para garantizarque la barra de título de la ventana sea siempre visible.

Tipo Numérico

Se aplica a los componentes

Ventana Ventana con lienzo

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR no

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitidoEl atributo sólo puede establecerse en 1

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('FW1': 'FW1': 'Center') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'FW1' SETATR 1 'CENTER'*

108 VisualAge RPG Manual de consulta de componentes

Page 127: Manual Ibm

CharDataDevuelve el texto de tipo carácter para una columna específica de un conjunto deregistros devuelto. Establezca el atributo Column antes de utilizar este atributo.

Tipo Serie

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL ColData=%getatr('win01':'ODBC1':'CharData')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' GETATR 'CHARDATA' COLDATA*

Capítulo 2. Atributos de componente 109

Page 128: Manual Ibm

CharOffsetDetermina el valor de desplazamiento de carácter en un campo de edición demúltiples líneas donde se insertará el texto cuando se establezca el atributoAddOffset.

Tipo Numérico

Se aplica a los componentes

Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoDesplazamiento de carácter

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'MLE1': 'CharOffset') = 10*C EVAL value = %getatr('win01': 'MLE1': 'CharOffset')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' SETATR 10 'CHAROFFSET'C 'MLE1' SETATR 'text' 'ADDOFFSET'*

110 VisualAge RPG Manual de consulta de componentes

Page 129: Manual Ibm

CheckedDetermina si el componente está marcado.

Tipo Numérico

Se aplica a los componentes

Recuadro de selección Opción de menú Botón de selección

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

* Nota: Puede definirse utilizando el cuaderno de propiedades deldiseñador GUI. Para ello, en el caso de los componentes recuadrode selección y botón de selección, es necesario elegir el estiloSelected (seleccionado). En el caso de los componentes opción demenú, hay que seleccionar el estilo Checked (marcada).

Valor permitido

El estado Checked del componente puede ser uno de los siguientes:

0 El componente no está marcado

1 El componente está marcado

Ejemplo de formato libre

Establecer el estado de marca de un recuadro de selección con el mismoestado que un botón de selección:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL ischecked = %getatr('win01': 'RB1': 'Checked')*C EVAL %setatr('win01': 'CB1': 'Checked') = ischecked*

Ejemplo de formato fijo

Conmutar el estado de marca de un recuadro de selección:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CB1' GETATR 'CHECKED' ischecked*C ischecked IFEQ 1C 'CB1' SETATR 0 'CHECKED'*C ELSEC 'CB1' SETATR 1 'CHECKED'C ENDIF*

Capítulo 2. Atributos de componente 111

Page 130: Manual Ibm

ChildCountDevuelve el número de hijos directos de un padre especificado por RecordId.

Tipo Numérico

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL children = %getatr('win01': 'CTR1': 'ChildCount')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CTR1' GETATR 'CHILDCOUNT' children*

112 VisualAge RPG Manual de consulta de componentes

Page 131: Manual Ibm

ChildListDevuelve una lista, delimitada por espacios en blanco, de los hijos directos de unregistro que se halla en el componente contenedor. Para especificar de qué registrodesea la lista, utilice el atributo RecordId.

Tipo Serie

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL list = %getatr('win01': 'CTR1': 'ChildList')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CTR1' GETATR 'CHILDLIST' list*

Capítulo 2. Atributos de componente 113

Page 132: Manual Ibm

ClearAllSi se establece ClearAll, se elimina la totalidad del texto de usuario del calendario.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl único valor válido de ClearAll es 1

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'ClearAll') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' SETATR 1 'CLEARALL'*

114 VisualAge RPG Manual de consulta de componentes

Page 133: Manual Ibm

ClearDateSi se establece ClearDate, se elimina el texto de usuario para la fecha indicada porDayIdx/MonthIdx/YearIdx.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl único valor válido de ClearDate es 1

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'ClearDate') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' SETATR 1 'CLEARDATE'*

Capítulo 2. Atributos de componente 115

Page 134: Manual Ibm

ClearMonthSi se establece ClearMonth, se elimina el texto de usuario establecido para el mesindicado por MonthIdx/YearIdx.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl único valor válido de ClearMonth es 1

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'ClearMonth') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' SETATR 1 'CLEARMONTH'*

116 VisualAge RPG Manual de consulta de componentes

Page 135: Manual Ibm

ClearYearSi se establece ClearYear, se elimina el texto de usuario establecido para el añoindicado por YearIdx.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl único valor válido de ClearYear es 1

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'ClearYear') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' SETATR 1 'CLEARYEAR'*

Capítulo 2. Atributos de componente 117

Page 136: Manual Ibm

ClipBoardCopia texto al área común o desde ésta.

Tipo Serie

Se aplica a los componentes

*Componente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre

Obtener el contenido del portapapeles:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*Component':'*Component':'ClipBoard')=text*C EVAL text=%getatr('*Component':'*Component':'ClipBoard')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*COMPONENT' SETATR text 'CLIPBOARD'*C '*COMPONENT' GETATR 'CLIPBOARD' text*

118 VisualAge RPG Manual de consulta de componentes

Page 137: Manual Ibm

ColBGClrValor numérico que determina el color de fondo de una columna de subarchivo.Debe utilizar el atributo ColNumber para identificar la columna que tendrádefinido el color.

Si el color de fondo se ha establecido con el atributo ColBGMix, el color de fondodevuelto es el que se parece más al color de mezcla.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El color debe ser uno de los siguientes:

-1 Por omisión (no se utiliza en las aplicaciones Java)

0 Blanco

1 Negro

2 Azul (Blue)

3 Rojo (Red)

4 Rosa

5 Verde

6 Cian

7 Amarillo (Yellow)

8 Gris oscuro

9 Azul oscuro

10 Rojo oscuro

Capítulo 2. Atributos de componente 119

Page 138: Manual Ibm

11 Rosa oscuro

12 Verde oscuro

13 Cian oscuro

14 Marrón

15 Gris claro

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL CBcolor = %getatr('win01': 'SFL1': 'ColBGClr')*C EVAL %setatr('win01': 'SFL1': 'ColNumber') = 1C EVAL %setatr('win01': 'SFL1': 'ColBGClr') = 5*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' GETATR 'COLBGCLR' 'CBcolor' 2 0*C 'SFL1' SETATR 1 'COLNUMBER'C 'SFL1' SETATR 5 'COLBGCLR'*

120 VisualAge RPG Manual de consulta de componentes

Page 139: Manual Ibm

ColBGMixConsulta o establece la mezcla de colores de fondo de una columna de subarchivo.Debe utilizar el atributo ColNumber para identificar la columna en la que seconsultará o se establecerá la mezcla de colores.

Tipo Serie

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

La mezcla del color de fondo debe tener el formato siguiente:'rojo:verde:azul'

donde rojo, verde y azul son valores situados entre 0 y 255 que representanla intensidad del color respectivo.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL CBclrMx = %getatr('win01': 'SFL1': 'ColBGMix')*C CBclrMx IFNE '10:23:200'C EVAL %setatr('win01': 'SFL1': 'ColBGMix') = '10:23:200'C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' SETATR '10:23:200' 'COLBGMIX'*

Capítulo 2. Atributos de componente 121

Page 140: Manual Ibm

ColFGClrValor numérico que determina el color de primer plano de una columna desubarchivo. Debe utilizar el atributo ColNumber para identificar la columna quetendrá definido el color.

Si el color de primer plano se ha establecido mediante el atributo ColFGMix, elcolor de primer plano devuelto es el que se parece más al color de mezcla.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El color debe ser uno de los siguientes:

-1 Por omisión (no se utiliza en las aplicaciones Java)

0 Blanco

1 Negro

2 Azul (Blue)

3 Rojo (Red)

4 Rosa

5 Verde

6 Cian

7 Amarillo (Yellow)

8 Gris oscuro

9 Azul oscuro

10 Rojo oscuro

122 VisualAge RPG Manual de consulta de componentes

Page 141: Manual Ibm

11 Rosa oscuro

12 Verde oscuro

13 Cian oscuro

14 Marrón

15 Gris claro

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL CFcolor = %getatr('win01': 'SFL1': 'ColFGClr')*C EVAL %setatr('win01': 'SFL1': 'ColNumber') = 1C EVAL %setatr('win01': 'SFL1': 'ColFGClr') = 5*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' GETATR 'COLFGCLR' 'CFcolor' 2 0*C 'SFL1' SETATR 1 'COLNUMBER'C 'SFL1' SETATR 5 'COLFGCLR'*

Capítulo 2. Atributos de componente 123

Page 142: Manual Ibm

ColFGMixConsulta o establece la mezcla de colores de primer plano de una columna desubarchivo. Debe utilizar el atributo ColNumber para identificar la columna en laque se consultará o se establecerá la mezcla de colores.

Tipo Serie

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

La mezcla de colores de primer plano debe tener el formato siguiente:'rojo:verde:azul'

donde rojo, verde y azul son valores situados entre 0 y 255 que representanla intensidad del color respectivo.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL CFclrMx = %getatr('win01': 'SFL1': 'ColFGMix')*C CFclrMx IFNE '10:23:200'C EVAL %setatr('win01': 'SFL1': 'ColFGMix') = '10:23:200'C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' SETATR '10:23:200' 'COLFGMIX'*

124 VisualAge RPG Manual de consulta de componentes

Page 143: Manual Ibm

CollapsedSe aplica a un contenedor en la vista de árbol. Este atributo puede utilizarse paraampliar o contraer elementos en un registro especificado por el atributo RecordID.

La especificación del identificador de registro cero invierte el estado de todos losregistros en la vista de árbol.

Al ampliar un registro específico de una aplicación Java, los registros hijo y padredel registro se hacen visibles. Al contraer un registro, sólo se ocultan los registroshijo; los registros padre permanecen visibles.

Tipo Numérico

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de Collapsed puede ser uno de los siguientes:

1 Contraer el registro

0 Ampliar el registro

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----** Contraer el registroC Eval %setatr('window': 'CN1': 'Collapsed') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' SETATR 1 'COLLAPSED'*

Capítulo 2. Atributos de componente 125

Page 144: Manual Ibm

ColNumberEstablece el número de columna de campo a utilizar al establecer otros atributosde subarchivo. Este atributo se utiliza con el atributo Index para indicar a quécampo de un registro de subarchivo se hace referencia.

Tipo Numérico

Se aplica a los componentes

Contenedor Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoNúmero de columna de campo

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'SF1': 'Index') = 5C EVAL %setatr('win01': 'SF1': 'ColNumber') = 2*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SF1' SETATR 5 'INDEX'C 'SF1' SETATR 2 'COLNUMBER'*

126 VisualAge RPG Manual de consulta de componentes

Page 145: Manual Ibm

ColorEstablece y obtiene el color de las áreas indicadas por el valor del atributoColorArea.

Tipo Numérico

Se aplica a los componentes

Calendario Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

El color debe ser uno de los siguientes:

-1 Por omisión (no se utiliza en las aplicaciones Java)

0 Blanco

1 Negro

2 Azul (Blue)

3 Rojo (Red)

4 Rosa

5 Verde

6 Cian

7 Amarillo (Yellow)

8 Gris oscuro

9 Azul oscuro

10 Rojo oscuro

Capítulo 2. Atributos de componente 127

Page 146: Manual Ibm

11 Rosa oscuro

12 Verde oscuro

13 Cian oscuro

14 Marrón

15 Gris claro

Nota: No se puede utilizar el color por omisión (-1) para SETATR.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL color = %getatr('win01': 'GP1': 'Color')*C color IFEQ *RedC EVAL %setatr('win01': 'GP1': 'Color') = *BlueC ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GP1' SETATR *BLUE 'COLOR'*

128 VisualAge RPG Manual de consulta de componentes

Page 147: Manual Ibm

ColorAreaIndica el área a la que deben aplicarse los atributos Color y ColorMix al obtenerlao definirla.

Tipo Numérico

Se aplica a los componentes

Calendario Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

Para el componente gráfica, el valor de ColorArea puede ser uno de lossiguientes:

1 Color del título

2 Color de fondo

3 Color de las etiquetas de los ejes

4 Color de las líneas de los ejes

5 Color de las etiquetas de los puntos de datos

6 Color de resaltado

7 Color de fondo de la gráfica

8 Color de los bordes

9 Color de las barras/sectores/líneas

Para el componente calendario, el valor de ColorArea puede ser uno delos siguientes:

1 Fondo

2 Cuadrícula

3 Interior de calendario

4 Flechas de cambio de mes

5 Contornos de las flechas de cambio de mes

6 Contorno de mes/año

7 Fondo de mes/año

8 Primer plano de mes/año

9 Fondo de nombres de día

10 Primer plano de nombres de día

11 Contorno de fecha seleccionada

Capítulo 2. Atributos de componente 129

Page 148: Manual Ibm

12 Contorno de hoy

13 Color por omisión para los contornos definidos por el usuario

14 Color por omisión para el texto de usuario

15 Border

16 Números de fecha

17 Contornos de los número de fecha

18 Contorno definido por el usuario (sólo en tiempo de ejecución)

19 Texto de usuario (sólo en tiempo de ejecución)

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL colarea = %getatr('win01': 'GP1': 'ColorArea')*C colarea IFEQ 3C EVAL %setatr('win01': 'GP1': 'ColorArea') = 4C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GP1' SETATR 4 'COLORAREA'*

130 VisualAge RPG Manual de consulta de componentes

Page 149: Manual Ibm

ColorMixEstablece y obtiene la mezcla de colores indicada mediante el valor del atributoColorArea.

Tipo Serie

Se aplica a los componentes

Calendario Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR no

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

La mezcla de colores debe tener el formato siguiente:'rojo:verde:azul'

donde rojo, verde y azul son valores situados entre 0 y 255 que representanla intensidad del color respectivo.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL color=%getatr('win01':'GP1':'ColorMix')*C color IFNE '10:23:200'C EVAL %setatr('win01':'GP1':'ColorMix')='0:0:255'C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GP1' SETATR '10:23:200' 'COLORMIX'*

Capítulo 2. Atributos de componente 131

Page 150: Manual Ibm

ColumnEstablece cuál es la columna de una tabla a la que hacen referencia otros atributoscomo, por ejemplo, BufferLen, BufferPtr y BufferType.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoEntre 1 y el número de columnas de la tabla.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'ODBC1':'Column')=12*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' SETATR 12 'COLUMN'*

132 VisualAge RPG Manual de consulta de componentes

Page 151: Manual Ibm

ColumnDecDevuelve el número de posiciones decimales definido para una columna.Establezca el atributo Column antes de utilizar este atributo.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Dec=%getatr('win01':'ODBC1':'ColumnDec')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' GETATR 'COLUMNDEC' DEC*

Capítulo 2. Atributos de componente 133

Page 152: Manual Ibm

ColumnLenDevuelve la longitud definida de una columna específica de una tabla. Establezcael atributo Column antes de utilizar este atributo.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Len=%getatr('win01':'ODBC1':'ColumnLen')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' GETATR 'COLUMNLEN' LEN*

134 VisualAge RPG Manual de consulta de componentes

Page 153: Manual Ibm

ColumnNameDevuelve el nombre de una columna específica de un conjunto de registros.Establezca el atributo Column antes de utilizar este atributo. Una consulta SQL conlos atributos SQLQuery y ExecuteSQL ejecutada correctamente mostrará losnombres de columna disponibles.

Tipo Serie

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL CName=%getatr('win01':'ODBC1':'ColumnName')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' GETATR 'COLUMNNAME' CNAME*

Capítulo 2. Atributos de componente 135

Page 154: Manual Ibm

ColumnsDevuelve el número de columnas en el conjunto de resultados. Una consulta SQLcon los atributos SQLQuery y ExecuteSQL ejecutada correctamente mostrará elnúmero de columnas disponibles.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Cols=%getatr('win01':'ODBC1':'Columns')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' GETATR 'COLUMNS' COLS*

136 VisualAge RPG Manual de consulta de componentes

Page 155: Manual Ibm

ColumnTypeDevuelve el tipo de datos de una columna. Antes de utilizar este atributo,establezca los atributos Column y ExecuteSQL.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor devuelto

El valor devuelto puede ser uno de los siguientes:

1 Carácter de longitud variable

2 Carácter de longitud variable largo

3 Carácter

4 Numérico

5 Decimal

6 Entero

7 Entero pequeño

8 Indicación de la hora

0 Para los siguientes tipos de datos JDBC: fecha, hora, enterogrande, bit, doble, flotante, real, entero pequeño, binario, binario delongitud variable largo, binario de longitud variable, otros, nulo

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL CType=%getatr('win01':'ODBC1':'ColumnType')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' GETATR 'COLUMNTYPE' CTYPE*

Capítulo 2. Atributos de componente 137

Page 156: Manual Ibm

ColWidthDetermina el ancho de una columna de subarchivo en pixels.

El atributo ColNumber debe estar establecido para indicar a qué columna afecta.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'SFI1': 'ColWidth') = 50*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFI1' SETATR 50 'COLWIDTH'*

138 VisualAge RPG Manual de consulta de componentes

Page 157: Manual Ibm

CompNameEs el nombre del componente lógico al que se hace referencia.

Tipo Serie

Se aplica a los componentes

Referencia acomponente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C Eval %setatr('win1': 'comp1': 'CompName')='Palette'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'COMP1' SETATR 'Palette' 'COMPNAME'*

Capítulo 2. Atributos de componente 139

|||

||

|||

|

Page 158: Manual Ibm

ConnectEstablezca este atributo en 1 para conectar el componente Interfaz ODBC/JDBCcon una base de datos. Antes de utilizar este atributo, establezca el atributoConnectStr para determinar con qué origen de datos se conecta.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'ODBC1':'Connect')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' SETATR 1 'CONNECT'*

140 VisualAge RPG Manual de consulta de componentes

Page 159: Manual Ibm

ConnectedDetermina tras un intento de conexión con una tabla si la conexión se haestablecido correctamente. Si el atributo devuelve 1, la conexión se ha establecido.Todos los demás valores indican que la conexión no se ha establecido.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Status=%getatr('win01':'ODBC1':'Connected')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' GETATR 'CONNECTED' STATUS*

Capítulo 2. Atributos de componente 141

Page 160: Manual Ibm

ConnectStrProporciona la serie de conexión que debe pasarse al gestor ODBC para estableceruna conexión con un origen de datos. Establezca este atributo antes de utilizar elatributo Connect. Si establece la serie de conexión en *BLANKS, aparecerá eldiálogo Seleccionar origen de datos. En este diálogo podrá seleccionar la tabla con laque conectarse.

Consulte la documentación de la API ODBC para conocer la sintaxis de una seriede conexión.

Tipo Serie

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'ODBC1':'ConnectStr')=Str*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' SETATR STR 'CONNECTSTR'*

142 VisualAge RPG Manual de consulta de componentes

Page 161: Manual Ibm

CopyCopia el texto seleccionado en el portapapeles, sin suprimirlo.

Tipo Numérico

Se aplica a los componentes

Campo de entrada Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl valor permitido es 1.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'MLE1': 'Copy') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' SETATR 1 'copy'*

Capítulo 2. Atributos de componente 143

Page 162: Manual Ibm

CountProporciona el número de elementos de la parte de lista de un componente.

El atributo Count se actualiza cada vez que se añade o suprime un elemento de lalista.

Tipo Numérico

Se aplica a los componentes

Recuadro decombinación

Contenedor Recuadro de lista Subarchivo demensajes

Cuaderno Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL rc = %getatr('win01': 'LB1': 'Count')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' GETATR 'COUNT' count 2 0*

144 VisualAge RPG Manual de consulta de componentes

Page 163: Manual Ibm

CsrAtEndEstablezca este atributo en 1 para colocar el cursor detrás del último carácter de uncampo de entrada, cuando éste pasa a ser el campo activo.

Tipo Numérico

Se aplica a los componentes

Campo de entrada

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'EN1': 'CsrAtEnd') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EN1' SETATR 1 'CSRATEND'*

Capítulo 2. Atributos de componente 145

Page 164: Manual Ibm

CsrLineIndica la línea en la que está situado el cursor.

Tipo Numérico

Se aplica a los componentes

Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoNúmero de línea

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'MLE1': 'CsrLine') = 2*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' SETATR 2 'CSRLINE'*

146 VisualAge RPG Manual de consulta de componentes

Page 165: Manual Ibm

CsrPosIndica la posición del cursor respecto al primer carácter del campo de edición demúltiples líneas.

Tipo Numérico

Se aplica a los componentes

Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoLa posición del cursor

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'MLE1': 'CsrPos') = 4*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' SETATR 4 'CSRPOS'*

Capítulo 2. Atributos de componente 147

Page 166: Manual Ibm

CurrentDirDevuelve el directorio de trabajo actual.

Tipo Serie

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Dir = %getatr('*component': '*component':C 'CurrentDir)*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' GETATR 'CurrentDir' Dir*

148 VisualAge RPG Manual de consulta de componentes

Page 167: Manual Ibm

CurrentRowDevuelve el número de fila actual del conjunto de resultados.

Nota: En las aplicaciones Java, este atributo necesita el controlador adecuado deconformidad con JDBC 2.0.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL CRow=%getatr('win01':'ODBC1':'CurrentRow')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' GETATR 'CURRENTROW' CROW*

Capítulo 2. Atributos de componente 149

Page 168: Manual Ibm

CutSuprime el texto seleccionado y lo copia en el portapapeles.

Tipo Numérico

Se aplica a los componentes

Campo de entrada Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl valor permitido es 1.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'MLE1': 'Cut') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' SETATR 1 'cut'*

150 VisualAge RPG Manual de consulta de componentes

Page 169: Manual Ibm

DataGroupSe utiliza junto con DataPoint para indicar un dato específico o independientecuando se hace referencia a un grupo de puntos en su totalidad.

Tipo Numérico

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoEl valor debe ser mayor que 0.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'GR1': 'DataGroup') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GR1' SETATR 1 'DATAGROUP'*

Capítulo 2. Atributos de componente 151

Page 170: Manual Ibm

DataPointSe utiliza junto con DataGroup para indicar un dato específico.

Tipo Numérico

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoEl valor debe ser mayor que 0.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'GR1': 'DataPoint') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GR1' SETATR 1 'DATAPOINT'*

152 VisualAge RPG Manual de consulta de componentes

Page 171: Manual Ibm

DataTypeDetermina el tipo de datos permitidos en este campo.

Tipo Numérico

Se aplica a los componentes

Campo de entrada Texto estático

Códigos de operación

Operativo en tiempo de ejecución

SETATR* no

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

El valor de DataType puede ser uno de los siguientes:

0 Numéricos con zona - Este componente sólo admite caracteresnuméricos. También admite un guión ( - ) como carácter inicialpara indicar que el número es negativo.

1 Carácter - Este componente sólo admite caracteres alfanuméricos.

2 Sólo DBCS - Este componente sólo admite caracteres DBCS.

3 DBCS Cualquiera - Este componente admite caracteres SBCS oDBCS, pero no ambos al mismo tiempo, en función del primercarácter que se entre.

4 DBCS Mixto - Este componente admite caracteres SBCS y DBCS.

Ejemplo de formato libre

Obtener el tipo de carácter para un campo de entrada:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL type = %getatr('win01': 'EF1': 'DataType')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' GETATR 'DATATYPE' type 1 0*

Capítulo 2. Atributos de componente 153

Page 172: Manual Ibm

DataValueEspecifica el valor asignado a un dato en concreto

Tipo Numérico

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'GR1': 'DataValue') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GR1' SETATR 1 'DATAVALUE'*

154 VisualAge RPG Manual de consulta de componentes

Page 173: Manual Ibm

DateIndica la fecha seleccionada actualmente. La fecha siempre es una serie con elformato AAAAMMDD y se corresponde con los atributos Year/Month/Day.

Tipo Serie

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitidoLa fecha cuyo formato sea AAAAMMDD

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'Date') = '19980221'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' SETATR '19980221' 'DATE'*

Capítulo 2. Atributos de componente 155

Page 174: Manual Ibm

DateIdxPermite que el usuario defina datos en una fecha que no se visualiza en la páginaactual del calendario. La fecha siempre es una serie con el formato AAAAMMDDy coincide con YearIdx/MonthIdx/DayIdx.

Tipo Serie

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoEl valor de índice

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'DateIdx') =C = '19980221'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' SETATR '19980221' 'DATEIDX'*

156 VisualAge RPG Manual de consulta de componentes

Page 175: Manual Ibm

DateTextEs el texto que se visualiza dentro de la casilla de la fecha indicada porDayIdx/MonthIdx/YearIdx.

Tipo Serie

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'DateText') = 'text'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' SETATR 'text' 'DATETEXT'*

Capítulo 2. Atributos de componente 157

Page 176: Manual Ibm

DateUnderDevuelve la fecha que hay debajo del cursor en forma de serie AAAAMMDD. Si elratón no se encuentra encima de una fecha, DateUnder devuelve una serie vacía.

Tipo Serie

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL yyyymmdd = %getatr('win01': 'CAL1':C 'DateUnder')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' GETATR 'DATEUNDER' yyyymmdd*

158 VisualAge RPG Manual de consulta de componentes

Page 177: Manual Ibm

DayIndica el día seleccionado actualmente. Si se establece, se actualiza la fechaseleccionada en el componente calendario para que los cambios queden reflejados.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitidoEl día del mes

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'Day') = 21*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' SETATR 21 'DAY'*

Capítulo 2. Atributos de componente 159

Page 178: Manual Ibm

DayIdxPermite que el usuario defina datos en una fecha que no se visualiza en la páginaactual del calendario.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoEl valor de índice

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'DayIdx') = 21*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' SETATR 21 'DAYIDX'*

160 VisualAge RPG Manual de consulta de componentes

Page 179: Manual Ibm

DayLenIndica el formato de visualización del nombre de los días.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

El valor de DayLen puede ser uno de los siguientes:

1 Nombre completo

2 Nombre abreviado de tres caracteres

3 Prefijo abreviado de dos caracteres (por ejemplo, SU, MO, TU...)

4 Prefijo abreviado de un solo carácter (por ejemplo, S, M, T...)

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'DayLen') = 2*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' GETATR 'DAYLEN' daylen*

Capítulo 2. Atributos de componente 161

Page 180: Manual Ibm

DayNumPosIndica la posición de los números que representan los días del mes.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de DayNumPos puede ser uno de los siguientes:

1 Parte superior izquierda

2 Parte superior derecha

3 Parte inferior izquierda

4 Parte inferior derecha

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'DayNumPos') = 3*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' GETATR 'DAYNUMPOS' daynumpos*

162 VisualAge RPG Manual de consulta de componentes

Page 181: Manual Ibm

DayNumRectIndica si se dibujará un contorno para los días del mes.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de DayNumRect puede ser uno de los siguientes:

0 Los números no tendrán contorno

1 Los números sí tendrán contorno

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL isout = %getatr('win01': 'CAL1': 'DayNumRect')*C EVAL %setatr('win01': 'CAL1': 'DayNumRect') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' GETATR 'DAYNUMRECT' isout*

Capítulo 2. Atributos de componente 163

Page 182: Manual Ibm

DayStartDetermina cuál es el primer día de la semana.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de DayStart puede ser uno de los siguientes:

0 Domingo

1 Lunes

2 Martes

3 Miércoles

4 Jueves

5 Viernes

6 Sábado

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'DayStart') = 2*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' SETATR 2 'DAYSTART'*

164 VisualAge RPG Manual de consulta de componentes

Page 183: Manual Ibm

DDEAddLinkAl establecer este atributo se establece una conversación de enlace dinámico DDEentre la aplicación del servidor definida por los atributos AppName y Topic y elcomponente indicado por el parámetro componente.

Cuando se establece una conversación de enlace dinámico, la aplicación delservidor señalará automáticamente un evento Data al componente cliente DDEcuando cambie el elemento especificado mediante el atributo Item del componentecliente DDE. A continuación, el componente cliente DDE actualizará el componenteenlazado con los datos nuevos si se ha establecido el atributo AllowLink.

Tipo Serie

Se aplica a los componentes

Cliente DDE

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR no

* Nota: Puede definirse utilizando el cuaderno de propiedades deldiseñador GUI. Para ello, seleccione el pulsador Añadir yespecifique valores en el recuadro de diálogo Añadir enlace DDE.

Valor permitido

El parámetro componente debe codificarse tal como se muestra acontinuación:

'ventana|componente'

Capítulo 2. Atributos de componente 165

Page 184: Manual Ibm

Ejemplo de formato libre

Establecer una conversación de enlace dinámico entre un campo deentrada y una celda de una hoja de cálculo. Cuando la celda cambie, elcontenido del campo de entrada también cambiará.*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'DDE1':'AppName')='APP01'C EVAL %setatr('win01':'DDE1':'Topic')='APP01.WG2'C EVAL %setatr('win01':'DDE1':'Item')='A1'C EVAL %setatr('win01':'DDE1':'DDEAddLink')='win1|ef1'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'DDE1' SETATR 'win1|ef1' 'DDEADDLINK'*

166 VisualAge RPG Manual de consulta de componentes

Page 185: Manual Ibm

DDEModeDetermina la modalidad actual de un componente cliente DDE.

Tipo Numérico

Se aplica a los componentes

Cliente DDE

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

La modalidad del componente representada por uno de los valoressiguientes:

1 Initiate - Inicia una conversación DDE. Antes de poder iniciar laconversación, se deben haber establecido los atributos AppName yTopic.

Cuando se ha iniciado la conversación DDE satisfactoriamente, seestablece una conversación de enlace estático entre la aplicación delservidor y el componente Cliente DDE. Una conversación de enlaceestático quiere decir que el componente cliente DDE debeestablecer el atributo Request para obtener datos de la aplicacióndel servidor, y establecer el atributo Poke para enviar datos a laaplicación del servidor.

2 Terminate - Finaliza la conversación DDE. Cuando se establece esteatributo, se envía una solicitud de finalización a la aplicación delservidor. Cuando la aplicación del servidor haya procesado lasolicitud de terminación, responderá señalizando un eventoTerminate en el programa. Para procesar este evento, debecodificar una subrutina de acción de terminación en el programa.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'DDE1': 'DDEMode') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'DDE1' SETATR 1 'DDEMODE'*

Capítulo 2. Atributos de componente 167

Page 186: Manual Ibm

DDERmvLinkSuprime un enlace de este componente cliente DDE. El atributo Item se utilizapara determinar el enlace que se va a eliminar.

Tipo Serie

Se aplica a los componentes

Cliente DDE

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

El parámetro part debe codificarse de la forma siguiente:'ventana|componente'

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'DDE1':'DDERmvLink')='win1|ef1'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'DDE1' SETATR 'win1|ef1' 'DDERMVLINK'*

168 VisualAge RPG Manual de consulta de componentes

Page 187: Manual Ibm

DeActivateEstablezca este atributo en 1 para desactivar un objeto ActiveX.

Tipo Numérico

Se aplica a los componentes

ActiveX

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'AX1': 'DeActivate') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'AX1' SETATR 1 'DEACTIVATE'*

Capítulo 2. Atributos de componente 169

Page 188: Manual Ibm

DeleteSuprime el texto seleccionado.

Tipo Numérico

Se aplica a los componentes

Campo de entrada Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl valor permitido es 1.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'MLE1': 'Delete') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' SETATR 1 'delete'*

170 VisualAge RPG Manual de consulta de componentes

Page 189: Manual Ibm

DeleteRowDetermina el número de fila que se suprime del conjunto de resultados. No esnecesario buscar antes una fila para suprimirla. Este atributo ocasionará que sesuprima cualquier fila.

Para suprimir una fila que se acaba de buscar, utilice el atributo CurrentRow paraobtener el número de fila.

Nota: En las aplicaciones Java, este atributo necesita el controlador adecuado deconformidad con JDBC 2.0.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'ODBC1':'DeleteRow')=4*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' SETATR 4 'DELETEROW'*

Capítulo 2. Atributos de componente 171

Page 190: Manual Ibm

DelimCharEspecifica el carácter delimitador que separa varios elementos de una serie dedatos. Los atributos DelimChar y UseDelim se utilizan juntos.

Por ejemplo, puede utilizar el punto y coma (;) para delimitar los elementos de unaserie de datos como se indica: abcd;efgh;ijkl. Al especificar el atributoAddItemEnd, se generará una lista vertical de elementos de esta serie. De estemodo, se pueden añadir varios elementos con una sola operación.

Tipo Serie

Se aplica a los componentes

Recuadro decombinación

Recuadro de lista

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'CB1':'DelimChar') = ';'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CB1' SETATR ';' 'DELIMCHAR'*

172 VisualAge RPG Manual de consulta de componentes

Page 191: Manual Ibm

DeSelectAnula selecciones de elementos de la parte de lista de un componente.

En las aplicaciones Windows, DeSelect no tiene ningún efecto si:v El contenedor está establecido para una selección ampliada o múltiple y está en

la vista de árbol.v El subarchivo está establecido para la selección simple.

En estos casos, si se selecciona un elemento, permanece seleccionado.

En las aplicaciones Java, el contenedor se puede establecer para una selecciónampliada o múltiple en la vista de árbol.

Tipo Numérico

Se aplica a los componentes

Recuadro decombinación*

Contenedor Recuadro de lista Subarchivo

* Restricción: Este atributo no está soportado en tiempo de ejecución enlas aplicaciones Java para este componente.

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

Especifique el número del elemento que va a deseleccionar. Paradeseleccionar todos los elementos de la lista, establezca el valor en cero.

Ejemplo de formato libre

Deseleccionar el quinto elemento de la lista.*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'LB1': 'DeSelect') = 5*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' SETATR 5 'DESELECT'*

Capítulo 2. Atributos de componente 173

Page 192: Manual Ibm

DialogPermite que el usuario elija un diálogo Abrir o Guardar como.

Tipo Numérico

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de Dialog puede ser uno de los siguientes:

1 Abrir

2 Guardar como

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL rc = %getatr('*component': '*component':C 'Dialog')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' GETATR 'DIALOG' rc*

174 VisualAge RPG Manual de consulta de componentes

Page 193: Manual Ibm

DIRName

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Devuelve el nombre del directorio en el que se halla el componente lógico.

Tipo Serie

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor permitidoTexto

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL dir = %getatr('*component': '*component':C 'DIRName')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' GETATR 'DIRNAME' dir*

Capítulo 2. Atributos de componente 175

Page 194: Manual Ibm

DlgOwnerIndica qué ventana es propietaria de un diálogo. Si no se especifica, por omisiónserá propiedad del escritorio.

Tipo Serie

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor debe tener el formato:NombVent NombVent

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*component':'*component':'DlgOwner')=C ='win1 win1'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' SETATR 'win1 win1' 'DLGOWNER'*

176 VisualAge RPG Manual de consulta de componentes

Page 195: Manual Ibm

DoEvents

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Establezca este atributo en 1 para liberar el control de la subrutina de acciones queestá en ejecución actualmente para que se puedan ejecutar otros eventos. Es útilsobre todo cuando una subrutina de acciones está en un bucle de larga ejecución.

Tipo Numérico

Se aplica a los componentes

*component

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*component':'*component':'DoEvents')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*COMPONENT' SETATR 1 'DOEVENTS'*

Capítulo 2. Atributos de componente 177

Page 196: Manual Ibm

DragEnable

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Cuando este atributo está habilitado, el usuario puede mover el texto o la etiquetade un componente colocando el puntero encima del componente y pulsando ymanteniendo pulsado el botón 2 del ratón.

Tipo Numérico

Se aplica a los componentes

Recuadro decombinación

Campo de entrada Recuadro de lista Subarchivo demensajes

Edición de múltipleslíneas

Texto estático

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

Uno de los siguientes:

0 El texto o la etiqueta del componente no se puede arrastrar

1 El texto o la etiqueta del componente sí se puede arrastrar

Nota: Este atributo sólo se puede establecer en 1.

Ejemplo de formato librePermitir DragEnable para un componente:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'EF1': 'DragEnable') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' SETATR 1 'DRAGENABLE'*

178 VisualAge RPG Manual de consulta de componentes

Page 197: Manual Ibm

DropEnable

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Determina si el componente responderá a eventos Drop

Tipo Numérico

Se aplica a los componentes

Recuadro decombinación

Campo de entrada Recuadro de lista Subarchivo demensajes

Edición de múltipleslíneas

Texto estático

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

Uno de los siguientes:

0 El componente no responde a los eventos Drop

1 El componente responde a los eventos Drop

Nota: El valor por omisión de este atributo es 0 (desactivado). Una vezque se ha establecido en 1 en el constructor, no se puede restablecer.

Ejemplo de formato libre

Permitir operaciones de soltar en un componente:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'EF1': 'DropEnable') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' SETATR 1 'DROPENABLE'*

Capítulo 2. Atributos de componente 179

Page 198: Manual Ibm

DspHeightDevuelve la altura de la pantalla en pixels.

Tipo Numérico

Se aplica a los componentes

*Componente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre

Obtener la altura de la pantalla:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL DH=%getatr('*Component':'*Component':'DspHeight')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*COMPONENT' GETATR 'DSPHEIGHT' DH*

180 VisualAge RPG Manual de consulta de componentes

Page 199: Manual Ibm

DspWidthDevuelve la anchura de la pantalla en pixels.

Tipo Numérico

Se aplica a los componentes

*Componente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre

Obtener la anchura de la pantalla:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Dwd=%getatr('*Component':'*Component':C 'DspWidth')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*COMPONENT' GETATR 'DSPWIDTH' Dwd*

Capítulo 2. Atributos de componente 181

Page 200: Manual Ibm

EditItemEn las aplicaciones de Windows, al establecer este atributo en 1 se abre un campode edición en el texto del registro para un contenedor de la vista de iconos o deárbol. En las aplicaciones Java, este atributo sólo es aplicable a la vista de árbol.Debe establecer el atributo ColNumber antes de utilizarlo.

Tipo Numérico

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CN1': 'EditItem')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' SETATR 1 'EDITITEM'*

182 VisualAge RPG Manual de consulta de componentes

Page 201: Manual Ibm

EnableBtnHabilita e inhabilita los botones de navegación. Es necesario establecer ButtonIdxantes de utilizar el atributo EnableBtn.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

Puede ser uno de los siguientes:

0 Inhabilitar el botón

1 Habilitar el botón

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'SFI1': 'EnableBtn') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFI1' SETATR 1 'ENABLEBTN'*

Capítulo 2. Atributos de componente 183

Page 202: Manual Ibm

EnabledDetermina si el componente responderá a eventos de interfaz del usuario.

Nota: Si se especifica este atributo para los componentes en un lienzo, el valor delatributo establecido para el lienzo tiene preferencia.

Tipo Numérico

Se aplica a los componentes

Calendario Lienzo Recuadro de selección Recuadro decombinación

Contenedor Campo de entrada Gráfica Pulsador gráficoRecuadro de grupo Barra de

desplazamientohorizontal

Imagen Bean Java

Recuadro de lista Panel de medios Opción de menú Subarchivo demensajes

Edición de múltipleslíneas

Cuaderno Página de cuaderno Página de cuadernocon lienzo

Pulsador Botón de selección Graduador Selector cíclicoSubarchivo Barra de

desplazamientovertical

Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

Uno de los siguientes:

0 El componente no puede responder a eventos

1 El componente puede responder a eventos

184 VisualAge RPG Manual de consulta de componentes

Page 203: Manual Ibm

Ejemplo de formato libre

Conmutar el estado habilitado de un componente:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL rc = %getatr('win01': 'EF1': 'Enabled')*C rc IFEQ 0C EVAL %setatr('win01': 'EF1': 'Enabled') = 1*C ELSEC EVAL %setatr('win01': 'EF1': 'Enabled') = 0C ENDIF*

Ejemplo de formato fijo

Conmutar el estado de habilitación de un campo de entrada:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' GETATR 'ENABLED' rc 1 0C rc IFEQ 1C 'EF1' SETATR 0 'ENABLED'*C ELSEC 'EF1' SETATR 1 'ENABLED'C ENDIF*

Capítulo 2. Atributos de componente 185

Page 204: Manual Ibm

ExecuteAl establecer este atributo se envía un mandato execute a la aplicación del servidoren una conversación DDE. La aplicación del servidor determina la estructura de laserie del mandato. Consulte en la documentación de la aplicación del servidor losmandatos a los que se da soporte y la estructura de los mismos.

Se debe haber iniciado una conversación DDE satisfactoriamente antes deestablecer este atributo.

Cuando la aplicación del servidor procesa el mandato execute, genera un eventoExecuteAck. Compruebe el atributo de evento %DDEAck en la subrutina deacción del evento ExecuteAck para determinar si execute se ha realizado demanera satisfactoria.

Tipo Serie

Se aplica a los componentes

Cliente DDE

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'DDE1': 'Execute') = 'FILEOPEN'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'DDE1' SETATR 'FILEOPEN' 'EXECUTE'*

186 VisualAge RPG Manual de consulta de componentes

Page 205: Manual Ibm

ExecuteSQLSi se establece este atributo en 1, se ejecuta la sentencia SQL que ha sometido elúltimo atributo SQLQuery.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'ODBC1':'ExecuteSQL')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' SETATR 1 'EXECUTESQL'*

Capítulo 2. Atributos de componente 187

Page 206: Manual Ibm

ExtSelectDetermina si el componente permite la selección ampliada. La selección ampliadapermite que el usuario seleccione un elemento y a continuación seleccioneelementos adicionales. El usuario puede marcar varias entradas arrastrando elcursor del ratón sobre ellas.

El atributo MultSelect no tiene ningún efecto en el atributo ExtSelect. El atributoExtSelect prevalece sobre los valores para MultSelect o para una única selección.

Tipo Numérico

Se aplica a los componentes

Contenedor (1) Recuadro de lista(2.) Subarchivo (2.)

Restricciones:

1. Este atributo sólo se puede establecer en tiempo deejecución para el componente contenedor en lasaplicaciones Windows.

2. Este atributo sólo se puede obtener en tiempo deejecución para los componentes recuadro de lista ysubarchivo en las aplicaciones Java.

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

Uno de los siguientes:

0 La selección ampliada no está permitida

1 La selección ampliada está permitida

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL rc = %getatr('win01': 'LB1': 'ExtSelect')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' GETATR 'EXTSELECT' rc 1 0*

188 VisualAge RPG Manual de consulta de componentes

Page 207: Manual Ibm

FetchSi se establece este atributo en 1, devuelve una fila específica del origen de datosasociado. Los datos devueltos dependen del último tipo de petición de búsquedarealizada. Con una petición de atributo GetTables, Fetch devuelve una lista detablas de la base de datos. Con una petición ExecuteSQL, Fetch devuelve una filade datos de la tabla.

Nota: En las aplicaciones Java, este atributo necesita el controlador adecuado deconformidad con JDBC 2.0.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'ODBC1':'Fetch')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' SETATR 1 'FETCH'*

Capítulo 2. Atributos de componente 189

Page 208: Manual Ibm

FetchNextSi se establece este atributo en 1, se busca la siguiente fila de datos del conjunto deresultados.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'ODBC1':'FetchNext')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' SETATR 1 'FETCHNEXT'*

190 VisualAge RPG Manual de consulta de componentes

Page 209: Manual Ibm

FetchPriorSi se establece este atributo en 1, se busca la fila de datos anterior del conjunto deresultados.

Nota: En las aplicaciones Java, este atributo necesita el controlador adecuado deconformidad con JDBC 2.0.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'ODBC1':'FetchPrior')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' SETATR 1 'FETCHPRIOR'*

Capítulo 2. Atributos de componente 191

Page 210: Manual Ibm

FieldExitHace que, al pulsar Intro, el cursor se desplace al siguiente campo de entrada desalto de tabulación.

Tipo Numérico

Se aplica a los componentes

Recuadro decombinación

Campo de entrada

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

Uno de los siguientes:

0 El cursor no se colocará en el siguiente campo de entrada quecorresponda

1 El cursor se colocará en el siguiente campo de entrada quecorresponda

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'EF1': 'FieldExit') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' SETATR 1 'FIELDEXIT'*

192 VisualAge RPG Manual de consulta de componentes

Page 211: Manual Ibm

FileNameEspecifica el archivo que se asociará con el componente.

En un componente medios, puede ser un archivo válido de ondas (.wav) o MIDI(.mid) o bien, un archivo válido de vídeo que tenga la extensión .mov o .mpg.

En las aplicaciones de Windows que utilizan un componente control deanimación, el archivo puede ser de vídeo con la extensión .avi. En las aplicacionesJava que utilizan el componente control de animación con el atributo NbrOfImage,el archivo puede ser una imagen GIF.

En el caso de los componentes lienzo, pulsador gráfico, imagen u opción de menú,el archivo debe ser un archivo de imagen válido. Si desea ver una lista de losformatos de imagen válidos, consulte “Imagen” en la página 21.

En el componente opción de menú, si FileName hace referencia a un bitmap, laopción de menú se visualiza como el bitmap. Si FileName hace referencia a unarchivo de icono, el icono se visualiza junto al texto de la opción de menú. En lasaplicaciones Java, si FileName hace referencia a un archivo GIF, la imagen GIF sevisualiza junto al texto de la opción de menú.

En las aplicaciones Java, FileName hace referencia a un archivo GIF que sevisualiza como un icono en el componente Ventana.

Si se cambia el atributo FileName de un componente medios, no se procesa elarchivo. Para procesarlo, se debe establecer el atributo AudioMode.

Al cambiar el atributo FileName para un componente lienzo, pulsador gráfico oimagen, la imagen de ese componente cambiará de inmediato.

Si se establece el atributo FileName para *Component, se visualizará el diálogoespecificado con el atributo Dialog.

El nombre de archivo se puede especificar con la vía de acceso completa o sin ella.Si sólo se especifica el nombre de archivo, el archivo debe colocarse en elsubdirectorio de ejecución: el subdirectorio RT_JAVA para una aplicación Java o elsubdirectorio RT_WIN32 para una aplicación de Windows 95, Windows 98 oWindows NT. Si sólo se especifica el nombre de archivo, los archivos sólo selocalizarán si el subdirectorio RT_JAVA o RT_WIN32 es el directorio actual.

Consulte la publicación Programación con VisualAge para RPG para obtener másinformación sobre consideraciones de nombres de archivo.

Capítulo 2. Atributos de componente 193

||

Page 212: Manual Ibm

Tipo Serie

Se aplica a los componentes

Control de animación Lienzo *Component Pulsador gráficoImagen Medios Opción de menú VentanaVentana con lienzo

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

* Restricción: en aplicaciones Java, este atributo es sólo de escritura.

Valor permitidoEl nombre del archivo de estación de trabajo que se va a asociar con estecomponente

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'audio1':'FileName')='BARK.WAV'*

Ejemplo de formato fijo

Guardar el nombre de archivo actual de un componente imagen yestablecer un nuevo valor para el mismo:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'IMAGE01' GETATR 'FILENAME' oldfile 64C 'IMAGE01' SETATR newfile 'FILENAME'*

194 VisualAge RPG Manual de consulta de componentes

||

|

|

Page 213: Manual Ibm

FillStyle

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Describe la forma en que se rellenará un área

Tipo Numérico

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de FillStyle puede ser uno de los siguientes:

1 Sólido

2 Hueco

3 Relleno de baja densidad

4-9 Grados crecientes de densidad de relleno

10 Relleno de alta densidad

11 Con rayas verticales

12 Con rayas horizontales

13 Con rayas inclinadas hacia delante en diagonal

14 Con rayas muy inclinadas hacia delante en diagonal

15 Con rayas inclinadas hacia atrás en diagonal

16 Con rayas muy inclinadas hacia atrás en diagonal

17 Relleno a media tinta

18 Tramado

19 Tramado en diagonal

Capítulo 2. Atributos de componente 195

Page 214: Manual Ibm

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL style = %getatr('win01': 'GP1': 'FillStyle')*C style IFEQ 3C EVAL %setatr('win01': 'GP1': 'FillStyle') = 12C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GP1' SETATR 12 'FILLSTYLE'*

196 VisualAge RPG Manual de consulta de componentes

Page 215: Manual Ibm

FirstSelDevuelve el valor de índice del primer elemento seleccionado de la parte de listade un componente. Los valores de índice empiezan por 1. Si no hay ningúnelemento seleccionado en la lista, se devuelve cero.

Tipo Numérico

Se aplica a los componentes

Recuadro decombinación

Contenedor Recuadro de lista Subarchivo demensajes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL ix = %getatr('win01': 'LB1': 'FirstSel')*

Ejemplo de formato fijo

Comprobar si se ha seleccionado un elemento de un recuadro de lista yvisualizar un mensaje si no se ha seleccionado:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' GETATR 'FIRSTSEL' IX 3 0C IX IFEQ *ZEROC 'Select error'DSPLY STYLE rcC ENDIF*

Capítulo 2. Atributos de componente 197

Page 216: Manual Ibm

FocusDetermina si el componente tiene el foco actualmente. Cuando un componentetiene el foco, el cursor de entrada se traslada a él y la entrada del usuario se dirigehacia él. Por ejemplo, para que un usuario pueda escribir en un campo de entrada,éste debe tener el foco.

Cuando un componente recibe el foco, recibe un evento GotFocus.

Tipo Numérico

Se aplica a los componentes

Recuadro de selección Recuadro decombinación

Contenedor Campo de entrada

Pulsador gráfico Barra dedesplazamientohorizontal

Recuadro de lista Edición de múltipleslíneas

Cuaderno Pulsador Botón de selección GraduadorSelector cíclico Subarchivo Barra de

desplazamientovertical

Ventana*

* Restricción: Este atributo sólo se puede establecer en tiempo deejecución para el componente ventana en las aplicacionesJava.

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

Uno de los siguientes:

0 El componente no tiene el foco de entrada

1 El componente tiene el foco de entrada

Nota: Este atributo sólo se puede establecer en 1.

198 VisualAge RPG Manual de consulta de componentes

Page 217: Manual Ibm

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'EF1': 'Focus') = 1*C EVAL rc = %getatr('win01': 'EF1': 'Focus')*

Ejemplo de formato fijo

Conmutar el foco para un componente:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' GETATR 'FOCUS' HasFocus 1 0*C 'EF1' SETATR 1 'FOCUS'*

Capítulo 2. Atributos de componente 199

Page 218: Manual Ibm

FontAreaIndica el área del componente calendario, gráfica o subarchivo a la que debenaplicarse el resto de atributos relacionados con el font.

Tipo Numérico

Se aplica a los componentes

Calendario Gráfica Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

Para el componente calendario, el valor puede ser uno de los siguientes:

1 Mes/año

2 Nombre de los días

3 Valor por omisión para texto de usuario

4 Número de los días

5 Texto de usuario

Para el componente gráfica, el valor puede ser uno de los siguientes:

1 Font del título

2 Font de las etiquetas de los ejes

3 Font de las etiquetas de los puntos de datos

4 Font de la leyenda

Para el componente subarchivo, el valor puede ser uno de los siguientes:

1 Cabecera

2 Grabar

200 VisualAge RPG Manual de consulta de componentes

Page 219: Manual Ibm

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Farea = %getatr('win01': 'GRA1': 'FontArea')*C EVAL %setatr('win01': 'GRA1': 'FontArea') = 5*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GRA1' GETATR 'FONTAREA' Farea 1 0*

Capítulo 2. Atributos de componente 201

Page 220: Manual Ibm

FontBoldDetermina si la etiqueta o el texto se visualiza en negrita.

Tipo Numérico

Se aplica a los componentes

Calendario Lienzo Recuadro de selección Recuadro decombinación

Contenedor Campo de entrada Gráfica Recuadro de grupoRecuadro de lista Subarchivo de

mensajesEdición de múltipleslíneas

Cuaderno

Pulsador Botón de selección Graduador Selector cíclicoTexto estático Subarchivo Ventana*

* Restricción: Este atributo no está soportado en tiempo de ejecución enlas aplicaciones Java para este componente.

Nota: En el caso de los componentes calendario y gráfica, el área de fontreal afectada queda determinada por el valor del atributo FontArea.

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

* Nota: Puede definirse utilizando el cuaderno de propiedades deldiseñador GUI. Para ello, utilice la página Font y seleccione elpulsador Cambiar font.

202 VisualAge RPG Manual de consulta de componentes

Page 221: Manual Ibm

Valor permitido

El valor de FontBold puede ser uno de los siguientes:

0 El font no se visualiza en negrita

1 El font se visualiza en negrita

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL bold = %getatr('win01': 'ST1': 'FontBold')*C bold IFEQ 0C EVAL %setatr('win01': 'ST1': 'FontBold') = 1C ELSEC EVAL %setatr('win01': 'ST1': 'FontBold') = 0C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ST1' GETATR 'FONTBOLD' bold 1 0*C 'ST1' SETATR 1 'FONTBOLD'*

Capítulo 2. Atributos de componente 203

Page 222: Manual Ibm

FontItalicDetermina si la etiqueta o el texto se muestra en Cursiva.

Tipo Numérico

Se aplica a los componentes

Calendario Lienzo Recuadro de selección Recuadro decombinación

Contenedor Campo de entrada Gráfica Recuadro de grupoRecuadro de lista Subarchivo de

mensajesEdición de múltipleslíneas

Cuaderno

Pulsador Botón de selección Graduador Selector cíclicoTexto estático Subarchivo Ventana*

* Restricción: Este atributo no está soportado en tiempo de ejecución enlas aplicaciones Java para este componente.

Nota: En el caso de los componentes calendario y gráfica, el área de fontreal afectada queda determinada por el valor del atributo FontArea.

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

* Nota: Puede definirse utilizando el cuaderno de propiedades deldiseñador GUI. Para ello, utilice la página Font y seleccione elpulsador Cambiar font.

204 VisualAge RPG Manual de consulta de componentes

Page 223: Manual Ibm

Valor permitido

El valor de FontItalic puede ser uno de los siguientes:

0 El font no se visualiza en cursiva

1 El font se visualiza en cursiva

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL italic = %getatr('win01': 'ST1': 'FontItalic')*C italic IFEQ 0C EVAL %setatr('win01': 'ST1': 'FontItalic') = 1C ELSEC EVAL %setatr('win01': 'ST1': 'FontItalic') = 0C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ST1' GETATR 'FONTITALIC' italic 1 0*C 'ST1' SETATR 1 'FONTITALIC'*

Capítulo 2. Atributos de componente 205

Page 224: Manual Ibm

FontNameEspecifica el font que va a utilizarse para el texto o la etiqueta que se aplica a estecomponente.

Tipo Serie

Se aplica a los componentes

Calendario Lienzo Recuadro de selección Recuadro decombinación

Contenedor Campo de entrada Gráfica Recuadro de grupoRecuadro de lista Subarchivo de

mensajesEdición de múltipleslíneas

Cuaderno

Pulsador Botón de selección Graduador Selector cíclicoTexto estático Subarchivo Ventana*

* Restricción: Este atributo no está soportado en tiempo de ejecución enlas aplicaciones Java para este componente.

Nota: En el caso de los componentes calendario y gráfica, el área de fontreal afectada queda determinada por el valor del atributo FontArea.

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

* Nota: Puede definirse utilizando el cuaderno de propiedades deldiseñador GUI. Para ello, utilice la página Font y seleccione elpulsador Cambiar font.

Valor permitidoNombre del font

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL oldfont = %getatr('win01': 'ST1': 'FontName')*C EVAL %setatr('win01': 'ST1': 'FontName') = 'COURIER'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ST1' GETATR 'FONTNAME' oldfont 64*C 'ST1' SETATR 'COURIER' 'FONTNAME'*

206 VisualAge RPG Manual de consulta de componentes

Page 225: Manual Ibm

FontSizeEspecifica el tamaño del font a utilizar con este componente. El atributo FontSizese expresa en puntos.

Tipo Numérico

Se aplica a los componentes

Calendario Lienzo Recuadro de selección Recuadro decombinación

Contenedor Campo de entrada Gráfica Recuadro de grupoRecuadro de lista Subarchivo de

mensajesEdición de múltipleslíneas

Cuaderno

Pulsador Botón de selección Graduador Selector cíclicoTexto estático Subarchivo Ventana*

* Restricción: Este atributo no está soportado en tiempo de ejecución enlas aplicaciones Java para este componente.

Nota: En el caso de los componentes calendario y gráfica, el área de fontreal afectada queda determinada por el valor del atributo FontArea.

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

* Nota: Puede definirse utilizando el cuaderno de propiedades deldiseñador GUI. Para ello, utilice la página Font y seleccione elpulsador Cambiar font.

Valor permitidoEl tamaño de font especificado en puntos

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL oldsize = %getatr('win01': 'ST1': 'FontSize')*C EVAL %setatr('win01': 'ST1': 'FontSize') = 10*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ST1' GETATR 'FONTSIZE' oldsize 2 0*C 'ST1' SETATR 10 'FONTSIZE'*

Capítulo 2. Atributos de componente 207

Page 226: Manual Ibm

FontStrike

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Determina si el texto o la etiqueta aparecen en font tachado.

Tipo Numérico

Se aplica a los componentes

Calendario Lienzo Recuadro de selección Recuadro decombinación

Contenedor Campo de entrada Gráfica Recuadro de grupoRecuadro de lista Subarchivo de

mensajesEdición de múltipleslíneas

Cuaderno

Pulsador Botón de selección Graduador Selector cíclicoTexto estático Subarchivo Ventana

Nota: En el caso de los componentes calendario y gráfica, el área de fontreal afectada queda determinada por el valor del atributo FontArea.

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

* Nota: Puede definirse utilizando el cuaderno de propiedades deldiseñador GUI. Para ello, utilice la página Font y seleccione elpulsador Cambiar font.

208 VisualAge RPG Manual de consulta de componentes

Page 227: Manual Ibm

Valor permitido

El valor de FontStrike puede ser uno de los siguientes:

0 El font no se visualiza tachado

1 El font se visualiza tachado

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL strikeout=%getatr('win01':'ST1':'FontStrike')*C strikeout IFEQ 0C EVAL %setatr('win01':'ST1':'FontStrike')=1C ELSEC EVAL %setatr('win01':'ST1':'FontStrike')=0*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ST1' GETATR 'FONTSTRIKE' strikeout 1 0*C 'ST1' SETATR 1 'FONTSTRIKE'*

Capítulo 2. Atributos de componente 209

Page 228: Manual Ibm

FontUnder

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Determina si el texto o la etiqueta aparece subrayado.

Tipo Numérico

Se aplica a los componentes

Calendario Lienzo Recuadro de selección Recuadro decombinación

Contenedor Campo de entrada Gráfica Recuadro de grupoRecuadro de lista Subarchivo de

mensajesEdición de múltipleslíneas

Cuaderno

Pulsador Botón de selección Graduador Selector cíclicoTexto estático Subarchivo Ventana

Nota: En el caso de los componentes calendario y gráfica, el área de fontreal afectada queda determinada por el valor del atributo FontArea.

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

* Nota: Puede definirse utilizando el cuaderno de propiedades deldiseñador GUI. Para ello, utilice la página Font y seleccione elpulsador Cambiar font.

Valor permitido

El valor de FontUnder puede ser uno de los siguientes:

0 El texto no se subraya

1 El texto se subraya

210 VisualAge RPG Manual de consulta de componentes

Page 229: Manual Ibm

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL underline=%getatr('win01':'ST1':'FontUnder')*C underline IFEQ 0C EVAL %setatr('win01':'ST1':'FontUnder')=1C ELSEC EVAL %setatr('win01':'ST1':'FontUnder')=0C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ST1' GETATR 'FONTUNDER' underline 1 0*C 'ST1' SETATR 1 'FONTUNDER'*

Capítulo 2. Atributos de componente 211

Page 230: Manual Ibm

ForeColorValor numérico que determina el color de primer plano de un componente.

Si el color de primer plano se ha establecido utilizando el atributo ForeMix, elcolor de primer plano devuelto es el más próximo al color de mezcla.

Tipo Numérico

Se aplica a los componentes

Recuadro de selección Recuadro decombinación

Contenedor Campo de entrada

Recuadro de grupo Recuadro de lista Subarchivo demensajes

Edición de múltipleslíneas

Cuaderno Pulsador Botón de selección GraduadorSelector cíclico Texto estático Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

El color debe ser uno de los siguientes:

-1 Por omisión (no se utiliza en las aplicaciones Java)

0 Blanco

1 Negro

2 Azul (Blue)

3 Rojo (Red)

4 Rosa

5 Verde

6 Cian

7 Amarillo (Yellow)

8 Gris oscuro

9 Azul oscuro

212 VisualAge RPG Manual de consulta de componentes

Page 231: Manual Ibm

10 Rojo oscuro

11 Rosa oscuro

12 Verde oscuro

13 Cian oscuro

14 Marrón

15 Gris claro

Nota: No se puede utilizar el color por omisión (-1) para SETATR.

Ejemplo de formato libre

Establecer contraste invertido de un campo:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL fcolor = %getatr('win01': 'EF1': 'ForeColor')C EVAL bcolor = %getatr('win01': 'EF1': 'BackColor')*C EVAL %setatr('win01': 'EF1': 'ForeColor') = 2C EVAL %setatr('win01': 'EF1': 'BackColor') = 15*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' GETATR 'FORECOLOR' fcolor 2 0*C 'EF1' SETATR 2 'FORECOLOR'*

Capítulo 2. Atributos de componente 213

Page 232: Manual Ibm

ForeMixConsulta o establece la mezcla de colores de primer plano.

Tipo Serie

Se aplica a los componentes

Recuadro de selección Recuadro decombinación

Contenedor Campo de entrada

Recuadro de grupo Recuadro de lista Subarchivo demensajes

Edición de múltipleslíneas

Cuaderno Pulsador Botón de selección GraduadorSelector cíclico Texto estático Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

214 VisualAge RPG Manual de consulta de componentes

Page 233: Manual Ibm

Valor permitido

La mezcla de colores de primer plano debe tener el formato siguiente:'rojo:verde:azul'

donde rojo, verde y azul son valores situados entre 0 y 255 que representanla intensidad del color respectivo.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL colormix = %getatr('win01': 'EF1': 'ForeMix')*C EVAL %setatr('win01': 'EF1': 'ForeMix') = '10:23:200'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' SETATR '10:23:200' 'FOREMIX'*

Capítulo 2. Atributos de componente 215

Page 234: Manual Ibm

FormatDetermina el formato de los datos a los que el atributo Item hace referencia y quese han enviado a la aplicación del servidor en una conversación DDE. El valor deeste atributo lo determina la aplicación del servidor. Consulte la documentación dedicha aplicación para ver cuáles son los tipos de formato válidos. El valor poromisión es cf_text. Debe establecerse este atributo antes de utilizar el atributo Poke.

Tipo Serie

Se aplica a los componentes

Cliente DDE

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoEl formato de los datos a los que se hace referencia y que se envían a laaplicación del servidor

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'DDE1': 'Format') = 'bitmap'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'DDE1' SETATR 'bitmap' 'Format'*

216 VisualAge RPG Manual de consulta de componentes

Page 235: Manual Ibm

FrameRateDetermina el tiempo, en milisegundos, que transcurre entre cada fotograma de unasecuencia GIF animada.

Tipo Numérico

Se aplica a los componentes

Control de animación

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl número de milisegundos que transcurren entre las distintas imágenes.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'WIN1':'FrameRate')=1000*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ANI' SETATR 1000 'FRAMERATE'*

Capítulo 2. Atributos de componente 217

|

||

||

|

||||||

|

|||

||

|||

||

|

|||||

|

|||||

|

Page 236: Manual Ibm

FrmtStringIndica la forma en que se visualizan juntos el mes y el año.

Cada vez que se encuentre MMONTH o YYEAR en la serie de formato, sesustituirán, respectivamente, por el mes o el año actual. Por ejemplo, la serie deformato ″MMONTH - YYEAR″ correspondiente a julio de 1997 se convierte en″Julio - 1997″.

Tipo Serie

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'FrmtString') =C 'MMONTH/YYEAR'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' SETATR 'MMONTH/YYEAR''FRMTSTRING'*

218 VisualAge RPG Manual de consulta de componentes

Page 237: Manual Ibm

GetItemDevuelve un elemento de una lista. El elemento a devolver se determinaestableciendo primero el valor del atributo Index.

Tipo Serie

Se aplica a los componentes

Recuadro decombinación

Recuadro de lista Subarchivo demensajes

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL x = %getatr('win01': 'LB1': 'GetItem')*

Ejemplo de formato fijo

Guardar un elemento en un recuadro de lista y cambiarlo:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' SETATR 3 'INDEX'C 'LB1' GETATR 'GETITEM' saveitem 64C 'LB1' SETATR 'New string' 'SetItem'*

Capítulo 2. Atributos de componente 219

Page 238: Manual Ibm

GetNewIDDevuelve un ID nuevo y exclusivo para un registro de contenedor. Utilice esteatributo para asegurarse de que todos los ID de registros de contenedor sonexclusivos. El identificador de registro devuelto es un valor numérico.

Tipo Numérico

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL id = %getatr('win01': 'CN1': 'GetNewID')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' GETATR 'GetNewID' id*

220 VisualAge RPG Manual de consulta de componentes

Page 239: Manual Ibm

GetRcdFldDevuelve el contenido de un campo de un registro de contenedor. El atributoRecordID del contenedor debe estar establecido para indicar qué registro decontenedor se ha de utilizar. También debe estar establecido el atributoColNumber para indicar el campo del que se recuperarán los datos.

Tipo Serie

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CN1': 'RecordID')=IDC EVAL %setatr('win01': 'CN1': 'ColNumber')=1C EVAL data = %getatr('win01': 'CN1': 'GetRcdFld')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' SETATR ID 'RECORDID'C 'CN1' SETATR 1 'COLNUMBER'C 'CN1' GETATR 'GETRCDFLD' data*

Capítulo 2. Atributos de componente 221

Page 240: Manual Ibm

GetRcdIconDevuelve el nombre de archivo del icono que se utiliza para representar esteregistro en la vista de árbol y de iconos. El atributo RecordID debe estarestablecido para identificar a qué registro se hace referencia.

Tipo Serie

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL file = %getatr('win01': 'CN1': 'GetRcdIcon')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' GETATR 'GETRCDICON' file*

222 VisualAge RPG Manual de consulta de componentes

Page 241: Manual Ibm

GetRcdTextDevuelve el texto del icono correspondiente a un registro del contenedor. Elatributo RecordID debe estar establecido para identificar a qué registro se hacereferencia.

Tipo Serie

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL text = %getatr('win01': 'CN1': 'GetRcdText')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' GETATR 'GETRCDTEXT' text*

Capítulo 2. Atributos de componente 223

Page 242: Manual Ibm

GetTablesAl establecer este atributo en 1, se recupera la lista de las tablas almacenadas enuna fuente de datos. El componente Interfaz ODBC/JDBC devuelve la lista comoun conjunto de datos. Este atributo es equivalente a la API ODBC de tablas SQL.Puede utilizar el atributo FetchNext para obtener los registros de tablas delconjunto de datos devuelto.

Para ODBC, cada registro de la lista corresponde a una tabla y contiene lainformación siguiente:

Columna Nombre decolumna

Tipo de datos Comentarios

1 Calificador de tabla Carácter2 Propietario de tabla Carácter El propietario de la tabla3 Nombre de tabla Carácter El nombre de la tabla4 Tipo de tabla Carácter Una serie que representa el tipo

de la tabla5 Observaciones Carácter Una descripción de la tabla

Consulte la documentación de la API ODBC para conocer los detalles de lasdescripciones de columna.

Para JDBC, se devuelve la información siguiente:

Columna Nombre decolumna

Tipo de datos Comentarios

1 TABLE_CAT Carácter Catálogo de tablas (puede ser unnulo)

2 TABLE_SCHEM Carácter Esquema de tablas (puede ser unnulo)

3 TABLE_NAME Carácter El nombre de la tabla4 TABLE_TYPE Carácter Una serie que representa el tipo

de la tabla. Los valores usualesson: TABLE, VIEW, SYSTEMTABLE, ALIAS, etcétera.

5 REMARKS Carácter Una descripción de la tabla

Consulte la documentación de la API JDBC para conocer los detalles de lasdescripciones de columna.

224 VisualAge RPG Manual de consulta de componentes

Page 243: Manual Ibm

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'ODBC1':'GetTables')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' SETATR 1 'GETTABLES'*

Ejemplo de GetTablesEn este ejemplo se muestra cómo obtener una lista de tablas de una fuente dedatos y listarlas en el recuadro de lista TABLES:CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----C 'ODBC1' Setatr 1 'GetTables'C 'ODBC1' Setatr 1 'Fetch'C 'ODBC1' Getatr 'IsData' Temp 1 0*

C If Temp = 1C 'Tables' Setatr 0 'RemoveItem'*

C DoW Temp = 1C 'ODBC1' Setatr 3 'Column'C 'ODBC1' Getatr 'CharData' TableName 20C 'Tables' Setatr TableName 'AddItemEnd'C 'ODBC1' Setatr 1 'FetchNext'C 'ODBC1' Getatr 'IsData' TempC EndDo*

C EndIf

Capítulo 2. Atributos de componente 225

Page 244: Manual Ibm

GnEqGrpColGenera un conjunto aleatorio de colores de manera que todos los puntos de datosde un mismo grupo sean del mismo color.

Este atributo resulta útil cuando se muestra una gráfica de barras.

Tipo Numérico

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl valor sólo puede definirse en 1.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'GR1':'GnEqGrpCol')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GR1' SETATR 1 'GNEQGRPCOL'*

226 VisualAge RPG Manual de consulta de componentes

Page 245: Manual Ibm

GnEqPntColGenera un conjunto aleatorio de colores de manera que todos los valores de unpunto de datos determinado sean del mismo color.

Este atributo resulta útil cuando se muestra un diagrama circular.

Tipo Numérico

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl valor sólo puede definirse en 1.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'GR1':'GnEqPntCol')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GR1' SETATR 1 'GNEQPNTCOL'*

Capítulo 2. Atributos de componente 227

Page 246: Manual Ibm

GraphTypeIndica qué tipo de gráfica se utiliza.

Tipo Numérico

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

GraphType puede tener uno de los siguientes valores:

1 Gráfica de líneas

2 Gráfica de barras

3 Gráfica de barras y de líneas

4 Diagrama circular

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL GRtype = %getatr('win01': 'GRT1': 'GraphType')*C EVAL %setatr('win01': 'GRT1': 'GraphType') = 2*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GRT1' GETATR 'GRAPHTYPE' 'GRtype' 1 0*C 'GRT1' SETATR 2 'GRAPHTYPE'*

228 VisualAge RPG Manual de consulta de componentes

Page 247: Manual Ibm

GrphHiLiteDetermina si se resalta un elemento.

Tipo Numérico

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de GrphHiLite puede ser uno de los siguientes:

0 No se resalta el elemento

1 Sí se resalta el elemento

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL lite = %getatr('win01': 'GR1': 'GrphHiLite')*C lite IFEQ 0C EVAL %setatr('win01': 'GR1': 'GrphHiLite') = 1C ELSEC EVAL %setatr('win01':'GR1': 'GrphHiLite') = 0C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GR1' GETATR 'GRPHHILITE' lite 1 0*C 'GR1' SETATR 1 'GRPHHILITE'*

Capítulo 2. Atributos de componente 229

Page 248: Manual Ibm

GroupLabelIndica cuál es la etiqueta del grupo actual. Las etiquetas de grupo se utilizan comoencabezamiento de cada uno de los grupos de puntos, si la gráfica es un diagramacircular, o como leyenda, si ésta está definida para mostrar las etiquetas de grupo.

Tipo Serie

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'graph1':'GroupLabel')='July'*

Ejemplo de formato fijo

Guardar la etiqueta actual de un componente gráfica y establecer un nuevovalor para la misma:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GRAPH01' GETATR 'GROUPLABEL' oldlabelC 'GRAPH01' SETATR 'July' 'GROUPLABEL'*

230 VisualAge RPG Manual de consulta de componentes

Page 249: Manual Ibm

Handle

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Devuelve el handle de ventana del componente. Si está familiarizado con las APIde Windows, puede utilizar este handle para invocar las funciones de API. En elproceso ODBC, devuelve el handle de entorno.

Por ejemplo, cuando el componente Interfaz ODBC/JDBC se conecta a una base dedatos, se crea un handle de entorno y se devuelve al componente. El componenteutiliza este handle para comunicarse con la API ODBC. El atributo Handle sepuede utilizar para recuperar la variable de handle del programa e invocar lasfunciones de la API ODBC. La variable de handle es un valor de 32 bits. Debecodificar la variable para recibir el handle como tipo de datos entero con unalongitud de 10 y 0 decimales:DName+++++++++++ETDsFrom+++To/L+++IDc.Keywords+++++++++++++D hWnd S 10I 0

Tipo Numérico

Se aplica a los componentes

Todos los componentes excepto los siguientes: ActiveX, *componentelógico, referencia a componente lógico, barra de menús, opción de menú,página de cuaderno, página de cuaderno con lienzo, submenú ytemporizador.

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor devueltoDevuelve el handle del componente.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL hWnd = %getatr('win01': 'FW1': 'Handle')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'FW1' GETATR 'HANDLE' hWnd*

Capítulo 2. Atributos de componente 231

Page 250: Manual Ibm

HasPrpPageDevuelve el valor 1 si el objeto ActiveX tiene su propio diálogo de página depropiedades. Devuelve el valor 0 si no lo tiene.

Tipo Numérico

Se aplica a los componentes

ActiveX

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL PPG=%getatr('win01':'AX1':'HasPrpPage')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'AX1' GETATR 'HASPRPPAGE' PPG*

232 VisualAge RPG Manual de consulta de componentes

Page 251: Manual Ibm

HdgBGClrValor numérico que determina el color de fondo de una cabecera de subarchivo.

Si el color de fondo se ha establecido mediante el atributo HdgBGMix, el color defondo devuelto es el que se parece más al color de mezcla.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El color debe ser uno de los siguientes:

-1 Por omisión

0 Blanco

1 Negro

2 Azul

3 Rojo

4 Rosa

5 Verde

6 Cian

7 Amarillo

8 Gris oscuro

9 Azul oscuro

10 Rojo oscuro

Capítulo 2. Atributos de componente 233

Page 252: Manual Ibm

11 Rosa oscuro

12 Verde oscuro

13 Cian oscuro

14 Marrón

15 Gris claro

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL HBcolor = %getatr('win01': 'SFL1': 'HdgBGClr')*C EVAL %setatr('win01': 'SFL1': 'HdgBGClr') = 5*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' GETATR 'HDGBGCLR' HBcolor 2 0*C 'SFL1' SETATR 5 'HDGBGCLR'*

234 VisualAge RPG Manual de consulta de componentes

Page 253: Manual Ibm

HdgBGMixConsulta o establece la mezcla de colores de fondo de una cabecera de subarchivo.

Tipo Serie

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

La mezcla del color de fondo debe tener el formato siguiente:'rojo:verde:azul'

donde rojo, verde y azul son valores situados entre 0 y 255 que representanla intensidad del color respectivo.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL HBclrMx=%getatr('win01':'SFL1':'HdgBGMix')*C HBclrMx IFNE '10:23:200'C EVAL %setatr('win01':'SFL1':'HdgBGMix')='10:23:200'C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' SETATR '10:23:200' 'HDGBGMIX'*

Capítulo 2. Atributos de componente 235

Page 254: Manual Ibm

HdgFGClrValor numérico que determina el color de primer plano de una cabecera desubarchivo.

Si el color de primer plano se ha establecido mediante el atributo HdgFGMix, elcolor de primer plano devuelto es el que se parece más al color de mezcla.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El color debe ser uno de los siguientes:

-1 Por omisión

0 Blanco

1 Negro

2 Azul

3 Rojo

4 Rosa

5 Verde

6 Cian

7 Amarillo

8 Gris oscuro

9 Azul oscuro

10 Rojo oscuro

11 Rosa oscuro

12 Verde oscuro

13 Cian oscuro

14 Marrón

15 Gris claro

236 VisualAge RPG Manual de consulta de componentes

Page 255: Manual Ibm

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL HFcolor = %getatr('win01': 'SFL1': 'HdgFGClr')*C EVAL %setatr('win01': 'SFL1': 'HdgFGClr') = 5*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' GETATR 'HDGFGCLR' HFcolor 2 0*C 'SFL1' SETATR 5 'HDGFGCLR'*

Capítulo 2. Atributos de componente 237

Page 256: Manual Ibm

HdgFGMixConsulta o establece la mezcla de colores de primer plano de una cabecera desubarchivo.

Tipo Serie

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

La mezcla de colores de primer plano debe tener el formato siguiente:'rojo:verde:azul'

donde rojo, verde y azul son valores situados entre 0 y 255 que representanla intensidad del color respectivo.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL HFclrMx = %getatr('win01': 'SFL1': 'HdgFGMix')*C HFclrMx IFNE '10:23:200'C EVAL %setatr('win01': 'SFL1': 'HdgFGMix')C = '10:23:200'C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' SETATR '10:23:200' 'HDGFGMIX'*

238 VisualAge RPG Manual de consulta de componentes

Page 257: Manual Ibm

HdgIdxIdentifica la fila en una cabecera de columna de varias líneas. Por ejemplo, unvalor de 1 especifica la primera fila. Utilice este atributo junto con el atributoColNumber para recuperar o cambiar el texto especificado en el atributo HdgText.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoHdgIdx puede estar entre 1 y 3.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'SF1':'HdgIdx')=3C EVAL %setatr('win01': 'SF1': 'ColNumber') = 2*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SF1' SETATR 3 'HDGIDX'C 'SF1' SETATR 2 'COLNUMBER'*

Capítulo 2. Atributos de componente 239

Page 258: Manual Ibm

HdgTextEl texto de la cabecera de columna. Este texto puede contener hasta tres líneas detexto. Puede ser un identificador de mensaje del archivo de mensajes o etiqueta desustitución. Para cambiar este texto en tiempo de ejecución, debe establecer anteslos atributos ColNumber y HdgIdx.

Tipo Serie

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'SF1':'HdgText')='HEAD1'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SF1' SETATR 'HEAD1' 'HDGTEXT'*

240 VisualAge RPG Manual de consulta de componentes

Page 259: Manual Ibm

HeightEspecifica la altura del componente en pixels.

El atributo Height no puede sobrepasar la altura máxima determinada por laresolución de pantalla utilizada. Por ejemplo, no se puede crear un componenteque tenga 600 pixels de altura si se trabaja con una pantalla de 480 pixels dealtura.

Tipo Numérico

Se aplica a los componentes

ActiveX Calendario Lienzo Recuadro de selecciónRecuadro decombinación

Contenedor Campo de entrada Gráfica

Pulsador gráfico Recuadro de grupo Barra dedesplazamientohorizontal

Imagen

Bean Java Recuadro de lista Panel de medios Subarchivo demensajes

Edición de múltipleslíneas

Cuaderno Interfaz ODBC/JDBC Recuadro de contorno

Barra de progreso Pulsador Botón de selección GraduadorSelector cíclico Texto estático Subarchivo Barra de

desplazamientovertical

Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitidoLa altura del componente en pixels

Ejemplo de formato libre

Cambiar la altura de un componente:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL howtall = %getatr('win01': 'PB1': 'Height')C howtall add 150 howtallC EVAL %setatr('win01': 'PB1': 'Height') = howtall*

Ejemplo de formato fijo

Hacer que un pulsador tenga 100 pixels menos de altura:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'PB1' GETATR 'HEIGHT' OldHeight 2 0C OldHeight SUB 100 NewHeight 2 0C 'PB1' SETATR NewHeight 'HEIGHT'*

Capítulo 2. Atributos de componente 241

|||

||

|||

||

|

Page 260: Manual Ibm

HelpEnableVisualiza información de Ayuda cuando el usuario pulsa un pulsador o unpulsador gráfico. Es lo más útil si desea visualizar Ayuda general para unaventana. Generalmente, para visualizar Ayuda para un componente, el usuariodebe pulsar la tecla F1 cuando el componente tiene el foco.

Nota: Para que el usuario pueda visualizar la ayuda, primero debe dar el foco alcomponente pulsador o pulsador gráfico.

Tipo Numérico

Se aplica a los componentes

Pulsador gráfico Pulsador

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades deldiseñador GUI. Para ello, seleccione el estilo Visualizar ayuda.

Valor permitido

El valor de HelpEnable puede ser uno de los siguientes:

0 No está habilitada la Ayuda para este componente

1 Está habilitada la Ayuda para este componente

242 VisualAge RPG Manual de consulta de componentes

Page 261: Manual Ibm

Ejemplo de formato libre

Conmutar el estado de ayuda habilitada de un componente:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL rc = %getatr('win01': 'PB1': 'HelpEnable')*C rc IFEQ 0C EVAL %setatr('win01': 'PB1': 'HelpEnable') = 1*C ELSEC EVAL %setatr('win01': 'PB1': 'HelpEnable') = 0C ENDIF*

Ejemplo de formato fijo

Conmutar el estado de ayuda habilitada de un campo de entrada:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'PB1' GETATR 'HELPENABLE' HasHelp 1 0C HasHelp IFEQ 1C 'PB1' SETATR 0 'HELPENABLE'*C ELSEC 'PB1' SETATR 1 'HELPENABLE'C ENDIF*

Capítulo 2. Atributos de componente 243

Page 262: Manual Ibm

HelpWindowOrigina la visualización de una ventana específica de panel de ayuda. El valor dehelpid es el identificador de ayuda especificado en el archivo de ayuda. Si seutiliza el valor de identificador de ayuda 0, se visualizará un diálogo de temas deayuda del estilo de Windows 95.

Tipo Numérico

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl helpid

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*component':'*component':'HelpWindow')=C 12*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' SETATR 12 'HELPWINDOW'*

244 VisualAge RPG Manual de consulta de componentes

Page 263: Manual Ibm

HiddenDetermina si una columna de un subarchivo será visible. El atributo ColNumberdebe estar establecido para indicar a qué columna afecta.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de Hidden puede ser uno de los siguientes:

0 La columna no está oculta

1 La columna está oculta

Ejemplo de formato libre

Cambiar el estado Hidden de una columna*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL rc = %getatr('win01': 'SF1': 'Hidden')*C rc IFEQ 0C EVAL %setatr('win01': 'SF1': 'Hidden') = 1*C ELSEC EVAL %setatr('win01': 'SF1': 'Hidden') = 0C ENDIF*

Ejemplo de formato fijo

Cambiar el estado Hidden de un atributo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SF1' GETATR 'HIDDEN' IsHidden 1 0C IsHidden IFEQ 1C 'SF1' SETATR 0 'HIDDEN'*C ELSEC 'SF1' SETATR 1 'HIDDEN'C ENDIF*

Capítulo 2. Atributos de componente 245

Page 264: Manual Ibm

HighLightDetermina si se resalta el componente especificado. Un componente resaltado tieneel mismo aspecto que un botón en el que se pulse el botón 1 del ratón mientras elpuntero del ratón está sobre el control del botón.

Tipo Numérico

Se aplica a los componentes

Recuadro deselección*

Pulsador gráfico Pulsador Botón de selección*

* Restricción: Este atributo no está soportado en tiempo de ejecución enlas aplicaciones Java para este componente.

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de HighLight puede ser uno de los siguientes:

0 El componente no está resaltado

1 El componente está resaltado

246 VisualAge RPG Manual de consulta de componentes

Page 265: Manual Ibm

Ejemplo de formato libre

Conmutar el estado de HighLight de un componente:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL rc = %getatr('win01': 'PB1': 'HighLight')*C rc IFEQ 0C EVAL %setatr('win01': 'PB1': 'HighLight') = 1*C ELSEC EVAL %setatr('win01': 'PB1': 'HighLight') = 0C ENDIF*

Ejemplo de formato fijo

Conmutar el estado de HighLight de un componente:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'PB1' GETATR 'HIGHLIGHT' IsHighlighted 1 0C IsHilighted IFEQ 1 0C 'PB1' SETATR 0 'HIGHLIGHT'*C ELSEC 'PB1' SETATR 1 0 'HIGHLIGHT'C ENDIF*

Capítulo 2. Atributos de componente 247

Page 266: Manual Ibm

HitItemUna vez establecido UnderPoint, HitItem indicará qué aspecto de la gráfica estádebajo del punto especificado.

Si debajo del punto especificado se encuentra una barra o un sector, se establecenDataGroup y DataPoint.

Si la gráfica es un diagrama circular y debajo del punto especificado hay unaetiqueta de grupo, se establece DataGroup.

Nota: Este atributo no se utiliza en las aplicaciones Java.

Tipo Numérico

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor devuelto

Uno de los siguientes:

0 No hay nada debajo del punto especificado

1 Debajo del punto especificado hay una barra

2 Debajo del punto especificado hay un sector

3 Debajo del punto especificado está la leyenda

4 Debajo del punto especificado está el título

5 Debajo del punto especificado está la etiqueta del eje de la X

6 Debajo del punto especificado está la etiqueta del eje de la Y

7 Debajo del punto especificado hay una etiqueta de grupo

248 VisualAge RPG Manual de consulta de componentes

Page 267: Manual Ibm

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL itemhit = %getatr('win01': 'GRA1': 'HitItem')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GRA1' GETATR 'HITITEM' itemhit 1 0*

Capítulo 2. Atributos de componente 249

Page 268: Manual Ibm

HlitPoints

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Si se establece HlitPoints, se resaltan todos los datos del grupo indicado porDataGroup. Este es relevante sólo si la gráfica es de barras.

Tipo Numérico

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

Los valores permitidos son los siguientes:

0 El grupo de datos actual no está resaltado

Cualquier valor que no sea ceroEl grupo de datos actual está resaltado

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'GP1': 'HlitPoints') = 20*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GP1' SETATR 20 'HLITPOINTS'*

250 VisualAge RPG Manual de consulta de componentes

Page 269: Manual Ibm

HRuleVisualiza reglas horizontales.

Tipo Numérico

Se aplica a los componentes

Calendario Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de HRule puede ser uno de los siguientes:

0 Desactiva la regla

1 Activa la regla

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Hzrule = %getatr('win01': 'SF1': 'HRule')*C Hzrule IFEQ 0C EVAL %setatr('win01': 'SF1': 'HRule') = 1C ELSEC EVAL %setatr('win01': 'SF1': 'HRule') = 0C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SF1' GETATR 'HRULE' Hzrule 1 0*C 'SF1' SETATR 1 'HRULE'*

Capítulo 2. Atributos de componente 251

Page 270: Manual Ibm

IconHandle

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Devuelve el handle del icono de ventana.

Tipo Numérico

Se aplica a los componentes

Ventana Ventana con lienzo

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL ichW=%getatr('win01':'FW1':'IconHandle')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'FW1' GETATR 'ICONHANDLE' ICHW*

252 VisualAge RPG Manual de consulta de componentes

Page 271: Manual Ibm

IndexEstablece el valor de índice para la parte de lista de un componente. Este valordetermina el elemento que se ve afectado cuando se utilizan determinadosatributos. Por ejemplo, el atributo Index debe establecerse para un elemento paraque el atributo GetItem se pueda utilizar para recuperarlo.

Tipo Numérico

Se aplica a los componentes

Recuadro decombinación

Recuadro de lista Subarchivo demensajes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoValor de índice

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'LB1': 'Index') = 4*C EVAL index = %getatr('win01': 'LB1': 'Index')*

Ejemplo de formato fijo

Guardar el valor de índice actual para un recuadro de lista y, acontinuación, cambiarlo:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' GETATR 'INDEX' OldIndex 2 0C 'LB1' SETATR NewIndex 'INDEX' 2 0*

Capítulo 2. Atributos de componente 253

Page 272: Manual Ibm

InPlace

Nota: Este atributo sólo se utiliza en Windows NT/95/98.

Utilice InPlace para designar dónde debe reproducirse el archivo de vídeo. SiInPlace se establece en 1, el vídeo se reproducirá en la posición del componentemedios. Si se establece en 0, el archivo se reproducirá en una ventana aparte.

Tipo Numérico

Se aplica a los componentes

Medios

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de InPlace puede ser uno de los siguientes:

0 El archivo se abrirá en una ventana aparte

1 El archivo se abrirá en la posición del componente medios

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'AUD1': 'InPlace') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'AUD1' SETATR 1 'INPLACE'*

254 VisualAge RPG Manual de consulta de componentes

Page 273: Manual Ibm

InsertItem

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Inserta un elemento en la parte de lista de un componente. El valor actual delatributo Sequence para el componente determina dónde se insertará el elementoen la lista.

Si se utiliza el método Index para insertar elementos en la lista, el elemento queaparece en la posición del valor de índice y todos los que le siguen descienden unpuesto en la lista.

Tipo Serie

Se aplica a los componentes

Recuadro decombinación

Recuadro de lista

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl elemento a insertar en la lista

Ejemplo de formato libre

Insertar un elemento en un recuadro de lista:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'LB1': 'Index') = 3C EVAL %setatr('win01': 'LB1': 'InsertItem') = 'new'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' SETATR 3 'INDEX'C 'LB1' SETATR 'new' 'InsertItem'*

Capítulo 2. Atributos de componente 255

Page 274: Manual Ibm

InsertLineInserta la serie especificada en el campo de edición de múltiples líneas en laposición especificada mediante el atributo LineNumber actual. Todas las líneassiguientes a la que se ha insertado descienden una línea.

Tipo Serie

Se aplica a los componentes

Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoLa serie que se añadirá al campo de edición de múltiples líneas

Ejemplo de formato libre

Insertar texto en el desplazamiento 10 en un campo de edición demúltiples líneas:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'MLE1': 'LineNumber') = 10C EVAL %setatr('win01': 'MLE1': 'InsertLine') = 'text'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' SETATR 10 'LINENUMBER'C 'MLE1' SETATR 'text' 'INSERTLINE'*

256 VisualAge RPG Manual de consulta de componentes

Page 275: Manual Ibm

InsertMode

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Determina si la parte del campo de entrada del componente está en modalidad deinserción. Cuando la modalidad de inserción está activada, al escribir caracteres enun campo, se desplazan los caracteres situados a la derecha del cursor. Cuandoestá desactivada, al escribir caracteres en un campo, se escribe encima de losexistentes.

Tipo Numérico

Se aplica a los componentes

Campo de entrada

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor permitido

El valor de InsertMode puede ser uno de los siguientes:

0 El campo de entrada no está en modalidad de inserción

1 El campo de entrada está en modalidad de inserción

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL mode = %getatr('win01': 'EF1': 'InsertMode')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' GETATR 'INSERTMODE' InsertMode 1 0*

Capítulo 2. Atributos de componente 257

Page 276: Manual Ibm

InsertRowAl establecer este atributo en 1, se añade otra fila a la tabla. Antes de añadir lanueva fila, los datos se traspasan de los campos de programa que están enlazadosa las columnas de las tablas.

Nota: En las aplicaciones Java, este atributo necesita el controlador adecuado deconformidad con JDBC 2.0.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'ODBC1':'InsertRow')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' SETATR 1 'INSERTROW'*

258 VisualAge RPG Manual de consulta de componentes

Page 277: Manual Ibm

InsertTextInserta el texto especificado en la posición actual del cursor del campo de ediciónde múltiples líneas.

Tipo Serie

Se aplica a los componentes

Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoLa serie de texto que se debe insertar

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'MLE1': 'InsertText') = 'New'*

Ejemplo de formato fijo

Añadir texto a un campo de edición de múltiples líneas en la posiciónactual del cursor::*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' SETATR 'New' 'InsertText'*

Capítulo 2. Atributos de componente 259

Page 278: Manual Ibm

IntervalDetermina el valor de intervalo para un componente temporizador. Este atributo seutiliza con el atributo Multiplier para determinar el número de milisegundos quetranscurrirán hasta que el temporizador genere un evento Tick.

Tipo Numérico

Se aplica a los componentes

Temporizador

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitidoValor del intervalo en milisegundos

El valor máximo del intervalo es 65535.

El valor mínimo del intervalo es 100.

Ejemplo de formato libre

Cambiar el valor de intervalo para un componente temporizador a unsegundo (1000 milisegundos):*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL oldint=%getatr('win01':'TIMER01':'Interval')*C EVAL %setatr('win01':'TIMER01':'Interval')=1000*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'TIMER01' GETATR 'INTERVAL' OldInt 6 0*C 'TIMER01' SETATR 1000 'INTERVAL'*

260 VisualAge RPG Manual de consulta de componentes

Page 279: Manual Ibm

InUse

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Consulta si un objeto del contenedor tiene actualmente un énfasis que indica quese está utilizando. Un objeto con este énfasis está en una ventana de diseño abiertay se muestra con un recuadro sombreado detrás de su icono, como se indica acontinuación:

El atributo RecordID debe estar establecido para indicar a qué registro se hacereferencia.

Tipo Numérico

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de InUse puede ser uno de los siguientes:

0 No se está utilizando

1 Se está utilizando

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CN1': 'InUse') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' SETATR 1 'INUSE'*

Capítulo 2. Atributos de componente 261

Page 280: Manual Ibm

InvName

*Restricción: Este atributo sólo se utiliza en las aplicaciones Java.

Especifica el nombre del componente que invoca o bien, ancla el menú emergente.Este atributo se utiliza junto con los atributos InvPname, X e Y.

Tipo Serie

Se aplica a los componentes

Menú emergente

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'POP1':'InvName')='INVN1'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'POP1' SETATR 'INVN1' 'INVNAME'*

262 VisualAge RPG Manual de consulta de componentes

Page 281: Manual Ibm

InvPName

*Restricción: Este atributo sólo se utiliza en las aplicaciones Java.

Especifica el nombre de padre del componente que invoca o bien, ancla el menúemergente. Este atributo se utiliza junto con los atributos InvName, X e Y.

Tipo Serie

Se aplica a los componentes

Menú emergente

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'POP1':'InvPName')='INVPN1'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'POP1' SETATR 'INVPN1' 'INVPNAME'*

Capítulo 2. Atributos de componente 263

Page 282: Manual Ibm

IsDataIndica si una operación Fetch, FetchNext o FetchPrior ha devuelto datos.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor devuelto

0 Indica que no se ha devuelto ningún dato.

1 Indica que se han devuelto datos.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Flag=%getatr('win01':'ODBC1':'IsData')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' GETATR 'ISDATA' FLAG*

264 VisualAge RPG Manual de consulta de componentes

Page 283: Manual Ibm

ItemUn elemento DDE es la unidad de datos específica a la que se hace referencia enuna conversación DDE. Un ejemplo de un elemento DDE es una casilla en unaaplicación de hoja de cálculo. El formato de un elemento DDE lo determina laaplicación del servidor. Consulte la documentación de la aplicación del servidorpara ver cuáles son los tipos de este formato. En el ejemplo de una hoja de cálculopodría ser ’A1’.

En la tabla siguiente se resume qué componentes pueden ser un elemento de unaconversación DDE, y a qué atributo se hace referencia durante un evento Poke oRequest. Si se hace referencia a cualquier otro tipo de componente, la operación sepasa por alto.

Tipo de componente Poke Request

Medios Nombre de archivo Nombre de archivo

Recuadro de selección Etiqueta Etiqueta

Campo de entrada Texto Texto

Imagen Nombre de archivo Nombre de archivo

Recuadro de lista ninguno Elemento seleccionado

Graduador Valor Valor

Texto estático Etiqueta Etiqueta

Temporizador Count Count

Tipo Serie

Se aplica a los componentes

Cliente DDE

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoLa unidad de datos a la que se hace referencia en una conversación DDE

Si el programa del servidor es un componente lógico VisualAge RPG, elelemento será el nombre del componente al que se hace referencia. Seespecifica del modo siguiente:

'ventana|componente'

Capítulo 2. Atributos de componente 265

Page 284: Manual Ibm

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'DDE1': 'Item') = 'A1'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'DDE1' SETATR 'A1' 'ITEM'*

266 VisualAge RPG Manual de consulta de componentes

Page 285: Manual Ibm

ItemCountDevuelve el número de elementos que hay en la lista de valores de una columnade subarchivo. Primero ha de establecerse el atributo ColNumber a fin deidentificar la columna con la que se debe trabajar. El tipo de validación de lacolumna de subarchivo debe ser Values.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL ItCnt = %getatr('win01': 'SF1': 'ItemCount')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SF1' GETATR 'ITEMCOUNT' ITCNT*

Capítulo 2. Atributos de componente 267

Page 286: Manual Ibm

ItemKeyDevuelve el valor de clave de un elemento de la lista. El atributo Index debe estarestablecido para indicar a qué elemento se hace referencia.

Nota: Si no hay definida ninguna clave, ItemKey devolverá una serie nula.

Tipo Serie

Se aplica a los componentes

Recuadro decombinación

Recuadro de lista

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Nota: El atributo ItemKey de recuadro de combinación puede establecerseutilizando el cuaderno de propiedades.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL keyitem = %getatr('win01': 'LB1': 'ItemKey')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' GETATR 'ITEMKEY' keyitem*

268 VisualAge RPG Manual de consulta de componentes

Page 287: Manual Ibm

LabelLa serie de texto que está asociada con un componente, como por ejemplo el textoque aparece en un pulsador.

El atributo label puede tener uno de los formatos siguientes:v Una serie tecleadav Una etiqueta de sustituciónv Un identificador de mensaje del archivo de mensajes

Si el título de una columna del contenedor tiene blancos, el contenedor no sevisualizará correctamente. Para corregir esto, sustituya todos los espacios en blancodel título por el carácter de subrayado ( _ ).

Windows visualiza la barra de título aunque se haya inhabilitado la misma en elcuaderno de propiedades. Cuando el valor de Barra de título es de noseleccionado, el usuario todavía puede desplazar la ventana utilizando el ratón enel área de la barra de título, pero tiene que cerrar la ventana utilizando el teclado.

Tipo Serie

Se aplica a los componentes

Recuadro de selección Contenedor Recuadro de grupo Opción de menúPulsador Botón de selección Texto estático Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI. Para ello, utilice la página General y especifique unvalor en el campo Etiqueta o Título.

Valor permitidoLa etiqueta del componente

Capítulo 2. Atributos de componente 269

Page 288: Manual Ibm

Ejemplo de formato libre

Cambiar la etiqueta de un pulsador:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL checked = %getatr('win01': 'CB1': 'Checked')*C checked IFEQ 0C EVAL %setatr('win01': 'PB1': 'Label') = 'No'*C ELSEC EVAL %setatr('win01': 'PB1': 'Label') = 'Yes'C ENDIF*

Ejemplo de formato fijo

Cambiar el texto de un pulsador:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'PB1' GETATR 'LABEL' OldText 2 0C 'PB1' SETATR 'Cancel' 'LABEL'*

270 VisualAge RPG Manual de consulta de componentes

Page 289: Manual Ibm

LabelPlaceIndica en qué lugar de la gráfica debe aparecer la etiqueta del dato indicado.

Este atributo no se aplica cuando la gráfica es un diagrama circular.

Tipo Numérico

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de LabelPlace puede ser uno de los siguientes:

0 El elemento de datos no debe tener ninguna etiqueta

1 La etiqueta se debe visualizar en el eje de la X

2 La etiqueta debe visualizarse por encima de la barra si el valor delelemento es positivo, y por debajo si es negativo.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('Win1': 'Gra1': 'LabelPlace') = 2*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'Gra1' SETATR 2 'LABELPLACE'*

Capítulo 2. Atributos de componente 271

Page 290: Manual Ibm

LeftEspecifica la coordenada, en pixels, desde el borde izquierdo del objeto o pantallaque contiene este componente.

Tipo Numérico

Se aplica a los componentes

ActiveX Control de animación Calendario LienzoRecuadro de selección Recuadro de

combinaciónReferencia acomponente lógico

Contenedor

Cliente DDE Campo de entrada Gráfica Pulsador gráficoRecuadro de grupo Barra de

desplazamientohorizontal

Imagen Bean Java

Recuadro de lista Medios Panel de medios Edición de múltipleslíneas

Cuaderno Interfaz ODBC/JDBC Recuadro de contorno Barra de progresoPulsador Botón de selección Graduador Selector cíclicoTexto estático Subarchivo Temporizador Barra de

desplazamientovertical

Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitidoNúmero de pixels

Ejemplo de formato libre

Mover un componente a la izquierda en su ventana:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL leftside = %getatr('win01': 'image1': 'Left')C EVAL %setatr('window': 'part': 'Left') =

leftside - 120*

Ejemplo de formato fijo

Mover un pulsador 200 pixels a la derecha:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'PB01' GETATR 'LEFT' OldLeft 2 0C OldLeft ADD 200 NewLeft 2 0C 'PB01' SETATR NewLeft 'LEFT'*

272 VisualAge RPG Manual de consulta de componentes

|||

||

|||

||

|

Page 291: Manual Ibm

LegendTypeIndica el tipo de leyenda utilizada en el componente gráfica.

Tipo Numérico

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor debe ser uno de los siguientes:

0 Sin leyenda

1 Sólo puntos

2 Sólo grupos

3 Todos los elementos

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('Win1': 'Gra': 'LegendType') = 2*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'Gra1' SETATR 2 'LegendType'*

Capítulo 2. Atributos de componente 273

Page 292: Manual Ibm

Length

Nota: Este atributo sólo se utiliza en Windows NT/95/98.

Especifica la longitud del archivo en milisegundos.

Tipo Numérico

Se aplica a los componentes

Medios

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Len = %getatr('win01': 'AUD01': 'Length')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'AUD01' GETATR 'LENGTH' Len 6 0*

274 VisualAge RPG Manual de consulta de componentes

Page 293: Manual Ibm

LineNumberDetermina en que línea insertará el atributo InsertLine una nueva línea en uncampo de edición de múltiples líneas. Este valor debe ser superior a cero e inferioro igual al atributo NbrOfLines actual. Si es mayor que el atributo NbrOfLinesactual, la nueva línea se insertará después de la última.

Tipo Numérico

Se aplica a los componentes

Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoNúmero de línea

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL oldline = %getatr('win01': 'MLE01': 'LineNumber')C EVAL %setatr('win01': 'MLE01': 'LineNumber') = 5*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE01' GETATR 'LINENUMBER' OldLine 2 0C 'MLE01' SETATR 5 'LINENUMBER'*

Capítulo 2. Atributos de componente 275

Page 294: Manual Ibm

LineTextRecupera el texto de una línea de edición de múltiples líneas especificada porLineNumber.

Tipo Serie

Se aplica a los componentes

Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor permitidoEl texto de la línea

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL lines = %getatr('win01': 'MLE1': 'NbrOfLines')C Do lines ixC EVAL %setatr('win01': 'MLE1': 'LineNumber') = ixC EVAL nextline= %getatr('win01': 'MLE1': 'LineText')C ...C EndDo*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' GETATR 'LINETEXT' line*

276 VisualAge RPG Manual de consulta de componentes

Page 295: Manual Ibm

LookNFeel

*Restricción: Este atributo es sólo de Java.

Permite que las aplicaciones Java utilicen el mecanismo PLAF (Pluggable Look andFeel) de Swing para controlar el aspecto y la funcionalidad de la interfaz gráfica deusuario.

Tipo Serie

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

El valor de LookNFeel puede ser uno de los siguientes:

Look Serie

Metal javax.swing.plaf.metal.MetalLookAndFeel

Motif com.sun.java.swing.plaf.motif.MotifLookAndFeel

Windowscom.sun.java.swing.plaf.windows.WindowsLookAndFeel

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C eval %setatr('*component':'*component':C 'LookNFeel')=C 'com.sun.java.swing.plaf.motif.' +C 'MotifLookAndFeel'*

Capítulo 2. Atributos de componente 277

Page 296: Manual Ibm

MagnifyEspecifica el valor, en forma de porcentaje, del graduador de ampliación en elcomponente imagen, que controla la escala de la imagen visualizada. El valor cerohará que la escala de la imagen se ajuste al componente imagen.

Tipo Numérico

Se aplica a los componentes

Imagen

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor del graduador de ampliación puede ser uno de los siguientes:

0 Ajustar a escala

25 - 200El valor de ampliación en forma de porcentaje

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win1': 'Img1': 'Magnify') = 50*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'IMG1' SETATR 50 'MAGNIFY'*

278 VisualAge RPG Manual de consulta de componentes

Page 297: Manual Ibm

MaskedCuando se establece este atributo, al escribir en el campo de entrada sevisualizarán caracteres asteriscos (*) en lugar de los caracteres que se estánescribiendo. Este atributo se utiliza muy a menudo cuando el usuario va a escribirdatos confidenciales, tales como una contraseña o un número de cuenta.

Tipo Numérico

Se aplica a los componentes

Campo de entrada

Códigos de operación

Operativo en tiempo de ejecución

SETATR* no

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

El estado de protección de contraseña del campo puede ser uno de lossiguientes:

0 El campo no está enmascarado

1 El campo está enmascarado

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL isMasked = %getatr('win01': 'EF1': 'Masked')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' GETATR 'MASKED' isMasked 1 0*

Capítulo 2. Atributos de componente 279

Page 298: Manual Ibm

MaximumDetermina el valor máximo que puede devolver un graduador o un selector cíclico.

Este atributo sólo está permitido para selectores cíclicos numéricos.

El valor máximo es 65535.

Tipo Numérico

Se aplica a los componentes

Graduador Selector cíclico

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoValor máximo del componente

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL oldmax=%getatr('window':'SLIDER01':'Maximum')*C EVAL %setatr('window':'SLIDER01':'Maximum')=100*

Ejemplo de formato fijo

Cambiar el valor máximo de un graduador:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SLIDER01' GETATR 'MAXIMUM' OldMax 3 0C 'SLIDER01' SETATR 100 'MAXIMUM'*

280 VisualAge RPG Manual de consulta de componentes

Page 299: Manual Ibm

MethodEspecifica el nombre del método ActiveX que se ha de invocar, junto con losvalores que se han de pasar al método. Los componentes ActiveX se controlanestableciendo sus propiedades y métodos.

Cuando se activan ciertos controles ActiveX, como por ejemplo Netscape 4.x,puede abrirse un diálogo modal de aplicación y quedar oculto tras el DiseñadorGUI o una aplicación VARPG. Téngalo presente, ya que parecerá que la aplicacióno el Diseñador GUI están bloqueados.

La sintaxis del valor de tipo serie es:nombre_método, valor1, valor2, ...

Restricción: Los únicos tipos de datos que pueden tener los parámetros de métodoy propiedad son numérico (es decir, entero y flotante) y serie (char*).Los tipos de datos Font, Color, UserDefined, PTR (puntero) no estánsoportados.

Tipo Serie

Se aplica a los componentes

ActiveX

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'AX1':'Method')='PN1'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'AX1' SETATR 'PN1' 'METHOD'*

Ejemplo de MethodEn el ejemplo siguiente, se invoca el método DisplayText de un componenteActiveX y se le pasa un único valor. Si el método espera recibir un valor numérico,se le pasa el equivalente de tipo carácter.D dspText S Inz('DisplayText,New Text')*

C 'MSCAL' Setatr dspText 'Method'

Capítulo 2. Atributos de componente 281

Page 300: Manual Ibm

MiniIconEste atributo determina la forma de presentar los iconos del componentecontenedor. Si se establece, los iconos aparecen en el componente contenedor enforma de miniiconos. Si no se establece, los iconos aparecen en su forma normal.

Tipo Numérico

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

El valor de MiniIcon puede ser uno de los siguientes:

0 Los iconos se visualizan a tamaño normal

1 Los iconos se visualizan en forma de miniiconos

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'Cont1': 'Miniicon') = 0*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'Cont1' SETATR 0 'MINIICON'*

282 VisualAge RPG Manual de consulta de componentes

Page 301: Manual Ibm

MinimumDetermina el valor mínimo que puede devolver un graduador o un selector cíclico.

Este atributo sólo está permitido para selectores cíclicos numéricos.

El valor mínimo es -32767.

Tipo Numérico

Se aplica a los componentes

Graduador Selector cíclico

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoValor mínimo del componente

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL oldmin = %getatr('window': 'SLIDER01': 'Minimum')*C EVAL %setatr('window': 'part': 'Minimum') = 0*

Ejemplo de formato fijo

Cambiar el valor mínimo de un graduador::*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SLIDER01' GETATR 'MINIMUM' OldMin 3 0C 'SLIDER01' SETATR 0 'MINIMUM'*

Capítulo 2. Atributos de componente 283

Page 302: Manual Ibm

ModeDetermina si se reproduce o no el archivo de vídeo o GIF.

Tipo Numérico

Se aplica a los componentes

Control de animación

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

El valor de Mode puede ser uno de los siguientes:

1 Empezar a reproducir el archivo

2 Parar de reproducir el archivo

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'WIN1': 'Mode') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN1' SETATR 1 'MODE'*

284 VisualAge RPG Manual de consulta de componentes

Page 303: Manual Ibm

MonthIndica el mes seleccionado actualmente. Si se establece, se actualizará la fechaseleccionada en el componente calendario para que los cambios queden reflejados.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitidoEl mes

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'Month') = 02*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' SETATR 02 'Month'*

Capítulo 2. Atributos de componente 285

Page 304: Manual Ibm

MonthArrowIndica si las flechas de mes (< o >) o de año (<< o >>) están disponibles para quelos usuarios puedan avanzar o retroceder por los meses o los años. Si no hayninguna flecha, el usuario no tiene forma de cambiar el mes o el año visualizadoactualmente.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de MonthArrow puede ser uno de los siguientes:

0 No se mostrarán las flechas

1 Se mostrarán las flechas

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL isshown = %getatr('win01': 'CAL1': 'MonthArrow')*C EVAL %setatr('win01': 'CAL1': 'MonthArrow') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' GETATR 'MONTHARROW' isshown*

286 VisualAge RPG Manual de consulta de componentes

Page 305: Manual Ibm

MonthIdxPermite que el usuario defina datos en una fecha que no se visualiza en la páginaactual del calendario.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoValor de índice

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'MonthIdx') = 2*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' SETATR 2 'MonthIdx'*

Capítulo 2. Atributos de componente 287

Page 306: Manual Ibm

MonthLenIndica el formato de visualización del nombre del mes.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

El valor de MonthLen puede ser uno de los siguientes:

1 Nombre completo

2 Nombre abreviado de tres caracteres

3 Dos dígitos

4 Dos dígitos, con un cero para los meses que sólo tienen un dígito

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'MonthLen') = 3*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' GETATR 'MONTHLEN' MonthLen 1 0*

288 VisualAge RPG Manual de consulta de componentes

Page 307: Manual Ibm

MouseIcon

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Especifica el nombre del archivo de iconos que se utilizará para la forma delpuntero del ratón. Antes de utilizar este atributo, debe establecer el valor deMouseShape en 99.

El archivo puede ser de cursor (.CUR) o de icono (.ICO o .ANI).

Tipo Serie

Se aplica a los componentes

Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'WIN1':'MouseIcon')=Myicon*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN1' SETATR MYICON 'MOUSEICON'*

Capítulo 2. Atributos de componente 289

Page 308: Manual Ibm

MouseShapeCambia la forma del puntero del ratón cuando el puntero está situado en el marcode la ventana del componente padre o de sus hijos.

Tipo Numérico

Se aplica a los componentes

Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

El valor de MouseShape puede ser uno de los siguientes:

0 Por omisión

1 Icono de flecha

2 Icono de reloj de arena

3 Icono de ″stop″ o no permitido

4 Flecha con reloj de arena (inicio de aplicación)

5 Cursor en cruz

6 Cursor en I

7 Flecha arriba

8 Flechas nordeste/sudoeste

9 Flechas norte/sur

10 Flechas noroeste/sudeste

11 Flechas este/oeste

12 Flechas para todos los puntos (norte/sur/este/oeste)

13 Cursor con forma de mano

99 Icono definido por el usuario según especifica el atributoMouseIcon. (Este valor sólo se utiliza en las aplicaciones deWindows.)

290 VisualAge RPG Manual de consulta de componentes

Page 309: Manual Ibm

El atributo MouseShape no es permanente; sólo se aplica al marco de laventana. Si modifica la forma por omisión del puntero del ratón, deberestablecer este atributo en 0 para utilizar la forma por omisión delpuntero.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('Win1': 'Win1': 'MouseShape') = 2*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'Win1' SETATR 2 'MOUSESHAPE'*

Capítulo 2. Atributos de componente 291

Page 310: Manual Ibm

MsgDataEspecifica el texto de sustitución para las variables que aparezcan en el texto delmensaje. Si hay varias variables, utilice un espacio para delimitar cada texto desustitución. Utilice el carácter de subrayado ( _ ) para incluir espacios en blancoen el texto de sustitución. Por ejemplo, para utilizar ″A B C″ y ″CustNo″ en lasvariables %1 y %2 de un mensaje respectivamente, especifique los datos delmensaje del modo siguiente:'A_B_C CustNo'

Tipo Serie

Se aplica a los componentes

*Componente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoLa serie de sustitución de la variable de mensaje

Ejemplo de formato libre

Obtener el texto del mensaje 0001 y utilizar CustNo para la sustitución:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*Component':'*Component':'MsgID')=0001C EVAL %setatr('*Component':'*Component':'MsgData')=CustNoC EVAL text = %getatr('*Component':'*Component':'MsgText')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*COMPONENT' SETATR 0001 'MSGID'C '*COMPONENT' SETATR CustNo 'MSGDATA'C '*COMPONENT' GETATR 'MSGTEXT' text*

292 VisualAge RPG Manual de consulta de componentes

Page 311: Manual Ibm

MsgFile

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Especifica el archivo de mensajes por omisión que se utilizará cuando no seencuentre un identificador de mensaje en el archivo de mensajes del componentelógico.

Tipo Serie

Se aplica a los componentes

*Componente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

Nombre completo del archivo de mensajes por omisión (archivo.txm). Seutiliza la vía de acceso actual para la búsqueda de archivos.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*Component':'*Component':'MsgFile')C = FnC EVAL Mf = %getatr('*Component':'*Component':C 'MsgFile')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*COMPONENT' SETATR Fn 'MSGFILE'*C '*COMPONENT' GETATR 'MSGFILE' Mf*

Capítulo 2. Atributos de componente 293

Page 312: Manual Ibm

MsgIDEspecifica el número de mensaje en el archivo de mensajes del componente lógico.

Tipo Numérico

Se aplica a los componentes

*Componente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl número de mensaje

Ejemplo de formato libre

Obtener el texto del mensaje 0001 y utilizar CusNo para la sustitución:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*Component':'*Component':'MsgID')=0001C EVAL %setatr('*Component':'*Component':'MsgData')=CusNoC EVAL text=%getatr('*Component':'*Component':'MsgText')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*COMPONENT' SETATR 0001 'MSGID'C '*COMPONENT' SETATR CusNo 'MSGDATA'C '*COMPONENT' GETATR 'MSGTEXT' text*

294 VisualAge RPG Manual de consulta de componentes

Page 313: Manual Ibm

MsgSubTextDefine el texto de sustitución del mensaje para un componente subarchivo demensajes. Este atributo debe estar establecido antes de añadir un mensaje a uncomponente subarchivo de mensajes mediante el atributo AddMsgID oAddMsgText. Se hace referencia al texto de sustitución de mensaje cuando unmensaje tiene variables de sustitución en el texto del mensaje. Las variables desustitución de mensaje se identifican mediante un símbolo ’%’ seguido por unvalor numérico. Cada variable de sustitución de mensaje se sustituye por lapalabra correspondiente delimitada por blancos en el atributo MsgSubText antesde añadir el mensaje al componente subarchivo de mensajes. La serie desustitución del mensaje permanece vigente hasta que se establece otro atributoMsgSubText.

Tipo Serie

Se aplica a los componentes

Subarchivo demensajes

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl texto de sustitución de mensaje

Ejemplo de formato libre

Si el mensaje 1000 fuera:Pulse %1 para continuar, %2 para cancelar

se visualizaría de este modo:Pulse Yes para continuar, No para cancelar

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'MSG1':'MsgSubText')='Yes No'C EVAL %setatr('win01':'MSG1':'AddMsgID')=1000*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MSG1' SETATR 'Yes No' 'MSGSUBTEXT'C 'MSG1' SETATR 1000 'ADDMSGID'*

Capítulo 2. Atributos de componente 295

Page 314: Manual Ibm

MsgTextDevuelve el texto del mensaje del archivo de mensajes del componente lógico parael identificador de mensaje especificado.

Tipo Serie

Se aplica a los componentes

*Componente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre

Obtener el texto del mensaje 0001:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*Component':'*Component':'MsgID')=0001C EVAL text=%getatr('*Component':'*Component':'MsgText')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*COMPONENT' SETATR 'MSGID' 0001C '*COMPONENT' GETATR 'MSGTEXT' text*

296 VisualAge RPG Manual de consulta de componentes

Page 315: Manual Ibm

MultiplierDetermina la cantidad de intervalos del temporizador que deben transcurrir antesde que el temporizador cause un evento Tick.

El valor máximo del multiplicador es 65535.

El valor mínimo del multiplicador es 1.

Tipo Numérico

Se aplica a los componentes

Temporizador

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR no

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitidoEl valor del multiplicador

Ejemplo de formato libre

Si se ha establecido el atributo Interval en 1000 milisegundos, eltemporizador generará un evento Tick cada tres segundos:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'TIMER01': 'Multiplier') = 3*

Ejemplo de formato fijo

Cambiar el atributo Multiplier de un temporizador:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'TIMER01' SETATR 3 'MULTIPLIER'*

Capítulo 2. Atributos de componente 297

Page 316: Manual Ibm

MultSelectDetermina si puede haber más de un elemento seleccionado en la parte de lista deun componente. Cuando no se ha establecido este atributo, al seleccionar unelemento se deselecciona cualquier elemento seleccionado actualmente.

Este atributo debe estar establecido para que el recuadro de lista permita laselección ampliada proporcionada por el atributo ExtSelect.

El atributo MultSelect no tiene ningún efecto en el atributo ExtSelect. El atributoExtSelect prevalece sobre los valores para MultSelect o para una única selección.

Tipo Numérico

Se aplica a los componentes

Recuadro de lista Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor permitido

El estado de selección múltiple puede ser uno de los siguientes:

0 Sólo se puede seleccionar un elemento

1 Se pueden seleccionar varios elementos

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL rc = %getatr('win01': 'LB1': 'MultSelect')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' GETATR 'MULTSELECT' rc 1 0*

298 VisualAge RPG Manual de consulta de componentes

Page 317: Manual Ibm

NameDevuelve el nombre del componente lógico.

Tipo Serie

Se aplica a los componentes

*Componente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre

Obtener el nombre del componente lógico:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL appname=%getatr('*Component':'*Component':'Name')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*COMPONENT' GETATR 'NAME' appname*

Capítulo 2. Atributos de componente 299

Page 318: Manual Ibm

NbrOfImage

*Restricción: Este atributo es sólo de Java.

Establece el número de imágenes que se reproducen en una secuencia deanimación GIF. Utilice este atributo junto con los atributos FileName y Mode.

Por ejemplo, para reproducir un archivo base Archivo.GIF como una secuencia de10 imágenes, debe establecer FileName en Archivo.GIF, NbrOfImage en 10 yMode en 1. También, puede reproducir varias imágenes GIF distintas, comoArchivo1.GIF, Archivo2.GIF, ... Archivo10.GIF.

Tipo Numérico

Se aplica a los componentes

Control de animación

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl número de imágenes que se reproducen.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'WIN1':'NbrOfImage')=10*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN1' SETATR 1 'NBROFIMAGE'*

300 VisualAge RPG Manual de consulta de componentes

Page 319: Manual Ibm

NbrOfLinesDevuelve el número de líneas del campo de edición de múltiples líneas. Si estávacío, se devuelve el valor cero.

Tipo Numérico

Se aplica a los componentes

Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL NumL = %getatr('win01': 'MLE1': 'NbrOfLines')*

Ejemplo de formato fijo

Obtener el número de líneas de un campo de edición de múltiples líneas:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' GETATR 'NBROFLINES' NumL 2 0*

Capítulo 2. Atributos de componente 301

Page 320: Manual Ibm

NbrOfSelDevuelve el número de elementos seleccionados en la parte de lista de uncomponente.

Si no hay ningún elemento seleccionado actualmente, se devuelve el valor cero.

Tipo Numérico

Se aplica a los componentes

Recuadro de lista Subarchivo demensajes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre

Obtener el número de elementos seleccionados en un recuadro de lista:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL num=%getatr('win01':'LB1':'NbrOfSel')*C num IFEQ *ZEROC EVAL %setatr('win01':'MSG1':'AddMsgText')='None'C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' GETATR 'NBROFSEL' NbrSelected 2 0*

302 VisualAge RPG Manual de consulta de componentes

Page 321: Manual Ibm

NextLineSi este atributo se establece en 1, el graduador de la barra de desplazamiento setraslada a una posición que representa la siguiente línea dentro de una lista deelementos. El movimiento descrito por el graduador es relativo al atributo Rangeestablecido para el componente barra de desplazamiento.

Por ejemplo, supongamos que tiene un componente subarchivo y desea indicardónde se halla un usuario dentro de un conjunto de registros cuando se pulsa unatecla de movimiento del cursor o de mandato. El componente barra dedesplazamiento conectado a un subarchivo indica únicamente dónde se encuentrael usuario tomando como base el número de registros que hay actualmente en elsubarchivo. Al capturar el evento VKeyPress, se puede establecer el atributo degraduador pertinente. Cuando el graduador queda situado en su nueva posición,se señala un evento Scroll y se actualiza el atributo del evento %Position.

El atributo PageSize determina el tamaño de página visible de los elementosvisualizados. El atributo Range determina el límite superior correspondiente alnúmero de elementos por los que se pasará al realizar el desplazamiento.

Tipo Numérico

Se aplica a los componentes

Barra dedesplazamientohorizontal

Barra dedesplazamientovertical

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'VSC1':'NextLine')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'VSC1' SETATR 1 'NEXTLINE'*

Capítulo 2. Atributos de componente 303

Page 322: Manual Ibm

NextPageSi este atributo se establece en 1, el graduador de la barra de desplazamiento setraslada a una posición que representa la siguiente página dentro de una lista deelementos. El movimiento descrito por el graduador es relativo al atributo Rangeestablecido para el componente barra de desplazamiento.

Por ejemplo, supongamos que tiene un componente subarchivo y desea indicardónde se halla un usuario dentro de un conjunto de registros cuando se pulsa unatecla de movimiento del cursor o de mandato. El componente barra dedesplazamiento conectado a un subarchivo indica únicamente dónde se encuentrael usuario tomando como base el número de registros que hay actualmente en elsubarchivo. Al capturar el evento VKeyPress, se puede establecer el atributo degraduador pertinente. Cuando el graduador queda situado en su nueva posición,se señala un evento Scroll y se actualiza el atributo del evento %Position.

El atributo PageSize determina el tamaño de página visible de los elementosvisualizados. El atributo Range determina el límite superior correspondiente alnúmero de elementos por los que se pasará al realizar el desplazamiento.

Tipo Numérico

Se aplica a los componentes

Barra dedesplazamientohorizontal

Barra dedesplazamientovertical

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'VSC1':'NextPage')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'VSC1' SETATR 1 'NEXTPAGE'*

304 VisualAge RPG Manual de consulta de componentes

Page 323: Manual Ibm

NotSrcEvtUtilice este atributo, junto con los atributos NotSrcPart y NotSrcWin, para que elcomponente referencia a componente lógico supervise la aparición de un eventoespecífico en un componente determinado de una ventana en particular de otrocomponente lógico. Este atributo se utiliza para identificar el evento que desea.Utilice NotSrcPart y NotSrcWin para especificar el componente y la ventanadeterminados que desea supervisar para la aparición de ese evento.

Tipo Serie

Se aplica a los componentes

Referencia acomponente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL event = %getatr('win01': 'CR1': 'NotSrcEvt')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CR1' GETATR 'NOTSRCEVT' event*

Capítulo 2. Atributos de componente 305

Page 324: Manual Ibm

NotSrcPartUtilice este atributo, junto con los atributos NotSrcEvt y NotSrcWin, para que elcomponente referencia a componente lógico supervise la aparición de un eventoespecífico en un componente determinado de una ventana en particular de otrocomponente lógico. Este atributo se utiliza para identificar el componente quedesea. Utilice NotSrcEvt y NotSrcWin para especificar el evento que deseasupervisar para ese componente y la ventana en la que se encuentra elcomponente.

Tipo Serie

Se aplica a los componentes

Referencia acomponente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL PartN = %getatr('win1': 'CR1': 'NotSrPart')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CR1' GETATR 'NOTSRCPART' PartN*

306 VisualAge RPG Manual de consulta de componentes

Page 325: Manual Ibm

NotSrcWinUtilice este atributo, junto con los atributos NotSrcEvt y NotSrcPart, para que elcomponente referencia a componente lógico supervise la aparición de un eventoespecífico en un componente determinado de una ventana en particular de otrocomponente lógico. Este atributo se utiliza para identificar la ventana que desea.Utilice NotSrcPart y NotSrcEvt para especificar el componente y el evento quedesea supervisar en dicha ventana.

Tipo Serie

Se aplica a los componentes

Referencia acomponente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL WinNam = %getatr('win1': 'CR1': 'NotSrcWin')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CR1' GETATR 'NotSrcWin' WinNam*

Capítulo 2. Atributos de componente 307

Page 326: Manual Ibm

OCXPropDetermina el nombre de la propiedad. Este nombre se utiliza para determinar elvalor de propiedad con el atributo OCXValue.

Tipo Serie

Se aplica a los componentes

ActiveX

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'AX1':'OCXProp')='PN1'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'AX1' SETATR 'PN1' 'OCXPROP'*

308 VisualAge RPG Manual de consulta de componentes

Page 327: Manual Ibm

OCXValueDetermina el valor de la propiedad según proporciona el atributo OCXProp.

Tipo Serie

Se aplica a los componentes

ActiveX

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'AX1':'OCXValue')='VL1'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'AX1' SETATR 'VL1' 'OCXVALUE'*

Capítulo 2. Atributos de componente 309

Page 328: Manual Ibm

OpenEditDetermina si se puede editar un campo de entrada de un registro de subarchivo.Antes de establecer este atributo, debe establecer los atributos ColNumber e Index.

El valor devuelto por el atributo OpenEdit indica si hay algún campo delsubarchivo abierto en este momento para su edición. Por consiguiente, no esnecesario establecer primero los atributos ColNumber e Index antes de obtenereste atributo.

Cuando el atributo OpenEdit está establecido en 0, se cierran todos los camposabiertos actualmente para edición. Los atributos ColNumber e Index se pasan poralto.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

OpenEdit puede tener uno de los siguientes valores:

0 El campo no se puede editar

1 El campo se puede editar

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL isopen = %getatr('win01': 'SF1': 'OpenEdit')*C EVAL %setatr('win01': 'SF1': 'OpenEdit') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SF1' GETATR 'OPENEDIT' isopen*

310 VisualAge RPG Manual de consulta de componentes

Page 329: Manual Ibm

OSDevuelve el nombre del sistema operativo.

Tipo Serie

Se aplica a los componentes

*Componente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor devuelto

Sistema operativo WINDOWS: Windows NT, Windows 95 o Windows 98

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL ostring=%getatr('*Component':'*Component':'Os')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*COMPONENT' GETATR 'OS' ostring*

Capítulo 2. Atributos de componente 311

Page 330: Manual Ibm

OutlineRclIndica si hay o no un rectángulo bordeando la fecha YearIdx/MonthIdx/DayIdx.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

OutlineRcl puede tener uno de los siguientes valores:

0 No hay ningún rectángulo

1 Hay un rectángulo

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'OutlineRcl') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' SETATR 1 'OUTLINERCL'*

312 VisualAge RPG Manual de consulta de componentes

Page 331: Manual Ibm

PageNumberDetermina qué número de página está seleccionado actualmente.

Tipo Numérico

Se aplica a los componentes

Cuaderno

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoEl número de página seleccionado actualmente

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'NB1': 'PageNumber') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'NB1' SETATR 1 'PAGENUMBER'*

Capítulo 2. Atributos de componente 313

Page 332: Manual Ibm

PageSizePara un componente subarchivo, indica el número de filas de datos visibles. Esteatributo es útil si desea efectuar el proceso página a página.

Para un componente barra de desplazamiento horizontal o vertical, determina eltamaño de página visible. El valor de PageSize no puede sobrepasar el valor deRange.

Tipo Numérico

Se aplica a los componentes

Barra dedesplazamientohorizontal

Barra dedesplazamientovertical

Subarchivo*

* Restricción: Este atributo sólo se puede obtener en tiempo de ejecuciónpara el componente subarchivo.

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

Para un componente barra de desplazamiento horizontal o vertical, el valorde PageSize puede estar entre 1 y 32.767. No puede sobrepasar el valor deRange.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL PS = %getatr('win01':'SFL1':'PageSize')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' GETATR 'PAGESIZE' PS*

314 VisualAge RPG Manual de consulta de componentes

Page 333: Manual Ibm

Panel

Nota: Este atributo sólo se utiliza en Windows NT/95/98.

En el componente imagen, panel determina si el componente tiene un panel deampliación asociado. El panel de ampliación contiene dos controles que permitenla manipulación de la imagen:

Recuadro de selección Ajustar escalaCuando este recuadro de selección no está marcado, la imagen se ajustaproporcionalmente para encajar en el componente imagen. Cuando estámarcado, se habilita el graduador de ampliación.

Graduador de ampliaciónCuando está habilitado, este graduador ajusta la ampliación de la imagen entreun 25% y un 200% de su tamaño original.

En el componente medios, panel se utiliza para mostrar un panel de medios parareproducir archivos.

Tipo Numérico

Se aplica a los componentes

Imagen Medios

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Capítulo 2. Atributos de componente 315

Page 334: Manual Ibm

Valor permitido

Uno de los siguientes:

0 No se conecta el panel de ampliación o se oculta el panel dereproducción.

1 Se conecta el panel de ampliación o se muestra el panel dereproducción.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL oldval = %getatr('window': 'MMP1': 'Panel')*C EVAL %setatr('window': 'MMP1': 'Panel') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MMP1' GETATR 'PANEL' OldVal 1 0C 'MMP1' SETATR 1 'PANEL'*

316 VisualAge RPG Manual de consulta de componentes

Page 335: Manual Ibm

PanelItemDevuelve un valor que indica el último botón que se ha cambiado en un panel demedios. Un botón se puede cambiar pulsando sobre el mismo con el ratón oestableciendo el atributo PanelMode. Puede establecer la verificación de esteatributo cuando el usuario haya pulsado uno de los botones del panel de medios.De este modo se producirá un evento Press. A continuación puede utilizar elatributo PanelItem de la subrutina de acción Press para determinar la función quedebe llevarse a cabo.

Tipo Numérico

Se aplica a los componentes

Panel de medios

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor devuelto

Estado del último botón del panel de medios que se ha pulsado:

0 No se ha pulsado ningún botón

1 Pause (Pausa)

2 Play (Reproducir)

3 Grabar

4 Stop (Parar)

5 Pista siguiente

6 Pista anterior

7 Índice siguiente

8 Índice anterior

9 Volumen

10 Posición

Capítulo 2. Atributos de componente 317

Page 336: Manual Ibm

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL button = %getatr('win01': 'MMP1': 'PanelItem')*C button CASEQ 2 PLAYC button CASEQ 3 RECORDC ...C ENDCS*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MMP1' GETATR 'PANELITEM' button 2 0*C button CASEQ 2 PLAYC button CASEQ 3 RECORDC ...C ENDCS*

318 VisualAge RPG Manual de consulta de componentes

Page 337: Manual Ibm

PanelModeEstablece la modalidad operativa para el componente panel de medios.

Tipo Numérico

Se aplica a los componentes

Panel de medios

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

La modalidad operativa de un componente panel de medios puede ser:

1 Pause (Pausa)

2 Play (Reproducir)

3 Grabar

4 Stop (Parar)

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'MMP1': 'PanelMode') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MMP1' SETATR 1 'PANELMODE'*

Capítulo 2. Atributos de componente 319

Page 338: Manual Ibm

ParentEstablece el componente padre cuya lista de hijos ha de recuperarse mediante elatributo PartList. Se devolverá la lista de hijos inmediatos. Para obtener la lista deventanas de un componente lógico, establezca el atributo Parent con el nombrereservado *component.

Nota: Este atributo debe establecerse antes de utilizar PartCount o PartList.

Tipo Serie

Se aplica a los componentes

*Componente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoEl formato del nombre de componente padre es:PARENTNAME|PARTNAME

ParentName es el nombre del componente ventana propietario dePartName. Si desea obtener una lista de los componentes de una ventana,utilice el nombre del componente lienzo como nombre del componentepadre.

320 VisualAge RPG Manual de consulta de componentes

Page 339: Manual Ibm

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*component':'*component':'Parent')C = 'WIN1|CANVS1'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' SETATR 'WIN1|CANVS1' 'PARENT'*

Si desea obtener un nombre de lienzo desde un componente ventana padre, deberáespecificar dos veces el nombre de la ventana. El siguiente ejemplo de códigomuestra cómo hacerlo. (La variable WinName contiene el nombre de la ventanapadre).*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----** Establecer la ventana como el padre; entrar dos veces el

nombre de la ventana.C EVAL %setatr('*component':'*component':'Parent')C = WinName + '|' + WinName** Obtener PartList, que ahora tiene el nombre de la ventana, y

asignarlo a la variable Canvas.C EVALCanvas=%getatr('*component':'*component':'PartList')

Consulte la descripción de PartList para obtener información sobre los valoresdevueltos por este atributo.

Capítulo 2. Atributos de componente 321

Page 340: Manual Ibm

ParentIdDevuelve el ID del registro padre de un registro de un contenedor. Antes deutilizar este atributo, establezca el atributo RecordID en el ID del registro cuyo IDde padre desea determinar.

Tipo Serie

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre

En el ejemplo siguiente, se supone que se ha seleccionado un registro. Sedeterminará cuál es el ID del registro padre del registro seleccionado.*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----CSRN01Factor1+++++++Opcode(E)+Extended-factor2+++++++++++++++++++++++++----* Establecer el ID del registro seleccionadoC EVAL %setatr('Main':'CT1':'RecordID')=C %getatr('Main':'CT1':'FirstSel')* Obtener el ID del registro padre del registro seleccionadoC EVAL Parent=%getatr('Main':'CT1':'ParentId')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CT1' GETATR 'FIRSTSEL' ID 4 0C 'CT1' SETATR ID 'RECORDID'C 'CT1' GETATR 'PARENTID' PARENT 4 0*

322 VisualAge RPG Manual de consulta de componentes

Page 341: Manual Ibm

ParentListDevuelve la lista, delimitada con blancos, de los ID de padre del registro actual.Antes de utilizar este atributo, establezca el atributo RecordID en el ID del registroactual.

Tipo Serie

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre

En el ejemplo siguiente, se supone que se ha seleccionado un registro. Sedeterminará cuál es el ID de registro del registro seleccionado.*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----CSRN01Factor1+++++++Opcode(E)+Extended-factor2+++++++++++++++++++++++++----* Establecer el ID del registro seleccionadoC EVAL %setatr('Main':'CT1':'RecordID')=C %getatr('Main':'CT1':'FirstSel')* Obtener la lista de los ID de padre del registro seleccionadoC EVAL ParentL=%getatr('Main':'CT1':'ParentList')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CT1' GETATR 'FIRSTSEL' ID 4 0C 'CT1' SETATR ID 'RECORDID'C 'CT1' GETATR 'PARENTLIST' PARENTL 4 0*

Capítulo 2. Atributos de componente 323

|

|||

||

|

||||||

|

|||

||

|||

|

||

|||||||||

|

|||||||

|

Page 342: Manual Ibm

ParentNameDevuelve el nombre del componente que contiene el componente al que elparámetro part hace referencia. En el caso de los componentes que están en unaventana, se devuelve el nombre de ésta. Cuando utilice este atributo para uncomponente ventana, se devolverá el nombre del componente ventana.

Tipo Serie

Se aplica a los componentes

Todos los componentes excepto el componente *component

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL PName = %getatr('win01': 'EF1': 'ParentName')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' GETATR 'PARENTNAME' PName 1 0*

324 VisualAge RPG Manual de consulta de componentes

Page 343: Manual Ibm

PartCountDevuelve el número de hijos del componente padre establecido por el atributoParent.

Tipo Numérico

Se aplica a los componentes

*Componente lógico Bean Java

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor permitidoEl número de hijos del componente padre especificado.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Numchild=%getatr('*component':'*component':C 'PartCount')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' GETATR 'PARTCOUNT' Numchild*

Capítulo 2. Atributos de componente 325

Page 344: Manual Ibm

PartListDevuelve una lista de los componentes hijo del componente padre que haestablecido el atributo Parent.

Tipo Serie

Se aplica a los componentes

*Componente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor devueltoEl formato de la serie es una serie continua de nombres de componente. Elnombre de cada uno de los componentes es una serie fija de 10 caracteresde longitud. Si una parte del nombre de componente tiene menos de 10caracteres, el nombre se rellena por la derecha con espacios en blanco.FRAMEbbbbbCANVASbbbbENTRYFIELD

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL list = %getatr('*component': '*component':C 'PartList')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' GETATR 'PARTLIST' list*

326 VisualAge RPG Manual de consulta de componentes

Page 345: Manual Ibm

PartNameDevuelve el nombre del componente. Es el nombre que se asignó al componentecuando se creó por primera vez utilizando el valor del cuaderno.

La longitud del valor del nombre es de 10 caracteres. Se devolverá en el campo deresultado justificado por la izquierda. Si el campo de resultado tiene menos de 10caracteres, el valor del nombre se truncará. Si tiene más de 10 caracteres, el campose rellena con espacios en blanco.

Tipo Serie

Se aplica a los componentes

Todos los componentes excepto el componente *component

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL ctlname = %getatr('win01': 'MLE1': 'PartName')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' GETATR 'PARTNAME' ctlname 10*

Capítulo 2. Atributos de componente 327

Page 346: Manual Ibm

PartTypeDevuelve el tipo del componente. El valor devuelto para un componente VARPGtiene como prefijo los caracteres FVDES. Por ejemplo, el valor devuelto para uncomponente campo de entrada es FVDESEntryField.

Nota: Para un componente referencia a componente lógico, el valor devuelto tienecomo prefijo los caracteres FVDESV.

Tipo Serie

Se aplica a los componentes

Todos los componentes excepto el componente *component

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Type = %getatr('win01': 'MLE1': 'PartType')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' GETATR 'PARTTYPE' Type 50*

328 VisualAge RPG Manual de consulta de componentes

Page 347: Manual Ibm

PastePega el texto del portapapeles en la posición del cursor. Si hay un textoseleccionado, se sustituirá por el texto del portapapeles.

Tipo Numérico

Se aplica a los componentes

Campo de entrada Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl valor permitido es 1

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'MLE1': 'Paste') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' SETATR 1 'paste'*

Capítulo 2. Atributos de componente 329

Page 348: Manual Ibm

PBRangeDetermina el rango superior de la barra de progreso. El valor por omisión es 100.Este valor puede representar el límite superior del proceso que el programa estásupervisando. Por ejemplo, si el programa está subiendo 1.000 archivos, puedeinteresarle establecer el rango superior en 1.000 para este proceso.

Tipo Numérico

Se aplica a los componentes

Barra de progreso Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----** Establecer el rango de una barra de progreso conectada a una ventanaC EVAL %setatr('win01':'WIN1':'PBRange')=1000* Establecer el rango de un componente barra de progresoC EVAL %setatr('win01':'PBar1':'PBRange')=1000

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----** Establecer el rango de una barra de progreso conectada a una ventanaC 'WIN1' SETATR 1000 'PBRANGE'* Establecer el rango de un componente barra de progresoC 'PBAR1' SETATR 1000 'PBRANGE'

330 VisualAge RPG Manual de consulta de componentes

Page 349: Manual Ibm

PBSetPosMueve el indicador de barra de progreso a la posición absoluta especificada. Estevalor depende de cómo se ha establecido el valor del atributo PBRange.

Tipo Numérico

Se aplica a los componentes

Barra de progreso Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'WIN1':'PBSetPos')=50*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN1' SETATR 50 'PBSETPOS'*

Capítulo 2. Atributos de componente 331

Page 350: Manual Ibm

PBStepEstablezca este atributo en 1 para mover el indicador de barra de progreso elnúmero de unidades de pasos definido en el valor de PBStepSize.

Tipo Numérico

Se aplica a los componentes

Barra de progreso Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'WIN1':'PBStep')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN1' SETATR 1 'PBSTEP'*

332 VisualAge RPG Manual de consulta de componentes

Page 351: Manual Ibm

PBStepSizeDetermina la posición máxima a la que se mueve el indicador de barra de progresocuando el atributo PBStep está activado. El valor por omisión es 10.

Tipo Numérico

Se aplica a los componentes

Barra de progreso Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'WIN1':'PBStepSize')=10*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN1' SETATR 10 'PBSTEPSIZE'*

Capítulo 2. Atributos de componente 333

Page 352: Manual Ibm

PlatformDevuelve el nombre de la plataforma en la que se está ejecutando la aplicación.

Tipo Serie

Se aplica a los componentes

*Componente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor devueltoUno de los siguientes:

WINDOWSWindows

JAVA Java

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL app1=%getatr('*Component':'*Component':'Platform')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*COMPONENT' GETATR 'PLATFORM' APP1*

334 VisualAge RPG Manual de consulta de componentes

Page 353: Manual Ibm

PlugCmd*Restricciones:

1. Este atributo no está soportado en las aplicaciones Java.2. Este atributo sólo se aplica a los conectores escritos en VisualAge RPG.

Transfiere un mandato al componente lógico Conector del Diseñador GUI. Losatributos PlugDLL y PlugID deben estar establecidos antes de utilizar PlugCmd.

Tipo Serie

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl mandato de conector

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*component': '*component': 'PlugCmd')C = cmdstring*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' SETATR cmdstring 'PLUGCMD'*

Capítulo 2. Atributos de componente 335

Page 354: Manual Ibm

PlugDLL*Restricciones:

1. Este atributo no está soportado en las aplicaciones Java.2. Este atributo sólo se aplica a los conectores escritos en VisualAge RPG.

Establece el nombre de la DLL del conector. Los atributos PlugDLL y PlugIDdeben estar establecidos antes de utilizar PlugCmd.

Tipo Serie

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoNombre de la DLL del conector

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*component': '*component': 'PlugDLL')C = PlugDLL*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' SETATR DLLname 'PLUGDLL'*

336 VisualAge RPG Manual de consulta de componentes

Page 355: Manual Ibm

PlugID*Restricciones:

1. Este atributo no está soportado en las aplicaciones Java.2. Este atributo sólo se aplica a los conectores escritos en VisualAge RPG.

Establece el ID del Diseñador GUI que se pasa al conector. Los atributos PlugDLLy PlugID deben estar establecidos antes de utilizar PlugCmd.

Tipo Serie

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoID del Diseñador GUI

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*component': '*component': 'PlugID')C = idname*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' SETATR idname 'PLUGID'*

Capítulo 2. Atributos de componente 337

Page 356: Manual Ibm

PlugRC*Restricciones:

1. Este atributo no está soportado en las aplicaciones Java.2. Este atributo sólo se aplica a los conectores escritos en VisualAge RPG.

Obtiene el código de retorno del último mandato del conector.

Tipo Numérico

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL code = %getatr('*component': '*component':C 'PlugRC')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' GETATR 'PLUGRC' code 2 0*

338 VisualAge RPG Manual de consulta de componentes

Page 357: Manual Ibm

PlugResult*Restricciones:

1. Este atributo no está soportado en las aplicaciones Java.2. Este atributo sólo se aplica a los conectores escritos en VisualAge RPG.

Obtiene la serie del resultado del último mandato del conector.

Tipo Serie

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Result = %getatr('*component': '*component':C 'PlugResult')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' GETATR 'PLUGRESULT' Result*

Capítulo 2. Atributos de componente 339

Page 358: Manual Ibm

PokeEnvía datos a la aplicación del servidor. Para transferir datos a una aplicación delservidor, debe haberse iniciado satisfactoriamente una conversación DDE para elcomponente DDE. Asimismo, debe haberse establecido el atributo DDEItem paraindicar el elemento del servidor que recibirá los datos transferidos.

Cuando la aplicación del servidor procese la solicitud Poke, responderá con unevento PokeAck. Debe comprobar el atributo %PokeAck en la subrutina de acciónPokeAck para determinar si la operación Poke se ha completado de manerasatisfactoria o no.

Tipo Serie

Se aplica a los componentes

Cliente DDE

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'DDE1': 'DDEItem') = 'A1'C EVAL %setatr('win01': 'DDE1': 'Poke') = '456.78'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'DDE1' SETATR '123' 'POKE'*

340 VisualAge RPG Manual de consulta de componentes

Page 359: Manual Ibm

PositionEl valor devuelto para este atributo depende del tipo del componente.

En el caso de un componente medios, devolverá la posición actual del archivo deaudio. Este valor se proporciona en milisegundos. Si aún no se ha procesado elarchivo de audio, se devolverá el valor cero.

Para un componente panel de medios, devolverá la posición del graduador. Estevalor se sitúa entre 0 y 100.

Para un componente barra de desplazamiento horizontal o vertical, este atributodevolverá la posición del recuadro de desplazamiento en función del valor delatributo Range.

Tipo Numérico

Se aplica a los componentes

Barra dedesplazamientohorizontal

Medios Panel de medios Barra dedesplazamientovertical

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

Para un componente panel de medios, el valor de Position, entre 0 y 100,representa un porcentaje. Para un componente barra de desplazamientohorizontal o vertical, se trata de un valor absoluto basado en el valor deRange.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL oldpos = %getatr('win01': 'MMP1': 'Position')*C EVAL %setatr('win01': 'MMP1': 'Position') = 5*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MMP1' GETATR 'POSITION' OldPos 3 0*C 'MMP1' SETATR 5 'POSITION'*

Capítulo 2. Atributos de componente 341

Page 360: Manual Ibm

PrevLineSi este atributo se establece en 1, el graduador de la barra de desplazamiento setraslada a una posición que representa la línea anterior dentro de una lista deelementos. El movimiento descrito por el graduador es relativo al atributo Rangeestablecido para el componente barra de desplazamiento.

Por ejemplo, supongamos que tiene un componente subarchivo y desea indicardónde se halla un usuario dentro de un conjunto de registros cuando se pulsa unatecla de movimiento del cursor o de mandato. El componente barra dedesplazamiento conectado a un subarchivo indica únicamente dónde se encuentrael usuario tomando como base el número de registros que hay actualmente en elsubarchivo. Al capturar el evento VKeyPress, se puede establecer el atributo degraduador pertinente. Cuando el graduador queda situado en su nueva posición,se señala un evento Scroll y se actualiza el atributo del evento %Position.

El atributo PageSize determina el tamaño de página visible de los elementosvisualizados. El atributo Range determina el límite superior correspondiente alnúmero de elementos por los que se pasará al realizar el desplazamiento.

Tipo Numérico

Se aplica a los componentes

Barra dedesplazamientohorizontal

Barra dedesplazamientovertical

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'VSC1':'PrevLine')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'VSC1' SETATR 1 'PREVLINE'*

342 VisualAge RPG Manual de consulta de componentes

Page 361: Manual Ibm

PrevPageSi este atributo se establece en 1, el graduador de la barra de desplazamiento setraslada a una posición que representa la página anterior dentro de una lista deelementos. El movimiento descrito por el graduador es relativo al atributo Rangeestablecido para el componente barra de desplazamiento.

Por ejemplo, supongamos que tiene un componente subarchivo y desea indicardónde se halla un usuario dentro de un conjunto de registros cuando se pulsa unatecla de movimiento del cursor o de mandato. El componente barra dedesplazamiento conectado a un subarchivo indica únicamente dónde se encuentrael usuario tomando como base el número de registros que hay actualmente en elsubarchivo. Al capturar el evento VKeyPress, se puede establecer el atributo degraduador pertinente. Cuando el graduador queda situado en su nueva posición,se señala un evento Scroll y se actualiza el atributo del evento %Position.

El atributo PageSize determina el tamaño de página visible de los elementosvisualizados. El atributo Range determina el límite superior correspondiente alnúmero de elementos por los que se pasará al realizar el desplazamiento.

Tipo Numérico

Se aplica a los componentes

Barra dedesplazamientohorizontal

Barra dedesplazamientovertical

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'VSC1':'PrevPage')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'VSC1' SETATR 1 'PREVPAGE'*

Capítulo 2. Atributos de componente 343

Page 362: Manual Ibm

PrintPermite que se imprima la imagen o el área de cliente de la ventana. El valor detipo serie representa el nombre y el título del trabajo. Si se establecer este atributo,se visualizará el diálogo de impresión de Windows a fin de que el usuario puedaelegir el tipo de impresora.

Tipo Serie

Se aplica a los componentes

Imagen Ventana Ventana con lienzo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'ima2':'Print')='Image2'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN01' SETATR 'IMAGE2' 'PRINT'*

344 VisualAge RPG Manual de consulta de componentes

Page 363: Manual Ibm

Printer

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Devuelve el nombre de impresora seleccionado en el diálogo de impresora. Eldiálogo de impresora del sistema Windows se visualiza estableciendo el atributoSelPrinter.

Tipo Serie

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL prtname = %getatr('*component': '*component':C 'Printer')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' GETATR 'PRINTER' prtname*

Capítulo 2. Atributos de componente 345

Page 364: Manual Ibm

ProgresBarAñade o elimina una barra de progreso simple en una ventana como unaextensión. Si hay una ventana de estado, la barra de progreso se colocará en laposición opuesta de la ventana. Utilice el componente barra de progreso si necesitauna barra de progreso más variada.

Tipo Numérico

Se aplica a los componentes

Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

El valor de ProgresBar puede ser uno de los siguientes:

1 Crear una barra de progreso

0 Eliminar una barra de progreso

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'WIN1':'ProgresBar')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN1' SETATR 1 'PROGRESBAR'*

346 VisualAge RPG Manual de consulta de componentes

Page 365: Manual Ibm

RangeDetermina el límite superior del rango de los elementos por los que se desplaza.Este valor puede representar el número de elementos que se visualizan en unalista. Por ejemplo, si el programa visualiza una lista de 100 archivos, puedeinteresarle establecer el rango superior en 100.

El atributo PageSize determina el tamaño de página visible de los elementosvisualizados.

Tipo Numérico

Se aplica a los componentes

Barra dedesplazamientohorizontal

Barra dedesplazamientovertical

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

Range puede tener un valor entre 1 y 32.767.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'HScroll1':'Range')=100*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'HSCROLL1' SETATR 100 'RANGE'*

Capítulo 2. Atributos de componente 347

Page 366: Manual Ibm

ReadOnlyDetermina si la parte del campo de entrada de un componente es de sólo lectura.Cuando se ha establecido para sólo lectura, no se permite escribir en el campo deentrada.

Cuando este atributo se aplica al componente lienzo, todos los campos de entradadel lienzo heredarán el valor del atributo ReadOnly.

Tipo Numérico

Se aplica a los componentes

Lienzo Recuadro decombinación

Contenedor Campo de entrada

Edición de múltipleslíneas

Selector cíclico

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Se puede establecer utilizando el cuaderno de propiedades en elDiseñador GUI, excepto en el caso de un componente contenedor.En el caso de un componente recuadro de combinación, seleccioneun tipo de Lista desplegable para el estilo del recuadro decombinación. Para otros componentes, seleccione el estilo Sólolectura.

Valor permitido

El estado ReadOnly del campo puede ser:

0 El campo de entrada no es de sólo lectura

1 El campo de entrada es de sólo lectura

348 VisualAge RPG Manual de consulta de componentes

Page 367: Manual Ibm

Ejemplo de formato libre

Conmutar el estado de sólo lectura de un campo de entrada:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL rc = %getatr('win01': 'EF1': 'ReadOnly')*C rc IFEQ 1C EVAL %setatr('win01': 'EF1': 'ReadOnly') = 0C ELSEC EVAL %setatr('win01':'EF1': 'ReadOnly') = 1C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' GETATR 'READONLY' rc 1 0*C rc IFEQ 1C 'EF1' SETATR 0 'READONLY'C ELSEC 'EF1' SETATR 1 'READONLY'C ENDIF*

Capítulo 2. Atributos de componente 349

Page 368: Manual Ibm

RecordIDEstablece la identificación de un registro de contenedor al que otros atributoshacen referencia. Por ejemplo, antes de utilizar el atributo GetRcdFld, debeestablecer primero el atributo RecordID.

Tipo Numérico

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoEl identificador del registro de contenedor

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CN1': 'RecordID') = id*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' SETATR id 'RECORDID'*

350 VisualAge RPG Manual de consulta de componentes

Page 369: Manual Ibm

RefAttrEs el atributo del componente al que se hace referencia en un componentereferencia a componente lógico.

Tipo Serie

Se aplica a los componentes

Referencia acomponente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'COMP1': 'RefAttr') = 'Text'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'COMP1' SETATR 'Text' 'REFATTR'*

Capítulo 2. Atributos de componente 351

Page 370: Manual Ibm

RefParentNombre de la ventana padre del componente destino.

Tipo Serie

Se aplica a los componentes

Referencia acomponente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'COMP1': 'RefParent')C = 'WIN01'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'COMP1' SETATR 'WIN01' 'REFPARENT'*

352 VisualAge RPG Manual de consulta de componentes

Page 371: Manual Ibm

RefPartNombre del componente situado en el componente lógico destino al que se hacereferencia.

Tipo Serie

Se aplica a los componentes

Referencia acomponente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('window': 'COMP1': 'RefPart') = 'EF01'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'COMP1' SETATR 'EF01' 'REFPART'*

Capítulo 2. Atributos de componente 353

Page 372: Manual Ibm

RefreshHace que el componente se dibuje de nuevo.

Tipo Numérico

Se aplica a los componentes

ActiveX Calendario Lienzo Recuadro de selecciónRecuadro decombinación

Contenedor Campo de entrada Gráfica

Pulsador gráfico Recuadro de grupo Imagen Recuadro de listaEdición de múltipleslíneas

Cuaderno Interfaz ODBC/JDBC Recuadro de contorno

Pulsador Botón de selección Graduador Selector cíclicoTexto estático Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl atributo Refresh sólo puede estar establecido en 1.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'LB1': 'Refresh') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' SETATR 1 'REFRESH'*

354 VisualAge RPG Manual de consulta de componentes

Page 373: Manual Ibm

RemoveItemSuprime un elemento de una lista. El parámetro index determina el elemento quese va a suprimir. Para eliminar todos los elementos de una lista, especifique 0como valor de índice.

En un componente subarchivo, este atributo se aplica a un campo de entrada desubarchivo que tenga valores definidos como tipo de validación. Utilice esteatributo para eliminar valores de la lista de validación del campo de entrada delsubarchivo. Primero ha de establecer el atributo ColNumber a fin de identificar lacolumna con la que se debe trabajar.

En el caso de un componente selector cíclico, sólo puede eliminar todos loselementos; es decir, el valor de índice debe establecerse en 0 (eliminar todos). Noestá permitido eliminar un elemento específico de un selector cíclico.

Tipo Numérico

Se aplica a los componentes

Recuadro decombinación

Recuadro de lista Selector cíclico Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl valor de índice del elemento que se va a eliminar

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'LB1': 'RemoveItem') = 3*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' SETATR 3 'REMOVEITEM'*

Capítulo 2. Atributos de componente 355

Page 374: Manual Ibm

RemoveLink

*Restricción: Este atributo no está soportado en las aplicaciones Java.

Elimina el enlace entre este componente y el componente indicado mediante elparámetro part. Si el componente no está enlazado actualmente, no se lleva a caboninguna acción.

Tipo Serie

Se aplica a los componentes

Recuadro de selección Campo de entrada Imagen Recuadro de listaMedios Panel de medios Graduador Temporizador

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoNombre del componente que se va a suprimir

Debe tener el formato:'ventana|componente'

donde ventana es la ventana donde está ubicado el componente ycomponente es el nombre del componente.

Ejemplo de formato libre

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'EF1':'RemoveLink')='WIN1|EF1'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' SETATR 'WIN1|EF1' 'REMOVELINK'*

356 VisualAge RPG Manual de consulta de componentes

Page 375: Manual Ibm

RemoveMsgElimina un mensaje del componente subarchivo de mensajes. El mensaje a eliminarlo determina el parámetro index. Para eliminar todos los mensajes, especifique 0como valor de índice.

Tipo Numérico

Se aplica a los componentes

Subarchivo demensajes

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl número de índice del mensaje que se va a eliminar

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'MSG1': 'RemoveMsg') = 3*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MSG1' SETATR 3 'REMOVEMSG'*

Capítulo 2. Atributos de componente 357

Page 376: Manual Ibm

RemoveRcdElimina un registro de un contenedor. Para eliminar todos los registros, especifiqueel valor 0.

Tipo Numérico

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoIdentificador del registro que se suprimirá

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CN1': 'RemoveRcd') = id*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' SETATR id 'REMOVERCD'*

358 VisualAge RPG Manual de consulta de componentes

Page 377: Manual Ibm

RequestSolicita el valor actual de un elemento en una aplicación de servidor. Antes deefectuar la solicitud, deben haberse establecido los atributos AppName y Topic ydebe haberse iniciado la conversación DDE satisfactoriamente.

Tipo Serie

Se aplica a los componentes

Cliente DDE

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'DDE1': 'Request') = 'A1'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'DDE1' SETATR 'A1' 'REQUEST'*

Capítulo 2. Atributos de componente 359

Page 378: Manual Ibm

RmvSrcEvtElimina un evento de origen de la lista de eventos que supervisa el componente dereferencia a componente lógico. Este atributo, junto con el atributo AddSrcEvt,permite a un componente de referencia a componente lógico supervisar varioseventos. Para añadir nuevos eventos de origen, utilice el atributo AddSrcEvt.

Para identificar el evento de origen que se elimina, especifique juntos los nombresdel componente lógico, la ventana, el componente y el evento. El formato de laserie es:'NOMBRECOMPLÓGICO | NOMBREVENTANA | NOMBRECOMP | NOMBREVENTO'

Dado que el compilador no realiza ninguna comprobación de validez, deberáidentificar correctamente cada evento de origen.

Tipo Serie

Se aplica a los componentes

Referencia acomponente lógico

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+.DName+++++++++++ETDsFrom+++To/L+++IDc.Keywords+++++++++++++++++++++++++D Event S 100**...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Event='compb|win02|ef02|change'C EVAL %setatr('win01': 'CRP1':C 'RmvSrcEvt')=Event*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+.DName+++++++++++ETDsFrom+++To/L+++IDc.Keywords+++++++++++++++++++++++++D Event S 100**...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Event='compb|win02|ef02|change'C 'CRP1' SETATR Event 'RMVSRCEVT'*

360 VisualAge RPG Manual de consulta de componentes

|

||||

|||

|

||

||

|

||||||

|

|

|||

||

|||

|

|||||||||||

|

||||||||||

|

Page 379: Manual Ibm

RmvEventElimina el nombre de evento de la lista de filtro de eventos. Puede utilizar el valorespecial *ALL para que el componente ActiveX o bean Java pare de direccionar alprograma VARPG todos los eventos almacenados en la lista.

Tipo Serie

Se aplica a los componentes

ActiveX Bean Java

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'AX1':'RmvEvent')='EVT2'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'AX1' SETATR 'EVT2' 'RMVEVENT'*

Capítulo 2. Atributos de componente 361

Page 380: Manual Ibm

RowBGClrValor numérico que determina el color de fondo de una fila de subarchivo. Debeutilizar el atributo Index para identificar la fila cuyo color se va a definir.

Si el color de fondo se ha establecido con el atributo RowBGMix, el color de fondodevuelto es el que se parece más al color de mezcla.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El color debe ser uno de los siguientes:

-1 Por omisión (no se utiliza en las aplicaciones Java)

0 Blanco

1 Negro

2 Azul

3 Rojo

4 Rosa

5 Verde

6 Cian

7 Amarillo

8 Gris oscuro

9 Azul oscuro

10 Rojo oscuro

362 VisualAge RPG Manual de consulta de componentes

Page 381: Manual Ibm

11 Rosa oscuro

12 Verde oscuro

13 Cian oscuro

14 Marrón

15 Gris claro

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL RBcolor = %getatr('win01': 'SFL1': 'RowBGClr')*C EVAL %setatr('win01': 'SFL1': 'Index') = 1C EVAL %setatr('win01': 'SFL1': 'RowBGClr') = 5*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' GETATR 'ROWBGCLR' 'RBcolor' 2 0*C 'SFL1' SETATR 1 'INDEX'C 'SFL1' SETATR 5 'ROWBGCLR'*

Capítulo 2. Atributos de componente 363

Page 382: Manual Ibm

RowBGMixConsulta o establece la mezcla de colores de fondo de una fila de subarchivo. Debeutilizar el atributo Index para identificar la fila en la que se consultará o seestablecerá la mezcla de colores.

Tipo Serie

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

La mezcla del color de fondo debe tener el formato siguiente:'rojo:verde:azul'

donde rojo, verde y azul son valores situados entre 0 y 255 que representanla intensidad del color respectivo.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL RBclrMx = %getatr('win01': 'SFL1': 'RowBGMix')*C RBclrMx IFNE '10:23:200'C EVAL %setatr('win01': 'SFL1': 'RowBGMix') = '10:23:200'C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' SETATR '10:23:200' 'ROWBGMIX'*

364 VisualAge RPG Manual de consulta de componentes

Page 383: Manual Ibm

RowFGClrValor numérico que determina el color de primer plano de una fila de subarchivo.Debe utilizar el atributo Index para identificar la fila cuyo color se va a definir.

Si el color de primer plano se ha establecido mediante el atributo RowFGMix, elcolor de primer plano devuelto es el que se parece más al color de mezcla.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El color debe ser uno de los siguientes:

-1 Por omisión (no se utiliza en las aplicaciones Java)

0 Blanco

1 Negro

2 Azul

3 Rojo

4 Rosa

5 Verde

6 Cian

7 Amarillo

8 Gris oscuro

9 Azul oscuro

10 Rojo oscuro

11 Rosa oscuro

12 Verde oscuro

13 Cian oscuro

14 Marrón

15 Gris claro

Capítulo 2. Atributos de componente 365

Page 384: Manual Ibm

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL RFcolor = %getatr('win01': 'SFL1': 'RowFGClr')*C EVAL %setatr('win01': 'SFL1': 'Index') = 1C EVAL %setatr('win01': 'SFL1': 'RowFGClr') = 5*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' GETATR 'ROWFGCLR' 'RFcolor' 2 0*C 'SFL1' SETATR 1 'INDEX'C 'SFL1' SETATR 5 'ROWFGCLR'*

366 VisualAge RPG Manual de consulta de componentes

Page 385: Manual Ibm

RowFGMixConsulta o establece la mezcla de colores de primer plano de una fila desubarchivo. Debe utilizar el atributo Index para identificar la fila en la que seconsultará o se establecerá la mezcla de colores.

Tipo Serie

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

La mezcla de colores de primer plano debe tener el formato siguiente:'rojo:verde:azul'

donde rojo, verde y azul son valores situados entre 0 y 255 que representanla intensidad del color respectivo.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL RFclrMx = %getatr('win01': 'SFL1': 'RowFGMix')*C RFclrMx IFNE '10:23:200'C EVAL %setatr('win01': 'SFL1': 'RowFGMix') = '10:23:200'C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' SETATR '10:23:200' 'ROWFGMIX'*

Capítulo 2. Atributos de componente 367

Page 386: Manual Ibm

Rows

*Restricción: Este atributo no está soportado en las aplicaciones Java.

Devuelve el número de filas de un origen de datos.

Nota: Utilice este atributo sólo si el controlador ODBC es la Versión 3 o superior.Los controladores anteriores devolverán resultados imprevisibles.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Nrws=%getatr('win01':'ODBC1':'Rows')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' GETATR 'ROWS' NRWS*

368 VisualAge RPG Manual de consulta de componentes

Page 387: Manual Ibm

SBIndexEstablece el valor de índice de un panel de barra de estado. Este valor determinacuál es el panel activo. Si hay una discrepancia entre el número de paneles y elvalor de SBIndex, por omisión toma el valor 1.

Tipo Numérico

Se aplica a los componentes

Barra de estado

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoEl valor de SBIndex puede estar entre 1 y 5. El valor por omisión es 1.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'WIN1':'SBIndex')=3*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN1' SETATR 3 'SBINDEX'*

Capítulo 2. Atributos de componente 369

Page 388: Manual Ibm

SBLabelEl texto que aparece en una barra de estado o en un panel de barra de estado. Enel caso de un componente barra de estado, el valor de SBIndex determina quépanel recibe el texto. El texto también puede ser un identificador de mensaje delarchivo de mensajes.

Tipo Serie

Se aplica a los componentes

Barra de estado Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'WIN1':'SBLabel')='Wait...'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN1' SETATR 'Wait...' 'SBLABEL'*

370 VisualAge RPG Manual de consulta de componentes

Page 389: Manual Ibm

SBPanesRecupera el número de paneles activos de un componente barra de estado. Utiliceel atributo SBIndex para establecer cuál es el panel activo.

Tipo Numérico

Se aplica a los componentes

Barra de estado

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL NPanes=%getatr('win01':'WIN1':'SBPanes')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN1' GETATR 'SBPANES' NPANES*

Capítulo 2. Atributos de componente 371

Page 390: Manual Ibm

SBPositionDetermina la posición de una barra de estado. La posición por omisión es la parteinferior de la ventana. Si hay una barra de progreso en la parte inferior, se muevea la parte superior.

Tipo Numérico

Se aplica a los componentes

Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de SBPosition puede ser uno de los siguientes:

1 Colocar la barra de estado en la parte superior

2 Colocar la barra de estado en la parte inferior

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'WIN1':'SBPosition')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN1' SETATR 1 'SBPOSITION'*

372 VisualAge RPG Manual de consulta de componentes

Page 391: Manual Ibm

SBStyleDetermina cómo se dibuja la barra de estado. Puede ser hundida (valor poromisión), en relieve o plana.

Tipo Numérico

Se aplica a los componentes

Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

El valor de SBStyle puede ser uno de los siguientes:

1 Hundida (valor por omisión)

2 En relieve

3 Plana

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'WIN1':'SBStyle')=2*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN1' SETATR 2 'SBSTYLE'*

Capítulo 2. Atributos de componente 373

Page 392: Manual Ibm

ScalePermite que el programador ajuste el ancho de una columna según un porcentajedel ancho del carácter ″W″.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'SFI1': 'Scale') = 8*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFI1' SETATR 8 'SCALE'*

374 VisualAge RPG Manual de consulta de componentes

Page 393: Manual Ibm

Search

*Restricción: Este atributo no está soportado en las aplicaciones Java.

Busca la serie especificada en la lista. La búsqueda empieza en el elementoespecificado por el atributo Index. Se devuelve el valor de Index si se encuentra elelemento o 0 si no se encuentra.

La forma de ejecutar la búsqueda se puede controlar utilizando los atributos Casey SearchType.

Tipo Serie

Se aplica a los componentes

Recuadro decombinación

Recuadro de lista

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CB1': 'Search') = 'Str1'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CB1' SETATR 'STR1' 'SEARCH'*

Capítulo 2. Atributos de componente 375

Page 394: Manual Ibm

SearchType

*Restricción: Este atributo no está soportado en las aplicaciones Java.

Determina cómo se realiza la comparación para la serie de búsqueda cuando seutiliza el atributo Search.

Tipo Numérico

Se aplica a los componentes

Recuadro decombinación

Recuadro de lista

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoEl valor de SearchType puede ser uno de los siguientes:

1 Comparar el prefijo del elemento.

2 Comparar todo el elemento.

3 Coincidencia exacta (valor por omisión)

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CB1': 'SearchType') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CB1' SETATR 1 'SEARCHTYPE'*

376 VisualAge RPG Manual de consulta de componentes

Page 395: Manual Ibm

SelectedIndica si un elemento específico de la parte de lista de un componente estáseleccionado. El elemento que se va a comprobar se especifica estableciendo enprimer lugar el atributo Index o RecordID para el componente.

Tipo Numérico

Se aplica a los componentes

Recuadro decombinación

Contenedor Recuadro de lista Subarchivo demensajes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor permitido

El estado de Selected puede ser:

0 El elemento no está seleccionado

1 El elemento está seleccionado

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Sel = %getatr('win01': 'LB1': 'Selected')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' GETATR 'SELECTED' Sel 1 0*

Capítulo 2. Atributos de componente 377

Page 396: Manual Ibm

SelectIdxDevuelve un valor de índice que indica la posición del botón de selecciónseleccionado en la ventana Tabuladores y grupos. Los botones de selección se creanen grupos lógicos, de modo que al seleccionar uno se deseleccionan los demás. Sino se ha seleccionado ningún botón de selección, se devuelve 0 o un númeromayor que el número de botones de selección del grupo.

Puede utilizar el nombre de cualquier botón de selección del grupo como nombredel componente.

Tipo Numérico

Se aplica a los componentes

Botón de selección

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL sel = %getatr('win01': 'RB1': 'SelectIdx')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'RB1' GETATR 'SELECTIDX' sel 4 0*

378 VisualAge RPG Manual de consulta de componentes

Page 397: Manual Ibm

SelectItemSelecciona un elemento de la parte de lista de un componente. El elemento aseleccionar está especificado por el parámetro index. Para seleccionar todos loselementos de la lista, establezca el atributo Index en cero. Sin embargo, en el casode un componente recuadro de lista, SelectItem no tiene efecto alguno cuando elatributo Index es cero.

Si la lista sólo permite una selección, al seleccionar un elemento se deseleccionarácualquier otro elemento que esté seleccionado actualmente.

Nota: Al seleccionar un elemento se generará un evento Select.

Tipo Numérico

Se aplica a los componentes

Recuadro decombinación

Recuadro de lista Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl valor de índice del elemento

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'LB1': 'SelectItem') = 3*

Ejemplo de formato fijo

Seleccionar todas las entradas de un recuadro de lista si se solicita:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CB01' GETATR 'SELECTED' IsChecked 1 0C IsChecked IFEQ 1C 'LB1' SETATR 0 'SELECTITEM'C ENDIF*

Capítulo 2. Atributos de componente 379

Page 398: Manual Ibm

SelectListDevuelve una lista de los índices de los registros seleccionados de un componenterecuadro de lista o subarchivo. La lista se devuelve en forma de serie de caracteresformada por 6 valores de posición. Cada valor representa el índice del registroseleccionado.

Tipo Serie

Se aplica a los componentes

Recuadro de lista Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL List=%getatr('Win01':'LB1':'SelectList')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' GETATR 'SELECTLIST' LIST*

Ejemplo de SelectListEn el fragmento de código siguiente se muestra una manera de procesar diversosregistros seleccionados de un recuadro de lista mediante el atributo SelectList. Eneste ejemplo, se supone que se puede seleccionar 10 registros como máximo.*

D DSD theList 60AD T 6 0 Dim(10) Overlay(theList)*

C 'ListBox' Getatr 'NbrOfSel' N 2 0*

C If N > 0C 'ListBox' Getatr 'SelectList' theList*

C Do N I 2 0C 'ListBox' Setatr T(I) 'Index'C 'ListBox' Getatr 'GetItem' theItem 60* ....* Se procesa el elemento* ....

C EndDo*

C EndIf

380 VisualAge RPG Manual de consulta de componentes

Page 399: Manual Ibm

SelectRcdSelecciona un registro de un contenedor.

Tipo Serie

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl identificador del registro que se seleccionará

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CN1': 'SelectRcd') = id*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' SETATR id 'SELECTRCD'*

Capítulo 2. Atributos de componente 381

Page 400: Manual Ibm

SelPrinter

*Restricción: Este atributo no está soportado en las aplicaciones Java.

Hace que aparezca el diálogo de selección de impresora del sistema Windows.

Tipo Numérico

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl valor permitido es 1

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*component': '*component':C 'SelPrinter') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' SETATR 1 'SELPRINTER'*

382 VisualAge RPG Manual de consulta de componentes

Page 401: Manual Ibm

Sequence

*Restricción: Este atributo no está soportado en las aplicaciones Java.

Determina el orden en el que se añaden los elementos a la parte de lista de uncomponente cuando se establece el atributo InsertItem o SetItem.

Cambiar el atributo Sequence no afecta al orden actual de la lista. El orden cambiacuando se establece el siguiente atributo InsertItem o SetItem.

Tipo Numérico

Se aplica a los componentes

Recuadro decombinación

Recuadro de lista

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

La secuencia de los elementos añadidos a una lista puede ser:

1 Los elementos se insertan en orden ascendente

2 Los elementos se insertan en orden descendente

3 Los elementos se insertan en la posición especificada por elatributo Index

4 Los elementos se insertan al final de la lista

Capítulo 2. Atributos de componente 383

Page 402: Manual Ibm

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'LB1': 'Sequence') = 1*C EVAL rc = %getatr('win01': 'LB1': 'Sequence')*

Ejemplo de formato fijo

Cambiar la secuencia de un recuadro de lista:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' GETATR 'SEQUENCE' sequence 1 0*C sequence IFEQ 1C 'LB1' SETATR 2 'SEQUENCE'*C ELSEC sequence IFEQ 2C 'LB1' SETATR 3 'SEQUENCE'*C ELSEC 'LB1' SETATR 2 'SEQUENCE'C ENDIF*C ENDIF*

384 VisualAge RPG Manual de consulta de componentes

Page 403: Manual Ibm

SetItemSustituye un elemento existente de la lista. El elemento que se va a sustituir sedetermina mediante el valor actual del atributo Index para el componente.

Para insertar un nuevo elemento en una lista, utilice el atributo InsertItem.

Si el atributo Sequence especifica un orden de clasificación (es decir, ascendente odescendente), la posición del elemento una vez actualizado puede ser distinta de laindicada por el atributo Index.

Tipo Serie

Se aplica a los componentes

Recuadro decombinación

Recuadro de lista

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl nuevo texto del elemento

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'LB1': 'Index') = 5C EVAL %setatr('win01': 'LB1': 'SetItem') = 'new'*

Ejemplo de formato fijo

Cambiar el valor actual de un elemento de recuadro de lista:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' SETATR 5 'INDEX'C 'LB1' SETATR 'New' 'SetItem'*

Capítulo 2. Atributos de componente 385

Page 404: Manual Ibm

SetRcdFldEstablece los datos correspondientes a un campo de un registro de contenedor.Para poder utilizar este atributo, el atributo RecordID debe estar establecido paraindicar el registro de contenedor y ColNumber también debe estar establecido paraindicar qué número de campo debe actualizarse en ese registro.

Tipo Serie

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoLos datos que deben establecerse en el campo de contenedor

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CN1': 'SetRcdFld') = 'Test'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' SETATR 'Test' 'SetRcdFld'*

386 VisualAge RPG Manual de consulta de componentes

Page 405: Manual Ibm

SetRcdIconDefine el nombre de archivo del icono utilizado para representar este registro en lavista de árbol o en la vista de iconos. En las aplicaciones Java, este atributo esaplicable a todas las vistas. El atributo RecordID debe estar establecido paraindicar qué registro se está utilizando.

Tipo Serie

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl nombre de archivo del icono

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'CN1':'SetRcdIcon')C ='C:\TEST.ICO'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' SETATR 'C:\TEST.ICO' 'SetRcdIcon'*

Capítulo 2. Atributos de componente 387

Page 406: Manual Ibm

SetRcdTextDefine el texto que se mostrará con el icono cuando el contenedor se visualice enla vista de árbol. El atributo RecordID debe estar establecido para indicar quéregistro se está utilizando.

Tipo Serie

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl texto del registro

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CN1': 'SetRcdText') = text*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' SETATR text 'SETRCDTEXT'*

388 VisualAge RPG Manual de consulta de componentes

Page 407: Manual Ibm

SetTopOrdena la lista dentro del componente de modo que el elemento especificadoaparece al principio de la misma.

Si el recuadro de lista no tiene barras de desplazamiento (es decir, todos loselementos de la lista están visualizados) la lista no se desplaza.

Tipo Numérico

Se aplica a los componentes

Recuadro decombinación*

Contenedor Recuadro de lista Subarchivo

*Restricción: Este atributo no está soportado en tiempo de ejecución en lasaplicaciones Java para este componente.

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl índice del elemento que se situará al principio de la lista

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'LB1': 'SetTop') = 5*

Ejemplo de formato fijo

Desplazar la primera entrada seleccionada al principio de la lista:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'LB1' GETATR 'FIRSTSEL' index 2 0*C index IFGT *ZEROC 'LB1' SETATR index 'SETTOP'C ENDIF*

Capítulo 2. Atributos de componente 389

Page 408: Manual Ibm

SflNxtChgIndica si un registro de subarchivo ha cambiado o no. Debe establecer el atributoIndex para indicar qué registro se está viendo afectado.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoEstablézcalo en 1 para indicar que el registro ha cambiado.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('window': 'SFX': 'Index') = 12C EVAL %setatr('window': 'SFX': 'SflNxtChg') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFX' SETATR 12 'INDEX'C 'SFX' SETATR 1 'SFLNXTCHG'*

390 VisualAge RPG Manual de consulta de componentes

Page 409: Manual Ibm

ShDataEspecifica los datos de usuario que se deben leer o grabar en el espacio de datoscompartidos establecido.

Tipo Serie

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*component':'*component':'ShData')='DTA'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' SETATR 'DTA' 'SHDATA'*

Capítulo 2. Atributos de componente 391

Page 410: Manual Ibm

ShDataLenEspecifica el tamaño de los datos que se van a utilizar de los datos compartidos. Elvalor por omisión es 1024 bytes.

Tipo Numérico

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*component':'*component':'ShDataLen')=100*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' SETATR 100 'SHDATALEN'*

392 VisualAge RPG Manual de consulta de componentes

Page 411: Manual Ibm

ShDataNameEspecifica el nombre de los datos globales que se pueden compartir enaplicaciones. El tamaño de cada uno de los datos compartidos está determinado a1024 bytes.

Al establecer ShDataName, el sistema comprueba si existe el espacio de datoscompartidos indicado. Si no lo está, se creará.

Nota: Sólo puede utilizarse una instancia de la memoria compartida con nombre.Para la comunicación entre procesos, sólo puede utilizar memoriacompartida en una aplicación, no en un componente. En los componentes,es mejor la utilización de parámetros para la comunicación entre procesos.

Tipo Serie

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*component':'*component':'ShDataName')='DTAN'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' SETATR 'DTAN' 'SHDATANAME'*

Capítulo 2. Atributos de componente 393

Page 412: Manual Ibm

ShDataPosEspecifica la posición que hay en los datos compartidos a la que se hace referencia.La posición inicial por omisión es 1. El valor de ShDataLen y ShDataPos juntos nopuede sobrepasar 1024.

Tipo Numérico

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*component':'*component':'ShDataPos')=100*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' SETATR 100 'SHDATAPOS'*

394 VisualAge RPG Manual de consulta de componentes

Page 413: Manual Ibm

ShowMsgIDHabilita o inhabilita la visualización de los identificadores de mensaje (MSGnnnn)en el recuadro de mensajes si se especifica el código de operación DSPLY.

Tipo Numérico

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

El valor de ShowMsgID puede ser uno de los siguientes:

0 No visualizar los identificadores de mensaje.

1 Visualizar los identificadores de mensaje. Es el valor por omisión.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('*component':'*component':'ShowMsgID')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*COMPONENT' SETATR 1 'SHOWMSGID'*

Capítulo 2. Atributos de componente 395

Page 414: Manual Ibm

ShowPropEstablezca este atributo en 1 para que el componente muestre el diálogo de páginade propiedades del objeto.

Tipo Numérico

Se aplica a los componentes

ActiveX Bean Java

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'AX1':'ShowProp=') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'AX1' SETATR 1 'SHOWPROP'*

396 VisualAge RPG Manual de consulta de componentes

Page 415: Manual Ibm

ShowRectsIndica si se mostrarán o no los rectángulos resaltados definidos por el usuario.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de ShowRects puede ser uno de los siguientes:

0 No se mostrarán los rectángulos

1 Sí se mostrarán los rectángulos

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL isshown = %getatr('win01': 'CAL1': 'ShowRects')*C EVAL %setatr('win01': 'CAL1': 'ShowRects') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' GETATR 'SHOWRECTS' isshown 1 0*

Capítulo 2. Atributos de componente 397

Page 416: Manual Ibm

ShowTabs

*Restricción: Este atributo no está soportado en las aplicaciones Java.

Si se establece este atributo en 0, se ocultarán todas las pestañas de un componentecuaderno.

Tipo Numérico

Se aplica a los componentes

Cuaderno

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'WIN1': 'ShowTabs') = 0*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN1' SETATR 0 'SHOWTABS'*

398 VisualAge RPG Manual de consulta de componentes

Page 417: Manual Ibm

ShowTextIndica si se mostrará o no el texto definido por el usuario.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de ShowText puede ser uno de los siguientes:

0 No se mostrará el texto

1 Sí se mostrará el texto

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL isshown = %getatr('win01': 'CAL1': 'ShowText')*C EVAL %setatr('win01': 'CAL1': 'ShowText') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' GETATR 'SHOWTEXT' shown 1 0*

Capítulo 2. Atributos de componente 399

Page 418: Manual Ibm

ShowTipsDetermina si debe visualizarse la ayuda flotante para un componente específico opara todos los componentes de la ventana. Si establece ShowTips para unaventana, este valor tiene prioridad sobre todos los demás valores establecidos paraun componente específico de la ventana. Por ejemplo, si inhabilita que se muestreel texto de ayuda para la ventana, este valor se aplica también a todos loscomponentes de la ventana.

Tipo Numérico

Se aplica a los componentes

Recuadro de selección Recuadro decombinación

Contenedor Campo de entrada

Pulsador gráfico Imagen Recuadro de lista Subarchivo demensajes

Edición de múltipleslíneas

Pulsador Botón de selección Graduador

Selector cíclico Texto estático Subarchivo Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de ShowTips puede ser uno de los siguientes:

0 No se visualiza la ayuda flotante para un componente específico nipara todos los componentes de la ventana.

1 Se visualizará ayuda flotante para aquellos componentes de laventana que tengan definido TipText.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL isshown = %getatr('win01': 'Win01': 'ShowTips')*C EVAL %setatr('win01': 'Win01': 'ShowTips') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'Win01' GETATR 'SHOWTIPS' shown 1 0*

400 VisualAge RPG Manual de consulta de componentes

Page 419: Manual Ibm

SizeToFitAjusta el tamaño del componente de forma automática de modo que el últimoelemento de la lista resulte completamente visible.

Tipo Numérico

Se aplica a los componentes

Recuadro decombinación*

Recuadro de lista Subarchivo

*Restricción: Este atributo no está soportado en tiempo de ejecución en lasaplicaciones Java para este componente.

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

El valor de SizeToFit puede ser uno de los siguientes:

0 No se ajusta el tamaño del componente.

1 Ajustar automáticamente el tamaño del componente.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CB1': 'SizeToFit') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CB1' SETATR 1 'SIZETOFIT'*

Capítulo 2. Atributos de componente 401

Page 420: Manual Ibm

SortAscOrdena los registros de una columna de contenedor en orden ascendente. Lascolumnas con datos de texto se ordenan alfabéticamente.

Tipo Numérico

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl número de la columna que se debe ordenar.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CTR1': 'SortAsc') = 2*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CTR1' SETATR 2 'SORTASC'*

402 VisualAge RPG Manual de consulta de componentes

Page 421: Manual Ibm

SortDescOrdena los registros de una columna de contenedor en orden descendente. Lascolumnas con datos de texto se ordenan alfabéticamente.

Tipo Numérico

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl número de la columna que se debe ordenar.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CTR1': 'SortDesc') = 2*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CTR1' SETATR 2 'SORTDESC'*

Capítulo 2. Atributos de componente 403

Page 422: Manual Ibm

SQLErrorIndica si la operación anterior se ha realizado correctamente. Si se devuelve elvalor 0, la operación anterior se ha ejecutado correctamente. Todos los demásvalores devueltos indican que se ha producido un error.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Err=%getatr('win01':'ODBC1':'SQLError')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' GETATR 'SQLERROR' ERR*

404 VisualAge RPG Manual de consulta de componentes

Page 423: Manual Ibm

SQLMsgBoxSuprime o visualiza el recuadro de mensajes ODBC si se producen errores alprocesar una tabla.

Si establece este atributo en 0 para suprimir el recuadro de mensajes, puedeutilizar el atributo SQLError para determinar si se ha producido un error. Después,puede utilizar el atributo Handle y llamar a la API ODBC para obtenerinformación adicional.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

El valor de SQLMsgBox puede ser uno de los siguientes:

0 No visualizar el recuadro de mensajes.

1 Visualizar el recuadro de mensajes. Este es el valor por omisión.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'ODBC1':'SQLMsgBox')=0*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' SETATR 0 'SQLMSGBOX'*

Capítulo 2. Atributos de componente 405

Page 424: Manual Ibm

SQLQueryDefine la sentencia SQL que se ejecuta si se establece el atributo ExecuteSQL en 1.

Tipo Serie

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Query = 'Select * From "Customers"'C EVAL %setatr('win01':'ODBC1':'SQLQuery')=QueryC EVAL %setatr('win01':'ODBC1':'ExecuteSQL')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8DName+++++++++++ETDsFrom+++To/L+++IDc.Keywords+++++++++++++++++++++++++++++*D Query C 'Select * From "Customers"'*CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC' Setatr Query 'SQLQuery'C 'ODBC' Setatr 1 'ExecuteSQL'*

406 VisualAge RPG Manual de consulta de componentes

Page 425: Manual Ibm

StartAtFuerza que se inicie la operación READC en el registro especificado delsubarchivo. Este atributo resulta de utilidad en los programas que utilizan READCde forma reiterativa para comprobar la existencia de registros modificados en unsubarchivo y devolverlos. Consulte el apartado “Ejemplo de StartAt” en lapágina 408.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl registro en el que debe iniciarse

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'SFL1': 'StartAt')=4*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFL1' SETATR 4 'STARTAT'*

Capítulo 2. Atributos de componente 407

Page 426: Manual Ibm

Ejemplo de StartAtEl siguiente fragmento de código utiliza reiterativamente la operación READC paracomprobar la existencia de todos los registros modificados en un subarchivo,devolverlos y procesarlos. Se supervisa el campo OPT para que tenga una entradacorrecta. Si el valor de OPT no es correcto, el programa utiliza el atributoSflNxtChg para señalar el registro incorrecto como modificado. El atributo StartAthace que la siguiente operación READC empiece en el registro situado acontinuación del que tiene un error.

Por omisión, READC empieza la búsqueda de registros modificados en el primerregistro del subarchivo. Cuando se encuentra un registro modificado y se devuelveal programa, su estado se restablece en no modificado. En este ejemplo, el atributoStartAt también evita que la operación READC entre en un bucle en el registroseñalado por SflNxtChg.*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----* Suponer que el subarchivo tiene un campo llamado OPT cuyo valor

debe ser* mayor que 0*

C ReadC SFL199C Dow NOT *IN99*

C If Opt > 0** Procesar el registro

C Else** El registro no es válido; establecer SFLNXTCHG para leerlo en la

siguiente iteración.C 'SFL1' Getatr 'Index' XC 'SFL1' Setatr X 'Index'C 'SFL1' Setatr 1 'SFLNXTCHG'** Establecer STARTAT para empezar a leer después del

registro erróneo.C Eval X = X + 1C 'SFL1' Setatr X 'StartAt'C ReadC SFL199C EndDo*

408 VisualAge RPG Manual de consulta de componentes

Page 427: Manual Ibm

StartNewSi este atributo está establecido en 1, los datos existentes se dejan aparte y semantienen para seguir dibujando la gráfica. Los nuevos datos establecidos no seutilizarán en la gráfica hasta que no se establezca el atributo UseData.

Tipo Numérico

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl valor permitido es 1.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'GRA1': 'StartNew') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GRA' SETATR 1 'STARTNEW'*

Capítulo 2. Atributos de componente 409

Page 428: Manual Ibm

StatusBarAñade o elimina una barra de progreso simple de un panel, en o de una ventana.La posición por omisión es la parte inferior de la ventana. Utilice el componentebarra de estado si necesita una barra de estado compuesta, con varios paneles einformación de acción.

Tipo Numérico

Se aplica a los componentes

Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

El valor de StatusBar puede ser uno de los siguientes:

1 Crear una barra de estado

0 Eliminar una barra de estado

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'WIN1':'StatusBar')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN1' SETATR 1 'STATUSBAR'*

410 VisualAge RPG Manual de consulta de componentes

Page 429: Manual Ibm

SwitchTo

*Restricción: Este atributo no está soportado en las aplicaciones Java.

Si se establece este atributo, al iniciar una segunda instancia de un programa lainstancia actual del programa será la que tendrá el foco. El atributo SwitchToacepta como su propio valor el handle de la ventana del programa que va aobtener el foco. Si la ventana tiene formato de icono, se restaurará.

El handle es un valor de 32 bits y debe estar declarado en una especificación Dcomo tipo I (sin signo) con una longitud de 10 y 10 decimales.

Tipo Numérico

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL hWnd=%getatr('Win1':'Win1':'Handle')C EVAL %setatr('*component':'*component':'SwitchTo')=hWnd*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN1' GETATR 'HANDLE' HWNDC '*COMPONENT' SETATR HWND 'SWITCHTO'*

Capítulo 2. Atributos de componente 411

Page 430: Manual Ibm

TabImageEspecifica el nombre de archivo de la imagen que se visualizará en una pestañaPágina de cuaderno, junto a la etiqueta. Consulte el atributo FileName para ver lalista de los tipos de imágenes soportados. Si se especifica *BLANK o no seespecifica ningún nombre de archivo, la imagen se elimina.

Tipo Serie

Se aplica a los componentes

Página de cuaderno Página de cuadernocon lienzo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'NP1':'TabImage') = 'N1.ICO'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'NP1' SETATR 'N1.ICO' 'TABIMAGE'*

412 VisualAge RPG Manual de consulta de componentes

Page 431: Manual Ibm

TabLabelDefine la etiqueta que aparece en una pestaña de página de cuaderno. El atributoPageNumber debe estar establecido para indicar a qué página afecta.

Tipo Serie

Se aplica a los componentes

Página de cuaderno

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR Sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI. Para ello, especifique un valor en el campo Textode tabulador.

Valor permitidoEl texto que aparece en una pestaña de página de cuaderno

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'NBP1': 'TabLabel')C = 'Section A'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'NBP1' SETATR 'Section A' 'TABLABEL'*

Capítulo 2. Atributos de componente 413

Page 432: Manual Ibm

TextEstablece o devuelve el valor de texto de la parte del campo de entrada de uncomponente.

Tipo Serie

Se aplica a los componentes

Recuadro decombinación

Campo de entrada Edición de múltipleslíneas

Selector cíclico

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Se puede establecer utilizando el cuaderno de propiedades en elDiseñador GUI, excepto en el caso de un componente edición demúltiples líneas o selector cíclico. Si se trata de un componenterecuadro de combinación, utilice la página Datos y especifiquevalores. En el caso de un componente campo de entrada, utilice lapágina General e indique un valor en el campo Texto.

Valor permitidoEl valor del campo de entrada

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL oldstring = %getatr('win01': 'EF1': 'Text')*C EVAL %setatr('win01': 'EF1': 'Text') = 'Newstring'*

Ejemplo de formato fijo

Guardar el valor de un campo de entrada y cambiarlo:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' GETATR 'TEXT' oldstring 64C 'EF1' SETATR 'Newstring' 'TEXT'*

414 VisualAge RPG Manual de consulta de componentes

Page 433: Manual Ibm

TextEndDetermina el desplazamiento de carácter del último carácter seleccionado. Si no seha seleccionado ningún texto, se devuelve el valor 0. El texto se seleccionasituando el puntero del ratón sobre el texto, pulsando el botón del ratón ymoviendo el puntero a lo largo del texto.

Este atributo se puede utilizar con TextStart para seleccionar una partedeterminada de texto en el componente y para determinar la longitud del textoseleccionado.

Tipo Numérico

Se aplica a los componentes

Campo de entrada Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'MLE1': 'TextEnd') = value*C EVAL value = %getatr('win01': 'MLE1': 'TextEnd')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' GETATR 'TEXTEND' endoffset 3 0*

Capítulo 2. Atributos de componente 415

Page 434: Manual Ibm

TextLengthDevuelve la longitud del texto en un componente.

Tipo Numérico

Se aplica a los componentes

Campo de entrada Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL length = %getatr('win01': 'EF1': 'TextLength')*

Ejemplo de formato fijo

Obtener la longitud del texto de un campo de entrada:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' GETATR 'TEXTLENGTH' length 3 0*

416 VisualAge RPG Manual de consulta de componentes

Page 435: Manual Ibm

TextSelectDevuelve el texto seleccionado del componente. Si no hay texto seleccionado, sedevuelve una serie de caracteres nula.

Para seleccionar texto en el campo, establezca los atributos TextStart y TextEnd.

Tipo Serie

Se aplica a los componentes

Campo de entrada Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL value = %getatr('win01': 'MLE1': 'TextSelect')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' GETATR 'TEXTSELECT' seltext 100*

Capítulo 2. Atributos de componente 417

Page 436: Manual Ibm

TextStartDetermina el primer carácter del campo de texto que se ha seleccionado. Si no seha seleccionado ningún texto, se devuelve el valor 0.

Este atributo puede utilizarse con TextEnd para seleccionar una cierta parte detexto en el componente.

Tipo Numérico

Se aplica a los componentes

Campo de entrada Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'MLE1': 'TextStart') = value*C EVAL value = %getatr('win01': 'MLE1': 'TextStart')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' GETATR 'TEXTSTART' endoffset 3 0*

418 VisualAge RPG Manual de consulta de componentes

Page 437: Manual Ibm

TextStringDevuelve todo el texto de un componente edición de múltiples líneas y conviertetodos los caracteres de salto de línea o de retorno de carro en espacios en blanco.

Tipo Serie

Se aplica a los componentes

Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL ATxt=%getatr('Win01':'ML1':'TextString')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ML1' GETATR 'TEXTSTRING' ATXT*

Capítulo 2. Atributos de componente 419

Page 438: Manual Ibm

TickLabelAsigna una serie a una marca de escala de un componente graduador. El atributoTickNumber determina el TickLabel al que se hace referencia.

Tipo Serie

Se aplica a los componentes

Graduador

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI. Para ello, seleccione el pulsador Añadir yespecifique los valores en el recuadro de diálogo Añadir texto deescala.

Valor permitidoLa etiqueta asignada a la marca de escala del graduador

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C Z-ADD 0 percent*C DO 5 ticknbrC EVAL %setatr('win01':'SLIDER1':'TickNumber')=ticknbrC EVAL %setatr('win01':'SLIDER1':'TickLabel')=percentC ADD 25 percentC ENDDO*

Ejemplo de formato fijo

Cambiar el texto para una escala de graduador:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C Z-ADD *ZERO value 2 0C 1 DO 11 tick 2 0C 'SLIDER1' SETATR tick 'TICKNUMBER'C 'SLIDER1' SETATR value 'TICKLABEL'C ADD 10 valueC ENDDO*

420 VisualAge RPG Manual de consulta de componentes

Page 439: Manual Ibm

TickNumberEspecifica en qué marca de escala del graduador se colocará el siguiente textoTickLabel.

El número será un valor entre 1 y el número de marcas de escala especificado parael graduador en los valores del cuaderno.

Tipo Numérico

Se aplica a los componentes

Graduador

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoEl número de marca de escala

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL x = %getatr('win01': 'SLIDER1': 'TickNumber')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SLIDER1' GETATR 'TICKNUMBER' OldTick 3 0*C 'SLIDER1' SETATR NewTick 'TICKNUMBER'*

Capítulo 2. Atributos de componente 421

Page 440: Manual Ibm

TileCuando se establece en 1, la imagen del lienzo aparecerá en mosaico.

Tipo Numérico

Se aplica a los componentes

Lienzo

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

El valor de Tile puede ser uno de los siguientes:

0 La imagen no se establece en mosaico

1 La imagen se establece en mosaico

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAN': 'Tile') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAN1' SETATR 1 'TILE'*

422 VisualAge RPG Manual de consulta de componentes

Page 441: Manual Ibm

TimeOutEste valor determina cuánto tendrá que esperar un componente cliente DDE paraestablecer una conversación DDE después de establecer DDEMode en Initiate. Estevalor se expresa en segundos.

Si la conversación DDE no se ha completado en este período de tiempo, se señalaun evento Timeout para el programa.

Tipo Numérico

Se aplica a los componentes

Cliente DDE

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'DDE1': 'TimeOut') = 5*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'DDE1' SETATR 5 'TIMEOUT'*

Capítulo 2. Atributos de componente 423

Page 442: Manual Ibm

TimerModeDetermina la modalidad de operación actual para un componente temporizador.Cuando la modalidad está establecida en Start, el temporizador empezará agenerar eventos Tick. Al establecer la modalidad en Stop se dejan de generareventos Tick. Cuando TimerMode está establecido en Pause, el temporizadordejará de generar eventos Tick, pero seguirá actualizando el atributo TimerTicks.

Tipo Numérico

Se aplica a los componentes

Temporizador

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

El valor de TimerMode puede ser uno de los siguientes:

1 Start

2 Stop (Parar)

3 Pause (Pausa)

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C PB1 BEGACT PRESSC EVAL %setatr('win01': 'TIMER01': 'TimerMode') = 1C ...C ENDACT*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'TIMER1' SETATR 1 'TIMERMODE'*

424 VisualAge RPG Manual de consulta de componentes

Page 443: Manual Ibm

TimerTicksDetermina el valor de escala actual de un temporizador. El valor de TimerTicks esel número de veces que el temporizador ha generado un evento Tick.

Tenga en cuenta que los atributos Interval y Multiplier también determinan elnúmero de eventos Tick. El atributo TimerTicks se determina de la manerasiguiente:

TimerTicks = (tiempo transcurrido en milisegundos) / (Interval * Multiplier)

Tipo Numérico

Se aplica a los componentes

Temporizador

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoLa cuenta de escala actual del temporizador.

Ejemplo de formato libre

Cambiar el valor de impulsos del temporizador:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL count=%getatr('win01':'TIMER01':'TimerTicks')*C count IFGT 1000C EVAL %setatr('win01':'TIMER01':'TimerTicks')=0C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'TIMER01' GETATR 'TIMERTICKS' count 6 0*C count IFGT 1000C 'TIMER01' SETATR 0 'TIMERTICKS'C ENDIF*

Capítulo 2. Atributos de componente 425

Page 444: Manual Ibm

TipTextEspecifica el texto visualizado en el control de ayuda flotante.

Para un componente gráfica, debe asociar el texto de ayuda a un punto de datos.En una barra, por ejemplo, el texto flotante se visualizará junto a la barra querepresenta al punto de datos.

Para un componente calendario, debe asociar el texto de ayuda al atributoDateIdx. La ayuda flotante se asociará con esa fecha.

Tipo Serie

Se aplica a los componentes

Calendario Recuadro de selección Recuadro decombinación

Contenedor

Campo de entrada Gráfica Pulsador gráfico ImagenRecuadro de lista Subarchivo de

mensajesEdición de múltipleslíneas

Pulsador

Botón de selección Graduador Selector cíclico Texto estáticoSubarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR no

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitidoUn máximo de 80 caracteres de texto o un identificador de mensaje(*MSGnnn)

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'MLE1': 'TipText')='*msg0002'*/xmp>

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' SETATR 'Hello' 'TipText'*

426 VisualAge RPG Manual de consulta de componentes

Page 445: Manual Ibm

TitleDetermina el texto del título de la gráfica.

Tipo Serie

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL value = %getatr('win01': 'GRA1': 'Title')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GRA1' GETATR 'TITLE' seltitle 1 0*

Capítulo 2. Atributos de componente 427

Page 446: Manual Ibm

TitlePlaceIndica dónde debe estar situado el título dentro de la gráfica.

Tipo Numérico

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de TitlePlace puede ser uno de los siguientes:

0 Sin título

1 Por encima de la gráfica

2 Por debajo de la gráfica

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'GRA1': 'TitlePlace') = 3*C EVAL where = %getatr('win01': 'GRA1': 'TitlePlace')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GRA1' GETATR 'TITLEPLACE' where 1 0*

428 VisualAge RPG Manual de consulta de componentes

Page 447: Manual Ibm

TopEspecifica en pixels la coordenada superior de pantalla del componente u objeto.

Nota: El punto de origen es el ángulo superior izquierdo y empieza por cero.

Tipo Numérico

Se aplica a los componentes

ActiveX Control de animación Calendario Lienzo*Recuadro de selección Recuadro de

combinaciónContenedor Cliente DDE

Campo de entrada Gráfica Pulsador gráfico Recuadro de grupoBarra dedesplazamientohorizontal

Imagen Bean Java Recuadro de lista

Medios Panel de medios Edición de múltipleslíneas

Cuaderno

Interfaz ODBC/JDBC Recuadro de contorno Barra de progreso PulsadorBotón de selección Graduador Selector cíclico Texto estáticoSubarchivo Temporizador Barra de

desplazamientovertical

Ventana

* Restricción: Este atributo sólo se puede obtener en tiempo de ejecuciónpara el componente lienzo.

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitidoNúmero de pixels

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL otop = %getatr('win01': 'Image1': 'Top')C otop SUB 200 newtopC EVAL %setatr('win01': 'Image1': 'Top') = newtop*

Ejemplo de formato fijo

Mover una imagen 200 pixels dentro de su ventana.*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'IMAGE1' GETATR 'TOP' OldTop 4 0C OldTop SUB 200 NewTop 4 0C 'IMAGE' SETATR NewTop 'TOP'*

Capítulo 2. Atributos de componente 429

|||

||

|||

||

|

Page 448: Manual Ibm

TopicEl atributo Topic se establece para informar a la aplicación del servidor en unaconversación DDE acerca del tema de la conversación. Antes de que puedacomenzar la conversación, también debe establecerse el atributo AppName.

Un tema DDE es un conjunto de datos que puede procesar la aplicación delservidor. En el caso de una aplicación de hoja de cálculo, sería un archivo de hojade cálculo.

Si el programa servidor es un componente lógico VisualAge RPG, la sintaxis deeste atributo es:

'nombreapl|nombreapl'

siendo nombreapl el nombre del componente lógico VisualAge RPG. Por ejemplo, siel programa servidor es un componente lógico VisualAge RPG llamado server, esteatributo se establecería de este modo:

EVAL %setatr('WIN1':'DDE1':'Topic') = 'SERVER|SERVER'

Tipo Serie

Se aplica a los componentes

Cliente DDE

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'DDE1': 'AppName') = 'APP01'C EVAL %setatr('win01': 'DDE1': 'Topic') = 'APP01.WG1'C EVAL %setatr('win01': 'DDE1': 'DDEMode') = 1C ...*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'DDE1' SETATR 'APP01.WG1' 'TOPIC'*

430 VisualAge RPG Manual de consulta de componentes

Page 449: Manual Ibm

TopLineIndica el número de la primera línea de un campo de edición de múltiples líneas.Si TopLine está establecido en cero, el campo de edición de múltiples líneas sevisualizará en la última página.

Tipo Numérico

Se aplica a los componentes

Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoNúmero de línea

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'MLE1': 'TopLine') = 0*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' SETATR 0 'TOPLINE'*

Capítulo 2. Atributos de componente 431

Page 450: Manual Ibm

TopRecordSitúa la lista dentro del componente subarchivo de modo que el elemento de índiceespecificado se sitúa al principio de la lista u obtiene (o devuelve) el índice de lafila visible superior.

Tipo Numérico

Se aplica a los componentes

Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL itemtop = %setatr('win01': 'SFI1': 'TopRecord')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SFI1' SETATR 'TOPRECORD' itemtop*

432 VisualAge RPG Manual de consulta de componentes

Page 451: Manual Ibm

Treble

Nota: Este atributo sólo se utiliza en Windows NT/95/98.

El atributo Treble establece el nivel de agudos para el archivo de audio. El nivelpuede establecerse entre 0 y 100.

Tipo Numérico

Se aplica a los componentes

Medios

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoEl valor debe estar entre 0 y 100

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'AUD1': 'Treble') = 42*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'AUD1' SETATR 42 'TREBLE'*

Capítulo 2. Atributos de componente 433

Page 452: Manual Ibm

UnBind

*Restricción: Este atributo sólo se utiliza en las aplicaciones Java.

Establezca este atributo en 1 para desenlazar componentes previamente enlazados.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'OD1':'UnBind')=1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'OD1' SETATR 1 'UNBIND'*

434 VisualAge RPG Manual de consulta de componentes

Page 453: Manual Ibm

UnderPoint

*Restricción: Este atributo no está soportado en las aplicaciones Java.

Establezca este atributo en la representación en forma de serie de una posiciónrelativa al ángulo superior izquierdo de la gráfica (por ejemplo, ″25 10″). Acontinuación, utilice los valores de los atributos HitItem, DataPoint y DataGrouppara determinar qué parte de la gráfica está situada debajo del punto dado.

Tipo Serie

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor permitidoSerie con el formato ″x y″

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL xystring = %getatr('win01': 'GPH1': 'UnderPoint')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GPH1' GETATR 'UNDERPOINT' xystring*

Capítulo 2. Atributos de componente 435

Page 454: Manual Ibm

UndoEstablezca este atributo en 1 para deshacer el último cambio que se ha efectuado.

Tipo Numérico

Se aplica a los componentes

Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'ML1': 'Undo') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ML1' SETATR 1 'UNDO'*

436 VisualAge RPG Manual de consulta de componentes

Page 455: Manual Ibm

UpdateRowDetermina el número de fila que se actualiza en el conjunto de resultados. No esnecesario buscar antes una fila para actualizarla. Este atributo ocasionará que seactualice cualquier fila.

Para actualizar una fila que se acaba de buscar, utilice el atributo CurrentRow paraobtener su número de fila.

Nota: En las aplicaciones Java, este atributo necesita el controlador adecuado deconformidad con JDBC 2.0.

Tipo Numérico

Se aplica a los componentes

Interfaz ODBC/JDBC

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'ODBC1':'UpdateRow')=4*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'ODBC1' SETATR 4 'UPDATEROW'*

Capítulo 2. Atributos de componente 437

Page 456: Manual Ibm

UseDataEstablezca este atributo en 1 para empezar a utilizar los datos establecidos para lagráfica desde la última vez que se estableció StartNew.

Tipo Numérico

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitidoEl valor permitido es 1

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'GRA1': 'UseData') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GRA1' SETATR 1 'USEDATA'*

438 VisualAge RPG Manual de consulta de componentes

Page 457: Manual Ibm

UseDelimEstablezca este atributo en 1 para identificar los datos que tienen un carácterdelimitador asociado. Utilice el atributo DelimChar para especificar el carácterdelimitador, si lo hay.

Tipo Numérico

Se aplica a los componentes

Recuadro decombinación

Recuadro de lista

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CB1': 'UseDelim') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CB1' SETATR 1 'USEDELIM'*

Capítulo 2. Atributos de componente 439

Page 458: Manual Ibm

UserDataPermite que cualquier serie definida por el usuario pueda asociarse con uncomponente. La serie no tiene restricción de longitud.

Tipo Serie

Se aplica a los componentes

Todos los componentes excepto el componente *component

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoLos datos que se van a asociar al componente

Ejemplo de formato libre

Guardar el valor de un campo de entrada y cambiarlo:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL oldstring = %getatr('win01': 'EF1': 'UserData')*C EVAL %setatr('win01': 'EF1': 'UserData') = 'Newstring'*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' GETATR 'USERDATA' oldstring 64C 'EF1' SETATR 'Newstring' 'USERDATA'*

440 VisualAge RPG Manual de consulta de componentes

Page 459: Manual Ibm

ValidateCuando este atributo está establecido, al pulsar el botón al que se aplica, serealizará la validación de campo para aquellos componentes que tengan valores devalidación de campo y estén en la misma ventana que el botón. La validación decampo incluye aspectos tales como la comprobación del rango y de valores.

Si se encuentra algún error durante la validación de campo, se visualiza unmensaje y no se señala el evento Press.

Si no hay errores, o si no hay campos con validación de campo, se invoca lasubrutina de acción del evento Press.

Nota: Si ningún pulsador o pulsador gráfico de la ventana tiene establecido elatributo Validate. no se realizará la validación de campo.

Tipo Numérico

Se aplica a los componentes

Pulsador gráfico Pulsador

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI. Para ello, seleccione el estilo Ejecutar validación decampo.

Valor permitido

El valor de Validate puede ser uno de los siguientes:

0 No efectuar validación de entrada

1 Efectuar validación de entrada

Capítulo 2. Atributos de componente 441

Page 460: Manual Ibm

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL validate = %getatr('win01': 'EF01': 'Validate')*C EVAL %setatr('win01': 'EF01': 'Validate') = 1*

Ejemplo de formato fijo

Guardar el valor de un campo de entrada y cambiarlo:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' GETATR 'VALIDATE' validate 1 0C 'EF1' SETATR 1 'VALIDATE'*

442 VisualAge RPG Manual de consulta de componentes

Page 461: Manual Ibm

ValueDevuelve el valor de un componente graduador. El valor será mayor o igual que elvalor mínimo asignado al graduador, y menor o igual que el valor máximo.

Para un selector cíclico, se devuelve el contenido actual del campo de entrada.

Tipo Numérico

Se aplica a los componentes

Graduador Selector cíclico

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoValor del graduador o del campo de entrada.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL oldvalue = %getatr('win01': 'SLIDER1': 'Value')*C EVAL %setatr('win01': 'SLIDER1': 'Value') = 5*

Ejemplo de formato fijo

Guardar el valor de un campo de entrada y cambiarlo:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SLIDER1' GETATR 'VALUE' OldValue 3 0C 'SLIDER1' SETATR 5 'VALUE'*

Capítulo 2. Atributos de componente 443

Page 462: Manual Ibm

ViewDetermina cómo se visualizan los registros de un contenedor. Un contenedorpuede visualizar registros en una vista de iconos, de árbol, de detalles o de árbolde texto.

Tipo Numérico

Se aplica a los componentes

Contenedor

*Restricción: En las aplicaciones Java, este atributo sólo se puede obteneren tiempo de ejecución para este componente.

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

La vista de contenedor puede ser:

1 Vista de iconos

2 De árbol

3 Vista de detalles

4 Vista de árbol de texto

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CN1': 'View') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' SETATR 1 'VIEW'*

444 VisualAge RPG Manual de consulta de componentes

Page 463: Manual Ibm

VisibleDetermina si el componente es visible o no.

Tipo Numérico

Se aplica a los componentes

ActiveX Control de animación Calendario Recuadro de selecciónRecuadro decombinación

Referencia acomponente lógico

Contenedor Cliente DDE

Campo de entrada Gráfica Pulsador gráfico Recuadro de grupoBarra dedesplazamientohorizontal

Imagen Bean Java Recuadro de lista

Medios Panel de medios Subarchivo demensajes

Edición de múltipleslíneas

Cuaderno Página de cuaderno Interfaz ODBC/JDBC Recuadro de contornoMenú emergente* Barra de progreso Pulsador Botón de selecciónGraduador Selector cíclico Texto estático Barra de estadoSubarchivo Temporizador Barra de

desplazamientovertical

Ventana

*Restricción: Para las aplicaciones Windows, una consulta (GETATR)devuelve un valor 0 para este atributo. En las aplicacionesJava, este atributo devuelve el estado del menú emergente.

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

El valor de Visible puede ser uno de los siguientes:

0 El componente no es visible

1 El componente es visible

Nota: En los menús emergentes de las aplicaciones Java, tambiéndebe establecer los atributos InvPname (nombre de padredel invocador) e InvName (nombre de invocador), y lascoordenadas x-y del menú emergente del espacio decoordenadas del invocador.

Capítulo 2. Atributos de componente 445

Page 464: Manual Ibm

Ejemplo de formato libre

Conmutar el estado de Visible de un componente:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL isVisible = %getatr('win01': 'EF1': 'Visible')*C isVisible IFEQ 1C EVAL %setatr('win01': 'EF1': 'Visible') = 0*C ELSEC EVAL %setatr('win01': 'EF1': 'Visible') = 1C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' GETATR 'VISIBLE' IsVisible 1 0C IsVisible IFEQ 1C 'EF1' SETATR 0 'VISIBLE'*C ELSEC 'EF1' SETATR 1 'VISIBLE'C ENDIF*

446 VisualAge RPG Manual de consulta de componentes

Page 465: Manual Ibm

VisTitleDetermina si el título del contenedor es visible o no.

Tipo Numérico

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

Uno de los siguientes:

0 El título no es visible

1 El título es visible

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CN1': 'VisTitle) = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' SETATR 1 'VisTitle'*

Capítulo 2. Atributos de componente 447

Page 466: Manual Ibm

VisTitlSepDetermina si el separador del título del contenedor es visible o no.

Tipo Numérico

Se aplica a los componentes

Contenedor

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Valor permitido

Uno de los siguientes:

0 El separador del título no es visible

1 El separador del título es visible

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CN1': 'VisTitlSep) = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CN1' SETATR 1 'VisTitlSep'*

448 VisualAge RPG Manual de consulta de componentes

Page 467: Manual Ibm

Volume

Nota: Este atributo sólo se utiliza en Windows NT/95/98.

Establece el volumen para el componente medios y la salida de ondas y elsintetizador del sistema.

En el caso de un panel de medios, determina el valor del graduador de volumen.Este valor está entre 0 y 100.

Tipo Numérico

Se aplica a los componentes

Medios Panel de medios

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoEl valor de volumen

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL curvol = %getatr('win01': 'MMP1': 'Volume')*C EVAL %setatr('win01': 'MMP1': 'Volume') = 5*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MMP1' GETATR 'VOLUME' curvol 3 0*C 'MMP1' SETATR 5 'VOLUME'*

Capítulo 2. Atributos de componente 449

Page 468: Manual Ibm

VRuleAñade una regla vertical entre cada columna de una fila de datos de subarchivo ode calendario. Debe haber por lo menos una fila de datos.

Tipo Numérico

Se aplica a los componentes

Calendario Subarchivo

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de VRule puede ser uno de los siguientes:

0 Desactiva la regla

1 Activa la regla

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL Vtrule = %getatr('win01': 'SF1': 'VRule')*C Vtrule IFEQ 0C EVAL %setatr('win01': 'SF1': 'VRule') = 1C ELSEC EVAL %setatr('win01': 'SF1': 'VRule') = 0C ENDIF*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'SF1' GETATR 'VRULE' Vtrule 1 0*C 'SF1' SETATR 1 'Vtrule'*

450 VisualAge RPG Manual de consulta de componentes

Page 469: Manual Ibm

WeekDayIndica el día de la semana que está seleccionado.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor devuelto

Uno de los siguientes:

0 Domingo

1 Lunes

2 Martes

3 Miércoles

4 Jueves

5 Viernes

6 Sábado

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL index = %getatr('win01': 'CAL1': 'WeekDay')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' GETATR 'WEEKDAY' 02*

Capítulo 2. Atributos de componente 451

Page 470: Manual Ibm

WeekDayIdxDevuelve el día de la semana que corresponde a los valores de YearIdx, MonthIdxy DayIdx.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Valor devuelto

Uno de los siguientes:

0 Domingo

1 Lunes

2 Martes

3 Miércoles

4 Jueves

5 Viernes

6 Sábado

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL index = %getatr('win01': 'CAL1': 'WeekDayIdx')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' GETATR 'WEEKDAYIDX' INDEX*

452 VisualAge RPG Manual de consulta de componentes

Page 471: Manual Ibm

WidthEspecifica el ancho del componente en pixels. Al cambiar el ancho de una ventanase genera un evento ReSize.

Nota: El atributo Width no puede sobrepasar el ancho máximo, que vienedeterminado por la resolución de pantalla utilizada. Por ejemplo, no sepuede crear un componente que tenga 800 pixels de ancho si se trabaja conuna pantalla de 640 pixels de ancho.

Tipo Numérico

Se aplica a los componentes

ActiveX Calendario Lienzo Recuadro de selecciónRecuadro decombinación

Contenedor Campo de entrada Gráfica

Pulsador gráfico Recuadro de grupo Barra dedesplazamientohorizontal

Imagen

Bean Java Recuadro de lista Panel de medios Edición de múltipleslíneas

Cuaderno Interfaz ODBC/JDBC Recuadro de contorno Barra de progresoPulsador Botón de selección Graduador Selector cíclicoTexto estático Subarchivo Barra de

desplazamientovertical

Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitidoEl ancho del componente en pixels

Ejemplo de formato libre

Aumentar el ancho de un componente:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL width = %getatr('win01': 'EF1': 'Width')*C EVAL %setatr('win01': 'EF1': 'Width') =

width + 100*

Ejemplo de formato fijo

Ampliar un pulsador 200 pixels:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'EF1' GETATR 'WIDTH' OldWidth 2 0C OldTop ADD 200 NewWidth 2 0C 'EF1' SETATR NewWidth 'WIDTH'*

Capítulo 2. Atributos de componente 453

|||

||

|||

||

|

Page 472: Manual Ibm

WindowMode

*Restricción: Este atributo no está soportado en las aplicaciones Java.

Determina cómo se visualiza una ventana.

Tipo Numérico

Se aplica a los componentes

Ventana

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitido

El valor de WindowMode puede ser uno de los siguientes:

1 Maximizada - Muestra la ventana en su mayor tamaño posible

2 Minimizada - Elimina la ventana del lugar de trabajo y larepresenta como un icono

3 Restaurada - Devuelve la ventana al tamaño que tenía antes de serminimizada o maximizada

Nota: Cuando se restaura una ventana desde un estado maximizado, elatributo WindowMode puede indicar que la ventana sigue en estadomaximizado aunque ya no lo esté.

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'win01': 'WindowMode') = 1*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'WIN01' SETATR 1 'WINDOWMODE'*

454 VisualAge RPG Manual de consulta de componentes

Page 473: Manual Ibm

WordWrapDetermina si el texto entrado en un componente edición de múltiples líneas debeacomodarse al llegar al límite de palabras. Si WordWrap está inhabilitado, el textocontinuará en la misma línea.

Nota: Este atributo no funciona si se establece el estilo de desplazamientohorizontal.

Tipo Numérico

Se aplica a los componentes

Edición de múltipleslíneas

Códigos de operación

Operativo en tiempo de ejecución

SETATR* no

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

El valor de WordWrap puede ser uno de los siguientes:

0 Acomodar palabra inhabilitado

1 Acomodar palabra habilitado

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL rc = %getatr('win01': 'MLE1': 'WordWrap')*

Ejemplo de formato fijo

Conmutar el estado de acomodación de palabra de un componente ediciónde múltiples líneas:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'MLE1' GETATR 'WORDWRAP' break 1 0*

Capítulo 2. Atributos de componente 455

Page 474: Manual Ibm

WrkStnName

*Restricción: Este atributo no está soportado en las aplicaciones Java.

Devuelve el nombre de la estación de trabajo.

Tipo Serie

Se aplica a los componentes

*Component

Códigos de operación

Operativo en tiempo de ejecución

SETATR no

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL WRKN=%getatr('*component':'*component':'WrkStnName')*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C '*component' GETATR 'WRKSTNNAME' WRKN*

456 VisualAge RPG Manual de consulta de componentes

Page 475: Manual Ibm

X

*Restricción: Este atributo sólo se utiliza en las aplicaciones Java.

Especifica la coordenada x, en pixels, del menú emergente del espacio decoordenadas del invocador. Este atributo se utiliza junto con los atributosInvName, InvPname e Y.

Tipo Numérico

Se aplica a los componentes

Menú emergente

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'POP1':'X')=35*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'POP1' SETATR 35 'X'*

Capítulo 2. Atributos de componente 457

Page 476: Manual Ibm

XAxisLabelEs el texto que sirve de etiqueta del eje de la X.

Tipo Serie

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'GRA1': 'XAxisLabel') = label*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GRA' SETATR 'label' 'XAxisLabel'*

458 VisualAge RPG Manual de consulta de componentes

Page 477: Manual Ibm

Y

*Restricción: Este atributo sólo se utiliza en las aplicaciones Java.

Especifica la coordenada y, en pixels, del menú emergente del espacio decoordenadas del invocador. Este atributo se utiliza junto con los atributosInvName, InvPname y X.

Tipo Numérico

Se aplica a los componentes

Menú emergente

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR no

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01':'POP1':'Y')=45*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'POP1' SETATR 45 'Y'*

Capítulo 2. Atributos de componente 459

Page 478: Manual Ibm

YAxisLabelEs el texto que sirve de etiqueta del eje de la Y.

Tipo Serie

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'GRA1': 'YAxisLabel') = label*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GRA1' SETATR 'label' 'YAxisLable'*

460 VisualAge RPG Manual de consulta de componentes

Page 479: Manual Ibm

YearIndica el año del calendario que está seleccionado actualmente. Si se establece, seactualizará la fecha seleccionada del componente calendario para que los cambiosqueden reflejados.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoEl año

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'Year') = 1998*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' SETATR 1998 'YEAR'*

Capítulo 2. Atributos de componente 461

Page 480: Manual Ibm

YearIdxPermite que el usuario defina datos en una fecha que no se visualiza en la páginaactual del calendario.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Valor permitidoValor de índice

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'YearIdx') = 1998*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' SETATR 1998 'YEARIDX'*

462 VisualAge RPG Manual de consulta de componentes

Page 481: Manual Ibm

YearLenIndica el formato de visualización del año.

Tipo Numérico

Se aplica a los componentes

Calendario

Códigos de operación

Operativo en tiempo de ejecución

SETATR* sí

GETATR sí

*Nota: Puede definirse utilizando el cuaderno de propiedades en eldiseñador GUI.

Valor permitido

YearLen puede tener uno de los valores siguientes:

1 Año completo con cuatro dígitos

2 Dos dígitos

Nota: Windows 95 visualiza ambos dígitos como la opción derelleno de dos dígitos. No hay distinción entre ambas.

3 Dos dígitos, con un cero para los años que sólo tienen un dígito

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'CAL1': 'YearLen') = 3*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'CAL1' GETATR 'YEARLEN' YearLen 1 0*

Capítulo 2. Atributos de componente 463

Page 482: Manual Ibm

YincEstablece el número de marcas de escala que se utilizarán en el eje Y. El eje Y sedividirá en un número igual de incrementos, basándose en los valores mínimo ymáximo permitidos.

Tipo Numérico

Se aplica a los componentes

Gráfica

Códigos de operación

Operativo en tiempo de ejecución

SETATR sí

GETATR sí

Ejemplo de formato libre*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C EVAL %setatr('win01': 'GRA1': 'YInc') = 20*

Ejemplo de formato fijo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----*C 'GRA1' SETATR 20 'YInc'*

464 VisualAge RPG Manual de consulta de componentes

|

|||

||

|

||||||

|

|||

||

|||

|

|||||

|

|||||

Page 483: Manual Ibm

Capítulo 3. Eventos de componentes

Cuando un componente reconoce un evento (por ejemplo, cuando el usuarioselecciona un pulsador), invoca la subrutina de acción que haya definido entre loscódigos de operación BEGACT y ENDACT específicos en el programa. Si no se hadefinido ninguna subrutina de acción para un evento, éste se pasa por alto. Laventana Subrutinas de acción visualiza qué subrutinas de acción se invocanmediante qué eventos de componente.

En ciertos casos, el evento también hará que se pueda disponer de atributos deevento, que contienen datos relevantes. Puede acceder a estos atributos de eventodesde el programa haciendo referencia a los mismos.

Este capítulo describe los eventos de componente. Cada una de las descripcionescontiene lo siguiente:v Una lista de componentes a los que se aplica el eventov Una descripción general del eventov Una lista de los atributos de evento que se aplican al evento (si los hay)v Un ejemplo (si los hay)

ActivateEste evento se produce cuando una ventana se convierte en la ventana activa. Elloocurre cuando el usuario pulsa en ella con el puntero del ratón o selecciona uncomponente de la misma.

Se aplica a los componentes

Ventana

Atributos de evento

%EventName %Part %Window

BeanEvent

* Restricción: Este evento no está soportado en las aplicaciones Windows.

Este evento se produce siempre que se produce un evento de bean Java.

Se aplica a los componentes

Bean Java

Atributos de evento

%EventName %Part %Window

© Copyright IBM Corp. 1994, 2000 465

|

Page 484: Manual Ibm

ChangeEste evento se produce al cambiar el contenido o el valor de un componente. Paracada tipo de componente, este evento se produce cuando se realiza el siguientecambio:

Recuadro de combinaciónEl usuario escribe en el campo de entrada o selecciona un elemento de lalista desplegable.

Campo de entradaEl usuario escribe en el campo de entrada.

Edición de múltiples líneasEl usuario escribe en el campo de edición de múltiples líneas.

Panel de mediosEl usuario cambia la posición de un graduador del panel.

GraduadorEl usuario cambia la posición del graduador.

Selector cíclicoEl usuario selecciona uno de los selectores cíclicos o escribe un valor en elcampo de entrada.

SubarchivoEl usuario cambia los datos de una casilla de subarchivo y abandona lacasilla.

Tenga en cuenta que también puede modificarse el valor de un componente comoresultado de establecer ciertos atributos, por ejemplo, el componente está definidocomo un componente destino y responde a un evento Link.

Se aplica a los componentes

Recuadro decombinación

Campo de entrada Panel de medios Edición de múltipleslíneas

Graduador Selector cíclico Subarchivo

Atributos de evento

%ColNumber %EventName %Index %Part%Window

ClickEste evento se produce cuando el usuario coloca el puntero del ratón encima delcomponente y pulsa y suelta uno de los botones del ratón.

El componente debe estar habilitado para recibir este evento.

Nota: El evento Click no se señala si hay un componente Contenedor en la vistade Detalles.

Se aplica a los componentes

Calendario Lienzo Contenedor Campo de entradaGráfica Imagen Edición de múltiples

líneasTexto estático

466 VisualAge RPG Manual de consulta de componentes

Page 485: Manual Ibm

Atributos de evento

%Button %EventName %MouseX %MouseY%Part %Window

CloseEste evento se produce solamente cuando una ventana se cierra a través del menúdel sistema. El código de operación CLSWIN no tiene ningún efecto.

Se aplica a los componentes

Ventana

Atributos de evento

%EventName %Part %Window

CollapsedEste evento se produce al contraer un nodo de un contenedor de la vista de árbol.Este evento se puede utilizar para cambiar el icono de un registro para quemuestre el estado.

Se aplica a los componentes

Contenedor

Atributos de evento

%EventName %Part %Window

ColSelectEste evento se produce al seleccionar una cabecera de columna con el ratón. Debehaber un componente contenedor en la vista de detalles. El atributo de evento%ColNumber devuelve el número de la columna seleccionada.

Se aplica a los componentes

Contenedor Subarchivo

Atributos de evento

%ColNumber %EventName %Part %Window

CompleteEste evento se produce cuando el componente medios ha procesado un archivo deaudio. El atributo de evento %Complete indica si la operación se ha realizado demanera correcta.

Capítulo 3. Eventos de componentes 467

Page 486: Manual Ibm

Se aplica a los componentes

Medios

Atributos de evento

%Complete %EventName %Part %Window

CreateEste evento se produce cuando se crea el componente.

En el caso de un componente ventana, el evento Create sólo después de que sehayan creado todos los componentes de dicha ventana y se hayan producido suseventos Create.

En este momento se pueden establecer los atributos del componente. Por ejemplo,tal vez le interese cambiar el valor por omisión de un campo de entrada antes deque el campo aparezca en la ventana.

Se aplica a los componentes

ActiveX Control de animación Calendario LienzoRecuadro de selección Recuadro de

combinaciónReferencia acomponente lógico

Contenedor

Cliente DDE Campo de entrada Gráfica Pulsador gráficoRecuadro de grupo Barra de

desplazamientohorizontal

Imagen Bean Java

Recuadro de lista Medios Panel de medios Barra de menúsOpción de menú Subarchivo de

mensajesEdición de múltipleslíneas

Cuaderno

Página de cuaderno Interfaz ODBC/JDBC Recuadro de contorno Barra de progresoPulsador Botón de selección Graduador Selector cíclicoTexto estático Barra de estado Subarchivo SubmenúTemporizador Barra de

desplazamientovertical

Ventana

Atributos de evento

%EventName %Part %Window

DataEste evento se produce cuando los datos están disponibles de la aplicaciónservidor en una conversación DDE. Se genera como resultado de un mandatoRequest, o si los datos han cambiado o el componente Cliente DDE está definido enuna conversación de enlace dinámico con otro componente mediante el atributoAllowLink.

Se aplica a los componentes

Cliente DDE

468 VisualAge RPG Manual de consulta de componentes

Page 487: Manual Ibm

Atributos de evento

%Data %EventName %Item %Part%Window

DblClickEste evento se produce cuando el usuario pulsa y suelta el botón del ratón dosveces de forma rápida y sucesiva.

Se aplica a los componentes

Calendario Lienzo Contenedor Campo de entradaGráfica Imagen Edición de múltiples

líneasTexto estático

Atributos de evento

%Button %EventName %MouseX %MouseY%Part %Window

DeActivateEste evento se produce cuando la ventana ya no está activa. Una ventana sedesactiva cuando se activa otro componente.

Este evento se produce al ejecutar un código de operación CLSWIN.

Se aplica a los componentes

Ventana

Atributos de evento

%EventName %Part %Window

DestroyEste evento se produce cuando se cierra la ventana que contiene el componente,sea porque el usuario ha seleccionado la opción de menú Cerrar del menú delsistema en la ventana, o mediante el código de operación CLSWIN.

Este evento también se producirá en todos los componentes del programa alterminar éste.

Se aplica a los componentes

ActiveX Control de animación Calendario LienzoRecuadro de selección Recuadro de

combinaciónReferencia acomponente lógico

Contenedor

Cliente DDE Campo de entrada Gráfica Pulsador gráficoRecuadro de grupo Barra de

desplazamientohorizontal

Imagen Bean Java

Recuadro de lista Medios Panel de medios Barra de menús

Capítulo 3. Eventos de componentes 469

Page 488: Manual Ibm

Opción de menú Subarchivo demensajes

Edición de múltipleslíneas

Cuaderno

Página de cuaderno Interfaz ODBC/JDBC Recuadro de contorno Barra de progresoPulsador Botón de selección Graduador Selector cíclicoTexto estático Barra de estado Subarchivo SubmenúTemporizador Barra de

desplazamientovertical

Ventana

Atributos de evento

%EventName %Part %Window

DropEste evento se produce al arrastrar y soltar un objeto en este componente. Elatributo DropEnable debe establecerse para este componente para que responda aeste evento. Puede consultar el valor asociado con el componente soltadoverificando el atributo de evento %Data.

Se aplica a los componentes

Recuadro decombinación*

Campo de entrada Recuadro de lista* Subarchivo demensajes

Edición de múltipleslíneas

Texto estático

* Restricción: Este evento no está soportado en tiempo de ejecución en lasaplicaciones Java para este componente.

Atributos de evento

%Data %EventName %Part %Window

DropDown

* Restricción: Este evento no está soportado en las aplicaciones Java.

Para un recuadro de combinación, este evento se produce cuando tiene lugar losiguiente:v El usuario pulsa con el ratón en la flecha abajo que hay a la derecha del

recuadro.

Se aplica a los componentes

Recuadro decombinación

Atributos de evento

%EventName %Part %Window

470 VisualAge RPG Manual de consulta de componentes

Page 489: Manual Ibm

EnterEn un recuadro de combinación, contenedor, recuadro de lista, subarchivo demensajes y subarchivo, este evento se produce cuando:v El usuario efectúa una doble pulsación en el componente.v El usuario pulsa la tecla Intro cuando el componente tiene el foco y se ha

seleccionado un elemento.

En el caso de un botón de selección, este evento se produce cuando se efectúa unadoble pulsación en el componente.

Se aplica a los componentes

Recuadro decombinación

Contenedor Recuadro de lista* Subarchivo demensajes

Botón de selección Subarchivo

* Restricción: Este evento no está soportado en tiempo de ejecución en lasaplicaciones Java para este componente.

Atributos de evento

%EventName %Part %Window

ExecuteAckEste evento se produce cuando la aplicación servidor ha procesado un mandatoExecute. El atributo de evento %Complete indica si la ejecución ha sido correcta.

Se aplica a los componentes

Cliente DDE

Atributos de evento

%Complete %Data %EventName %Part%Window

ExpandedEste evento se produce al ampliar un nodo de un contenedor de la vista de árbol.Este evento se puede utilizar para cambiar el icono de un registro para quemuestre el estado.

Se aplica a los componentes

Contenedor

Atributos de evento

%EventName %Part %Window

Capítulo 3. Eventos de componentes 471

Page 490: Manual Ibm

FirstRecEste evento se produce cuando se selecciona el botón de ″primer registro″ de labarra de navegación.

Se aplica a los componentes

Subarchivo

Atributos de evento

%EventName %Part %Window

GotFocusEste evento se produce cuando el componente recibe el foco de entrada. Esto seproduce cuando el usuario mueve el cursor a un componente habilitado o si se haestablecido el foco en este componente mediante el atributo Focus. El componentedebe estar habilitado para recibir este evento.

Se aplica a los componentes

Recuadro decombinación

Contenedor Campo de entrada Pulsador gráfico

Recuadro de lista Edición de múltipleslíneas

Pulsador Graduador

Selector cíclico Subarchivo

Atributos de evento

%EventName %Part %Window

KeyPressEste evento se produce cuando se pulsa una tecla y el componente tiene foco deentrada. El componente debe estar habilitado para recibir este evento.

Nota: El atributo ReadOnly no debe estar establecido.

Este evento sólo se produce para teclas de caracteres. Para manejar eventosgenerados mediante teclas que no sean de caracteres, como RePág y AvPág,consulte el evento VKeyPress.

Se aplica a los componentes

Recuadro decombinación

Contenedor Campo de entrada Recuadro de lista

Edición de múltipleslíneas

Subarchivo

Atributos de evento

%Alt %Character %Control %EventName%Part %Shift %Window

472 VisualAge RPG Manual de consulta de componentes

Page 491: Manual Ibm

LastRecEste evento se produce cuando se selecciona el botón de ″último registro″ de labarra de navegación.

Se aplica a los componentes

Subarchivo

Atributos de evento

%EventName %Part %Window

LClickTrayEste evento se produce cuando un usuario pulsa el icono de bandeja del sistemade la aplicación con el botón izquierdo del ratón. La aplicación debe estarregistrada como aplicación de bandeja del sistema mediante la APIShell_NotifyIconA de Windows.

Se aplica a los componentes

Ventana Ventana con lienzo

Atributos de evento

%EventName %Part %Window

Link

* Restricción: Este evento no está soportado en las aplicaciones Java.

Este evento se produce cuando el componente está enlazado a un componenteorigen, utilizando el atributo AddLink, y el componente origen ha cambiado. Elatributo AllowLink debe estar establecido para que el componente origen señaleeste evento.

Se aplica a los componentes

Campo de entrada Imagen Medios Panel de mediosGraduador Selector cíclico Texto estático Temporizador

Atributos de evento

%EventName %Part %Window

LostFocusEste evento se produce cuando el componente deja de tener el foco de entrada.

Se aplica a los componentes

Recuadro decombinación

Contenedor Campo de entrada Pulsador gráfico

Capítulo 3. Eventos de componentes 473

Page 492: Manual Ibm

Recuadro de lista Edición de múltipleslíneas

Pulsador Graduador

Selector cíclico Subarchivo

Atributos de evento

%EventName %Part %Window

MenuSelectEste evento se produce cuando el usuario selecciona una opción de menú con elratón o con la tecla aceleradora.

Este evento no significa que se haya marcado una opción de menú. Paradeterminar si se ha marcado o no un elemento de menú, consulte el atributoChecked del elemento.

Se aplica a los componentes

Opción de menú

Atributos de evento

%EventName %Part %Window

MouseDownEste evento se produce al pulsar un botón del ratón.

Se aplica a los componentes

Calendario Lienzo Contenedor Campo de entradaGráfica Edición de múltiples

líneasTexto estático

Atributos de evento

%Button %EventName %MouseX %MouseY%Part %Window

MouseEnterEste evento se produce al llevar por primera vez el puntero del ratón a uncomponente.

Se aplica a los componentes

Calendario Recuadro de selección Recuadro decombinación

Contenedor

Campo de entrada Gráfica Pulsador gráfico ImagenRecuadro de lista Panel de medios Subarchivo de

mensajesEdición de múltipleslíneas

Pulsador Botón de selección Graduador Selector cíclicoTexto estático Subarchivo

474 VisualAge RPG Manual de consulta de componentes

Page 493: Manual Ibm

Atributos de evento

%EventName %Part %Window

MouseExitEste evento se produce al sacar por primera vez el puntero del ratón de uncomponente.

Se aplica a los componentes

Calendario Recuadro de selección Recuadro decombinación

Contenedor

Campo de entrada Gráfica Pulsador gráfico ImagenRecuadro de lista Panel de medios Subarchivo de

mensajesEdición de múltipleslíneas

Pulsador Botón de selección Graduador Selector cíclicoTexto estático Subarchivo

Atributos de evento

%EventName %Part %Window

MouseMoveEste evento se produce cuando el puntero del ratón se sitúa sobre un componente.Puede utilizar este evento para crear un área de información para informar alusuario sobre la función del componente.

Se aplica a los componentes

Calendario Lienzo Recuadro de selección Recuadro decombinación

Contenedor Campo de entrada Gráfica Pulsador gráficoImagen Recuadro de lista Panel de medios Subarchivo de

mensajesEdición de múltipleslíneas

Pulsador Botón de selección Graduador

Selector cíclico Texto estático Subarchivo

Atributos de evento

%EventName %MouseX %MouseY %Part%Window.

Ejemplo

Crear un área de información cambiando el atributo Label de uncomponente texto estático cuando el puntero del ratón se sitúa en uncomponente:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+.CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq*C PB1 BEGACT MOUSEMOVE*

Capítulo 3. Eventos de componentes 475

Page 494: Manual Ibm

C ST1 SETATR 'Ends program'LABEL*C ENDACT*

MouseUpEste evento se produce al soltar un botón del ratón.

Se aplica a los componentes

Calendario Lienzo Contenedor Campo de entradaGráfica Edición de múltiples

líneasTexto estático

Atributos de evento

%Button %EventName %MouseX %MouseY%Part %Window

MovedEste evento se produce siempre que el usuario mueve una ventana.

Se aplica a los componentes

Ventana

Atributos de evento

%EventName %Part %Window

MthChangeEste evento se produce al seleccionar otro mes pulsando con el ratón en una de lasflechas de mes.

Se aplica a los componentes

Calendario

Atributos de evento

%EventName %Part %Window

NextRecEste evento se produce cuando se selecciona el botón de ″siguiente registro″ de labarra de navegación.

Se aplica a los componentes

Subarchivo

476 VisualAge RPG Manual de consulta de componentes

Page 495: Manual Ibm

Atributos de evento

%EventName %Part %Window

NotifyEn el cuaderno de propiedades del componente referencia a componente lógico,puede especificar un evento asociado con un componente determinado en unaventana especificada. Cuando se produce un evento, cuyo nombre coincide con elvalor del atributo NotSrcEvt, en el componente especificado de la ventanaespecificada, se direcciona un evento Notify al componente referencia acomponente lógico.

Para que se señale un evento Notify, debe existir una subrutina de acción para elevento supervisado. No es necesario que la subrutina contenga código alguno. Sino hay ninguna subrutina de acción, el evento Notify no se producirá.

Se aplica a los componentes

Referencia acomponente lógico

Atributos de evento

%EventName %Part %SrcCompName %SrcEvtName%SrcPartName %SrcWinName Ventana

OCXEvent

* Restricción: Este evento no está soportado en las aplicaciones Java.

Este evento se produce siempre que se produce un evento de control de ActiveX.

Se aplica a los componentes

ActiveX

Atributos de evento

%EventName %Part %RealName %Window

PageDownEste evento se produce cuando se pulsa la tecla Av Pág o cuando se pulsa conratón en el área vacía hacia la parte inferior de la barra de desplazamiento verticalo si selecciona la barra de navegación del botón Av Pág.

Se aplica a los componentes

Subarchivo

Atributos de evento

%EventName %Part %Window

Capítulo 3. Eventos de componentes 477

Page 496: Manual Ibm

PageEndEste evento se produce cuando se pulsa la tecla Av Pág o la tecla Flecha abajo,cuando se pulsa con el ratón en el área vacía de la parte inferior de la barra dedesplazamiento vertical o cuando se arrastra el graduador por la barra dedesplazamiento hasta el final de la lista de subarchivos cuando se visualiza elúltimo registro de un subarchivo. En este caso, no se envía el evento PageDown,ya que ya se ha llegado al final de la lista. En su lugar, se envía un eventoPageEnd.

Se aplica a los componentes

Subarchivo

Atributos de evento

%EventName %Part %Window

PageSelectEste evento se produce cuando el usuario selecciona una página de cuaderno enuna sección nueva del cuaderno mediante la pestaña correspondiente.

El atributo de evento %Page devolverá el número de la página seleccionada.

Se aplica a los componentes

Página de cuaderno

Atributos de evento

%EventName %Page %Part %Window

PageTopEste evento se produce cuando se pulsa la tecla Re Pág o la tecla Flecha arriba,cuando se pulsa con el ratón en el área vacía de la parte superior de la barra dedesplazamiento vertical o cuando se arrastra el graduador por la barra dedesplazamiento hasta el principio de la lista de subarchivos. En este caso, no seenvía el evento PageUp.

Se aplica a los componentes

Subarchivo

Atributos de evento

%EventName %Part %Window

PageUpEste evento se produce cuando se pulsa la tecla Re Pág, si el usuario pulsa el botónsobre el área vacía de la parte suyperior de la barra de desplazamiento vertical obien si seleccione el botón de navegación Re Pág.

478 VisualAge RPG Manual de consulta de componentes

Page 497: Manual Ibm

Se aplica a los componentes

Subarchivo

Atributos de evento

%EventName %Part %Window

PokeAckEste evento se produce cuando la aplicación servidor, en una conversación DDE,ha procesado un mandato Poke. El atributo de evento %Complete indica si elmandato poke se ha realizado satisfactoriamente.

Se aplica a los componentes

Cliente DDE

Atributos de evento

%Complete %Data %EventName %Item%Part %Window

Ejemplo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+.CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq*C DDE1 BEGACT POKEACK*C %COMPLETE IFNE *ZEROC 'Poke failed' DSPLY style X*C ENDIF*C ENDACT*

PopupEste evento se produce cuando el puntero del ratón se sitúa sobre un componentey se pulsa el botón derecho del ratón.

Se aplica a los componentes

Lienzo Recuadro de selección Recuadro decombinación

Contenedor

Campo de entrada Pulsador gráfico Recuadro de lista Panel de mediosSubarchivo demensajes

Edición de múltipleslíneas

Pulsador Botón de selección

Graduador Selector cíclico Texto estático Subarchivo

Atributos de evento

%ColNumber %EventName %Index %MouseX%MouseY %Part %Window

Capítulo 3. Eventos de componentes 479

Page 498: Manual Ibm

PressEste evento se produce cuando el usuario pulsa el botón del ratón en elcomponente o cuando pulsa la tecla Intro cuando el componente tiene el foco deentrada.

Se aplica a los componentes

Pulsador gráfico Panel de medios Pulsador

Atributos de evento

%EventName %Part %Window

PrevRecEste evento se produce cuando se selecciona el botón de ″registro anterior″ de labarra de navegación.

Se aplica a los componentes

Subarchivo

Atributos de evento

%EventName %Part %Window

RClickTrayEste evento se produce cuando un usuario pulsa el icono de bandeja del sistemade la aplicación con el botón derecho del ratón. La aplicación debe estar registradacomo aplicación de bandeja del sistema mediante la API Shell_NotifyIconA deWindows.

Se aplica a los componentes

Ventana Ventana con lienzo

Atributos de evento

%EventName %Part %Window

ReSizeEste evento se produce cuando se ha cambiado el tamaño del componente. Porejemplo, puede producirse si el usuario cambia el tamaño de una ventanautilizando el borde para ajustar el tamaño, o si cambia el tamaño del componenteestableciendo el atributo Height o Width.

Puede utilizar este evento para reubicar o mover componentes de una ventanacuando el usuario cambie el tamaño de la ventana.

Durante el evento ReSize, los atributos Height y Width contienen el tamaño actualde la ventana, mientras que los atributos de evento %NewHeight y %NewWidthcontienen el tamaño de la ventana una vez completado el evento ReSize.

480 VisualAge RPG Manual de consulta de componentes

Page 499: Manual Ibm

Se aplica a los componentes

Ventana

Atributos de evento

%EventName %NewHeight %NewMode* %NewWidth%Part %Window

*Nota: Consulte la descripción del atributo si desea saber cuáles son lasrestricciones.

ScrollEste evento se produce al pulsar la flecha de desplazamiento de un componentebarra de desplazamiento horizontal o vertical. El atributo de evento %Positioncontiene la posición del recuadro de desplazamiento cuando el usuario deja dedesplazarse.

Se aplica a los componentes

Barra dedesplazamientohorizontal

Barra dedesplazamientovertical

Atributos de evento

%EventName %Part %Position %Window

SelectEste evento se produce cuando el usuario selecciona un componente pulsandosobre el mismo con el ratón o utilizando las teclas de flechas. En un recuadro decombinación, contenedor, recuadro de lista, subarchivo de mensajes y subarchivo,este evento se produce cuando se selecciona un elemento de la lista.

Se aplica a los componentes

Recuadro de selección Recuadro decombinación

Contenedor Recuadro de lista

Subarchivo demensajes

Botón de selección Subarchivo

Atributos de evento

%ColNumber %EventName %Index %Part%Window

ShutDownEste evento se produce cuando el constructor GUI finaliza y se ha especificado elhandle de ventana en el mandato de conector NotifyOnClose. Este evento se puedeutilizar para supervisar todos los conectores que se ejecutan desde el constructorGUI y además cerrarlos.

Capítulo 3. Eventos de componentes 481

Page 500: Manual Ibm

Se aplica a los componentes

Ventana

Atributos de evento

%EventName %Part %Window

SpinDownEste evento se produce cuando el usuario selecciona el botón de flecha abajo de uncomponente selector cíclico.

Se aplica a los componentes

Selector cíclico

Atributos de evento

%EventName %Part %Window

SpinEndEste evento se produce cuando el usuario suelta el botón de flecha arriba o deflecha abajo de un componente selector cíclico.

Se aplica a los componentes

Selector cíclico

Atributos de evento

%EventName %Part %Window

SpinUpEste evento se produce cuando el usuario selecciona el botón de flecha arriba deun componente selector cíclico.

Se aplica a los componentes

Selector cíclico

Atributos de evento

%EventName %Part %Window

TerminateEste evento se produce cuando el servidor, en una conversación DDE, ha solicitadoque termine la conversación, o cuando el componente cliente DDE tiene su atributoDDEMode establecido en Terminate.

482 VisualAge RPG Manual de consulta de componentes

Page 501: Manual Ibm

Se aplica a los componentes

Cliente DDE

Atributos de evento

%EventName %Part %Window

Ejemplo*...1....+....2....+....3....+....4....+....5....+....6....+....7....+.CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq*C PB1 BEGACT TERMINATE*C 'Terminating' DSPLY STYLE X*C ENDACT*

TickEste evento se produce cada vez que transcurre el valor de intervalo deltemporizador. El atributo Multiplier también determina cuándo se generará elevento Tick.

Se aplica a los componentes

Temporizador

Atributos de evento

%EventName %Part %Window

EjemploActualizar un componente texto estático con el valor de impulso actual deun componente temporizador:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+.CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq*C TIMER1 BEGACT TICK*C 'TIMER1' GETATR TIMERTICKS timerticks 6 0C ST1 SETATR timerticks 'LABEL'*C ENDACT*

TimeoutEste evento se produce cuando no se ha establecido la conversación DDE en eltiempo definido por el atributo TimeOut.

Se aplica a los componentes

Cliente DDE

Atributos de evento

%EventName %Part %Window

Ejemplo

Capítulo 3. Eventos de componentes 483

Page 502: Manual Ibm

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+.CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq*C DDE1 BEGACT TIMEOUT*C 'DDE Failed!' DSPLY STYLE XC ENDACT*

VKeyPressEste evento se produce cuando se pulsa una tecla de mandato. Como ejemplos deteclas de mandato se pueden citar AvPág, Pausa y Control. Para obtener unadescripción del valor devuelto, consulte el atributo de evento %Character.

Se aplica a los componentes

Recuadro decombinación

Contenedor Campo de entrada Recuadro de lista

Edición de múltipleslíneas

Subarchivo

Atributos de evento

%Alt %Character %Control %EventName%Part %Shift %Window

Ejemplo

Borrar un campo de entrada si se pulsa F5 cuando el campo tiene el focode entrada:*...1....+....2....+....3....+....4....+....5....+....6....+....7....+.CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq*C EF1 BEGACT VKEYPRESS*C %character IFEQ '29'C 'EF1' SETATR *BLANKS 'TEXT'C ENDIF*C ENDACT*

YearChangeEste evento se produce al seleccionar otro año pulsando con el ratón en una de lasflechas de año o en una flecha de mes de modo que se cambie el año.

Se aplica a los componentes

Calendario

Atributos de evento

%EventName %Part %Window

484 VisualAge RPG Manual de consulta de componentes

Page 503: Manual Ibm

Capítulo 4. Atributos de eventos

Los atributos de evento contienen datos relevantes para el evento que se estámanejando. La aplicación del usuario no puede modificarlos. Deben estar definidosen la especificación de Definición con el tipo y la longitud correctos. La tablasiguiente lista los atributos de evento con sus tipos de datos y longitudescorrespondientes:

Atributo de evento Tipo de datos Longitud

%Alt Numérico 1

%Button Numérico 1

%Character Serie 1¹

%ColNumber Numérico *

%Complete Numérico 1

%Control Numérico 1

%Data Serie *

%EventName Serie 10

%Index Numérico *

%Item Serie *

%MouseX Numérico 4

%MouseY Numérico 4

%NewHeight Numérico 4

%NewMode Numérico 1

%NewWidth Numérico 4

%Page Numérico 3

%Part Serie 10

%Position Numérico 4

%RealName Serie 10

%Shift Numérico 1

%SrcCompName Serie 10

%SrcEvtName Serie 10

%SrcPartName Serie 10

%SrcWinName Serie 10

%Window Serie 10

*Defina la longitud como sea necesario.

¹Para VKeyPress, la longitud es 2.

Ejemplo:DName+++++++++++ETDsFrom+++To/L+++IDc.Keywords++++++++++++++++++++++++++++** Declarar el atributo de evento %Button

© Copyright IBM Corp. 1994, 2000 485

|||

Page 504: Manual Ibm

D %Button S 1P 0** Declarar el atributo de evento %Data

D %Data S 32A

Este capítulo describe los atributos de evento. Cada una de las descripcionescontiene lo siguiente:v El tipo de datos del atributo de eventov Una descripción general del atributo de eventov Una lista de los eventos a los que se aplica el atributo

%AltIndica si la tecla Alt estaba pulsada cuando se ha producido el evento:

0 La tecla Alt no se ha pulsado

1 Se ha pulsado la tecla Alt

Tipo Numérico

Eventos a los que puede aplicarse

KeyPress VKeyPress

%ButtonIndica qué botón del ratón estaba pulsado durante el evento:

1 Botón 1

2 Botón 2

3 Botón 3

4 Botones 1 y 2

Tipo Numérico

Eventos a los que puede aplicarse

Click DblClick MouseDown MouseUp

%CharacterCódigo de carácter generado por el evento.

Durante el evento VKeyPress, el atributo de evento %Character se devolverá comoun valor que representa la tecla no de carácter que se ha pulsado. Los valores sonlos siguientes:

00 – Esc 13 – Fin 25 – Inter 37 – F1401 – Tabulador →| 14 – Retroceso de

página26 – F2 38 – F15

02 – Tabulador |← 15 – Avance depágina

27 – F3 39 – F16

03 – Espacio 16 – ← (Izquierda) 28 – F4 40 – F1704 – ←Retroceso 17 – → (Derecha) 29 – F5 41 – F1805 – Intro (tecladonumérico)

18 – ↑ (Arriba) 30 – F6 42 – F19

486 VisualAge RPG Manual de consulta de componentes

Page 505: Manual Ibm

06 – Intro 19 – ↓ (Abajo) 31 – F7 43 – F2007 – Mayús 20 – Bloqueo

Mayúsculas32 – F8 44 – F21

08 – Control 21 – BloqueoNumérico

33 – F9 45 – F22

09 – Alt 22 – Bloqueo Mayús 34 – F11 46 – F2310 – Insertar 23 – Pausa 35 – F12 47 – F2411 – Suprimir 24 – PetSis 36 – F13 56 – Alt12 – Inicio

Tipo Serie

Eventos a los que puede aplicarse

Keypress VKeyPress

%ColNumberDevuelve el número de columna para un componente subarchivo o contenedor.

Tipo Numérico

Eventos a los que puede aplicarse

Change ColSelect Popup Select

%CompleteIndica si la operación anterior se ha realizado de manera satisfactoria o no:

0 Operación no satisfactoria

1 Operación satisfactoria.

Tipo Numérico

Eventos a los que puede aplicarse

Complete ExecuteAck PokeAck

%ControlIndica si la tecla Control estaba pulsada cuando se ha producido el evento:

0 La tecla Control no se ha pulsado.

1 La tecla Control se ha pulsado.

Tipo Numérico

Eventos a los que puede aplicarse

KeyPress VKeyPress

Capítulo 4. Atributos de eventos 487

Page 506: Manual Ibm

%DataContiene los datos enviados por una aplicación de servidor como respuesta a unmandato Request. El contenido y la estructura de estos datos los determina laaplicación servidor.

Este atributo de evento también está disponible con el evento PokeAck. Contendrálos datos originales con los que se ha efectuado la operación Poke.

Tipo Serie

Eventos a los que puede aplicarse

Data Drop ExecuteAck PokeAck

%EventNameDevuelve el nombre del evento.

Tipo Serie

Eventos a los que puede aplicarse

A todos

%IndexDevuelve el número de índice del registro en el que está situado el puntero delratón cuando se produce un evento Popup o Select. No es preciso que el registrotenga el foco.

Tipo Numérico

Eventos a los que puede aplicarse

Change Popup Select

%ItemContiene el nombre del elemento que participa actualmente en una conversaciónDDE.

Tipo Serie

Eventos a los que puede aplicarse

Data PokeAck

%MouseXLa coordenada X de la ubicación actual del puntero del ratón en el componentecuando se ha producido el evento. Se expresa en pixels. Es un valor comprendidoentre cero y la anchura del componente. El valor cero representa el borde izquierdodel componente.

Nota: En el caso del evento MouseMove, esta coordenada es relativa al escritorio.

Tipo Numérico

488 VisualAge RPG Manual de consulta de componentes

Page 507: Manual Ibm

Eventos a los que puede aplicarse

Click DblClick MouseDown MouseMoveMouseUp Popup

%MouseYLa coordenada Y de la ubicación actual del puntero del ratón en el componentecuando se ha producido el evento. Se expresa en pixels. Es un valor comprendidoentre cero y la altura del componente. El valor cero representa el borde inferior delcomponente.

Nota: En el caso del evento MouseMove, esta coordenada es relativa al escritorio.

Tipo Numérico

Eventos a los que puede aplicarse

Click DblClick MouseDown MouseMoveMouseUp Popup

%NewHeightEs la altura del componente después de cambiar el tamaño del mismo.

Nota: El atributo Height del componente no cambia hasta que la subrutina deacción correspondiente al evento ReSize ha terminado.

Tipo Numérico

Eventos a los que puede aplicarse

ReSize

%NewMode

* Restricción: Este atributo no está soportado en las aplicaciones Java.

Indica en qué modalidad se establecerá la ventana:

1 Maximizada

2 Minimizada

3 Restaurada

Tipo Numérico

Eventos a los que puede aplicarse

ReSize

%NewWidthEs la anchura del componente después de cambiar el tamaño del mismo.

Capítulo 4. Atributos de eventos 489

Page 508: Manual Ibm

Nota: El atributo Width del componente no cambia hasta que la subrutina deacción correspondiente al evento ReSize ha terminado.

Tipo Numérico

Eventos a los que puede aplicarse

ReSize

%PageDevuelve el número de página de la página seleccionada cuando se produce elevento PageSelect.

Tipo Numérico

Eventos a los que puede aplicarse

PageSelect

%PartContiene el nombre del componente que genera el evento.

Tipo Serie

Eventos a los que puede aplicarse

A todos

%PositionDevuelve la posición actual del recuadro de desplazamiento cuando el usuario dejade desplazarse.

Tipo Numérico

Eventos a los que puede aplicarse

Scroll

%RealNameDevuelve el nombre real del evento de ActiveX que se produce.

Tipo Serie

Eventos a los que puede aplicarse

OCXEvent

%ShiftIndica si se ha pulsado la tecla Mayús cuando se ha producido el evento:

0 La tecla Mayús no se ha pulsado

1 Se ha pulsado la tecla Mayús

490 VisualAge RPG Manual de consulta de componentes

Page 509: Manual Ibm

Tipo Numérico

Eventos a los que puede aplicarse

KeyPress VKeyPress

%SrcCompNameCuando se envía un evento Notify al componente referencia a componente lógico,este atributo de evento devuelve el nombre del componente lógico del evento denotificación. Si se utiliza un componente referencia a componente lógico parasupervisar varios eventos, este atributo de evento puede determinar el origenexacto del evento que desencadena el evento Notify utilizando el atributo%SrcCompName en combinación con los atributos %SrcWinName, %SrcPartNamey %SrcEvtName.

Tipo Serie

Eventos a los que puede aplicarse

Notify

%SrcEvtNameCuando se envía un evento Notify al componente referencia a componente lógico,este atributo de evento devuelve el nombre del evento que se estableció en elatributo NotSrcEvt, junto con un componente y una ventana determinados, paradesencadenar un evento Notify al componente referencia a componente lógico.

Tipo Serie

Eventos a los que puede aplicarse

Notify

%SrcPartNameCuando se envía un evento Notify al componente referencia a componente lógico,este atributo de evento devuelve el nombre del componente que se estableció en elatributo NotSrcPart, junto con un componente y una ventana determinados, paradesencadenar un evento Notify al componente referencia a componente lógico.

Tipo Serie

Eventos a los que puede aplicarse

Notify

%SrcWinNameCuando se envía un evento Notify al componente referencia a componente lógico,este atributo de evento devuelve el nombre de la ventana que se estableció en elatributo NotSrcWin, junto con un componente y un evento determinados, paradesencadenar un evento Notify al componente referencia a componente lógico.

Tipo Serie

Capítulo 4. Atributos de eventos 491

|

|||||||

||

|

||||||

|

Page 510: Manual Ibm

Eventos a los que puede aplicarse

Notify

%WindowIndica el nombre de la ventana que contiene el componente que ha generado elevento.

Tipo Serie

Eventos a los que puede aplicarse

A todos

492 VisualAge RPG Manual de consulta de componentes

Page 511: Manual Ibm

Glosario

Este glosario incluye términos y definiciones de:v El American National Dictionary for Information Systems ANSI X3.172-1990,

copyright 1990 del American National Standards Institute (ANSI). Si deseaadquirir una copia de esta publicación debe dirigirse al American NationalStandards Institute, 1430 Broadway, New York, New York, 10018. Lasdefiniciones se especifican mediante el símbolo (A) después de las mismas.

v El Information Technology Vocabulary desarrollado por el Subcomité 1, ComitéTécnico Conjunto 1, de International Organization for Standardization y elInternational Electrotechnical Committee (ISO/IEC JTC1/SC1). Las definicionesde las partes publicadas de este vocabulario se identifican mediante el símbolo(|) después de las mismas; las definiciones tomadas de borradores de estándaresinternacionales, borradores del comité y documentos de trabajo desarrolladospor ISO/IEC JTC1/SC1 se identifican mediante el símbolo (T) después de lasmismas, lo cual indica que aún no se ha alcanzado un acuerdo definitivo entrelos Organismos Nacionales integrantes del SC1.

v IBM Dictionary of Computing, New York: McGraw-Hill, 1994.v Object-Oriented Interface Design IBM Common User Interface Guidelines,

SC34-4399-00, Carmel, IN: Que Corporation, 1992.

Aacción. (1) Sinónimo de subrutina de acción. (2) Programa ejecutable o archivo de mandatos utilizado para manipularlos componentes de un proyecto o participar en una construcción.

acción por omisión. Acción que se efectúa cuando se realiza otra como, por ejemplo, pulsar la tecla Intro.

alias de servidor. Nombre que el usuario define y que puede utilizarse en lugar del nombre del servidor.

ancla. Cualquier componente que se utiliza como punto de referencia para alinear, dimensionar y espaciar otroscomponentes.

anotaciones de error. Realiza un seguimiento de los errores en las anotaciones de error. El editor le lleva al lugardel código fuente en el que se ha producido el error.

API. Interfaz de programación de aplicaciones.

aplicación. Un grupo de componentes de software utilizados para efectuar tareas de usuario específicas en unsistema.

applet. Programa escrito en Java que se ejecuta dentro de un navegador compatible con Java o AppletViewer.

archivo. Grupo de datos relacionados que se almacenan y se recuperan mediante un nombre asignado. Un archivopuede incluir información que inicia un programa (objeto de archivo de programa), contiene texto o gráficos (objetode archivo de datos) o procesa una serie de mandatos (archivo por lotes).

archivo de mensajes. Archivo que contiene mensajes de aplicación. Este archivo se crea a partir del archivo fuentede mensajes durante el proceso de construcción. Véase también construir.

archivo de ondas. Archivo utilizado para sonidos audio en un dispositivo de forma de onda.

archivo de Recurso de Presentación de Información (IPF). Archivo en el que se almacena el fuente de la ayuda dela aplicación.

archivo MIDI. Archivo de la Interfaz Digital de Instrumentos Musicales.

© Copyright IBM Corp. 1994, 2000 493

Page 512: Manual Ibm

archivos JAR (.jar). En Java, abreviatura de Java ARchive. Es un formato de archivo que se utiliza para agregarvarios archivos en uno.

área común. Área de almacenamiento proporcionada por el sistema para retener datos temporalmente. Los datos delárea común están disponibles para otras aplicaciones.

área de cliente. La parte de la ventana que es el espacio de trabajo del usuario donde éste teclea información yselecciona opciones de campos de selección. En ventanas primarias, el área en la que un programador de aplicacionespresenta los objetos con los que trabaja el usuario.

área de información. Componente de una ventana en el que se visualiza información sobre el objeto o la opción enlos que se encuentra el cursor. El área de información también puede incluir un mensaje sobre la conclusión normalde un proceso. Véase también barra de estado.

área de trabajo. Área utilizada para organizar objetos de acuerdo a las tareas del usuario. Cuando un usuario cierraun área de trabajo, todas las ventanas abiertas a partir de objetos contenidos en el área de trabajo se eliminan dellugar de trabajo.

Arquitectura Common User Access (arquitectura CUA). Directrices para el diálogo entre una persona y unaestación de trabajo o un terminal.

arquitectura CUA. Arquitectura de Acceso Común de Usuario.

arrastrar. Mover o copiar un objeto utilizando el ratón. Por ejemplo, un usuario puede arrastrar el borde de unaventana para hacerla más grande pulsando un botón del ratón y manteniéndolo pulsado mientras mueve el ratón.Véase también arrastrar y soltar.

arrastrar y soltar. Manipular directamente un objeto moviéndolo y colocándolo en cualquier lugar utilizando elratón.

ASCII (American National Standard Code for Information Interchange). Código estándar, que se compone de unjuego de caracteres codificados de 7 bits (8 bits incluyendo comprobación de paridad), que se utiliza para elintercambio de información entre sistemas de proceso de datos, sistemas de comunicación de datos y equipoasociado. El juego de caracteres ASCII se compone de caracteres de control y caracteres gráficos. (A)

atenuado. Atenuación del contraste visual de un componente que indica que el usuario no puede seleccionar nimanipular directamente ese componente.

Bbarra de desplazamiento. Componente que muestra a un usuario que hay más información disponible en unadirección determinada y que puede moverse para visualizar dicha información utilizando el ratón o las teclas depágina.

barra de estado. Componente de una ventana que visualiza información que indica el estado de la vista o del objetoactuales. Véase también área de información.

barra de herramientas. Menú que contiene una o más opciones gráficas que representan las acciones que un usuariopuede efectuar utilizando el ratón.

barra de títulos. Área en la parte superior de cada ventana que contiene el símbolo del menú del sistema.

base de datos. (1) Grupo de datos con una estructura determinada para aceptar, almacenar y proporcionar, previapetición, datos para varios usuarios. (T) (2) Todos los archivos de datos almacenados en el sistema.

Biblioteca de enlace dinámico (DLL). Archivo que contiene código ejecutable y datos enlazados de manera lógica aun programa durante el tiempo de carga o el de ejecución, en lugar de durante el enlace. Varias aplicaciones puedencompartir a la vez el código y los datos de una biblioteca de enlace dinámico.

BMP. Extensión de archivo de un archivo bitmap.

borde de dimensionamiento. Borde de un marco alrededor de un componente (o conjunto de componentes) que seselecciona para cambiar el tamaño del componente (o del conjunto de componentes) utilizando el ratón o el teclado.

494 VisualAge RPG Manual de consulta de componentes

Page 513: Manual Ibm

borde de selección. Borde visual que aparece alrededor de un componente de VARPG o de un componente creadopor el usuario, que permite moverlo con el ratón o el teclado.

botón. (1) Mecanismo en un dispositivo de puntero, como un ratón, utilizado para solicitar o iniciar una acción. (2)Mecanismo gráfico en una ventana que, cuando se selecciona, produce una acción. Por ejemplo, el pulsador Bien que,al seleccionarse, inicia una acción.

botón 2 del ratón. Por omisión, el botón derecho del ratón; se utiliza para manipular.

botón 1 del ratón. Por omisión, el botón izquierdo del ratón; se utiliza para seleccionar.

botón de manipulación. Véase botón 2 del ratón.

botón de maximizar. Botón en la parte más a la derecha de una barra de título sobre el que un usuario pulsa elbotón del ratón para aumentar el tamaño de la ventana lo máximo posible. Compárese con botón de minimizar y botónde ocultar.

botón de minimizar. Botón, ubicado junto al botón que está más a la derecha en una barra de título, que reduce eltamaño de la ventana lo máximo posible. Compárese con botón de maximizar y botón de ocultar.

botón de ocultar. Botón en una barra de título sobre el que un usuario pulsa el botón del ratón para suprimir unaventana del lugar de trabajo sin cerrarla. Cuando la ventana está oculta, el estado de la misma, indicado en la lista deventanas, cambia. Compárese con botón de maximizar y botón de minimizar.

botón de ratón. Mecanismo en un ratón para seleccionar opciones, iniciar acciones o manipular objetos con elpuntero. Véase también botón 1 del ratón y botón 2 del ratón.

botón de restaurar. Botón que aparece en la esquina más a la derecha de la barra de título después de habermaximizado una ventana. Cuando se selecciona el botón de restaurar, la ventana vuelve a tener el tamaño y laposición que tenía antes de que se maximizara. Véase también botón de maximizar.

botón de selección. Véase botón 1 del ratón.

Ccampo. (1) Área identificable en una ventana, como un campo de entrada, en la que un usuario escribe texto. (2)Grupo de bytes relacionados, como un nombre o una cantidad, que se trata como una unidad en un registro.

campo de referencia. Campo de la base de datos de AS/400 cuyas características un componente campo de entradapuede heredar.

campo de subarchivo. Campo utilizado para definir campos en un componente subarchivo. Véase también camposubarchivo.

Capa de Sockets Segura (SSL). Esquema de seguridad de gran aceptación desarrollado por NetscapeCommunications Corp. y RSA Data Security, Inc. SSL permite al cliente autenticarse en el servidor y cifrar todos losdatos y peticiones. El URL de un servidor seguro protegido mediante SSL empieza por https en lugar de http.

carpeta destino. Objeto en el que se coloca el icono que representa una aplicación VARPG.

catálogo de componentes. Espacio de almacenamiento para todos los componentes utilizados para crear interfacesgráficas de usuario para aplicaciones VARPG.

cliente. (1) Sistema que depende de un servidor para obtener datos. (2) La PWS donde se ejecutan las aplicacionesVARPG. Véase también cliente DDE.

cliente DDE. Aplicación que inicia una conversación DDE. Compárese con servidor DDE. Véase también componentecliente DDE y conversación DDE.

cliente/servidor. Modelo de interacción en el proceso de datos distribuidos en el que un programa en una ubicaciónenvía una petición a un programa en otra ubicación y espera una respuesta. El programa que efectúa la peticiónrecibe el nombre de cliente; y el programa que responde, servidor. Véase también cliente, servidor, cliente DDE, servidorDDE.

Glosario 495

Page 514: Manual Ibm

compilar. Convertir un programa fuente en un programa ejecutable (programa objeto).

complemento. Función creada por el usuario o un proveedor externo que se puede utilizar en los programasVARPG.

componente barra de desplazamiento horizontal. Componente que añade una barra de desplazamiento horizontala una ventana. Este componente permite desplazarse por un panel de información de izquierda a derecha oviceversa.

componente barra de desplazamiento vertical. Componente que añade una barra de desplazamiento vertical a unaventana. Este componente permite desplazarse por un panel de información verticalmente.

componente barra de estado. Componente de una ventana que puede visualizar información adicional sobre unproceso o acción de la ventana.

componente barra de menús. Área que está junto a la parte superior de la ventana, debajo de la barra de título yencima del resto de la ventana, que contiene opciones que proporcionan acceso a otros menús. En VisualAge RPG, seseñala y pulsa un componente barra de menús de la paleta de componentes o del catálogo de componentes y sesuelta en una ventana de diseño.

componente barra de progreso. Componente que se puede utilizar para indicar el progreso de un proceso como,por ejemplo, copiar archivos, cargar una base de datos, etc. de forma gráfica.

componente bean Java. Componente que permite a las aplicaciones VARPG acceder a los JavaBean de SunMicrosystem.

componente botón de selección. Círculo con texto al lado. Los botones de selección se combinan para mostrar a unusuario un conjunto fijo de opciones de entre las que sólo puede seleccionarse una. Cuando se selecciona una opción,el círculo se rellena parcialmente. Puede señalar y pulsar un componente botón de selección de la paleta decomponentes o del catálogo de componentes y soltarlo en una ventana de diseño.

componente calendario. Componente que añade un calendario que puede ser modificado por el usuario para incluirtexto, color u otros atributos.

componente campo de entrada. Área de una pantalla donde un usuario pueden entrar información, a menos que elcampo sea de sólo lectura. Normalmente, los límites de un campo de entrada están indicados. En VisualAge RPG, seseñala y pulsa un componente campo de entrada de la paleta de componentes o del catálogo de componentes y sesuelta en una ventana de diseño.

componente cliente DDE. Componente utilizado para intercambiar datos con otras aplicaciones como, por ejemplo,aplicaciones de hoja de cálculo, que soportan el protocolo de intercambio de datos dinámico (DDE).

componente *component. Componente que es la “representación de componente” del componente lógico. Para cadacomponente lógico se crea un componente *component, que no se visualiza.

componente contenedor. Componente que almacena registros relacionados y los visualiza en una vista de detalles,de icono o de árbol.

componente control de animación. Componente que permite reproducir archivos de vídeo, con la extensión AVI, enWindows, o reproducir secuencias GIF de animación en aplicaciones Java.

componente cuaderno. Representación gráfica de un cuaderno. Puede añadir páginas de cuaderno al componentecuaderno y agrupar las páginas en secciones separadas por hojas separadoras con pestañas. En Windows, a veces sehace referencia al cuaderno como el control de pestaña de Windows. Véase también componente página de cuaderno ycomponente página de cuaderno con lienzo.

componente de activeX. Componente que añade objetos de control ActiveX al proyecto. Las aplicaciones VARPGpueden acceder así a los atributos y supervisar si hay eventos.

componente definido por el usuario. Componente, que se compone de uno o más componentes que el usuario hapersonalizado, que se guarda en la paleta de componentes o en el catálogo de componentes para volver a utilizarlo.Cuando está en la paleta o en el catálogo, este componente se puede señalar y pulsar en la ventana de diseño talcomo se haría con otro componente de VARPG.

496 VisualAge RPG Manual de consulta de componentes

Page 515: Manual Ibm

componente destino. Componente que, siempre que cambia el estado del componente fuente, recibe un evento link(de enlace) del componente fuente.

componente de subarchivo. Componente utilizado para visualizar una lista de registros que constan de varioscampos. Este componente es similar a un subarchivo de AS/400. Véase también campo de subarchivo.

componente edición de múltiples líneas (MLE). Componente que representa un campo de entrada que permite alusuario entrar varias líneas de texto.

componente elemento de menú. Componente que es un elemento gráfico o de texto en un menú. Cuando elusuario desea trabajar con un objeto, selecciona un elemento de menú.

componente fuente. Componente que, siempre que cambia su estado, puede notificarlo a los componentes dedestino. Un componente origen puede tener varios destinos.

componente graduador. Componente visual de una interfaz de usuario que representa una cantidad y su relacióncon el rango de posibles valores para esa cantidad. El usuario también puede modificar el valor de la cantidad.Puede señalar y pulsar un componente graduador de la paleta de componentes o del catálogo de componentes ysoltarlo en una ventana de diseño.

componente gráfica. Componente que permite al usuario añadir un gráfico a la GUI. Los estilos de gráficodisponibles son el diagrama de líneas, de barras, de líneas y barras y circular.

componente imagen. Componente utilizado para visualizar una imagen, de un archivo BMP o ICO, en una ventana.

componente lienzo. Componente en el que puede señalar y pulsar otros componentes, colocarlos y organizarlospara producir una interfaz gráfica de usuario. El componente lienzo ocupa el área de cliente de un componenteventana o de un componente página de cuaderno. Véase también componente página de cuaderno con lienzo ycomponente ventana con lienzo.

componente lógico. Agrupación funcional de archivos relacionados dentro de un proyecto. Un componente lógicose crea cuando las especificaciones de control no contienen palabras clave NOMAIN y EXE.

componente lógico compartido. Componente lógico al que puede accederse a través de más de un proyecto.

componente medios. Componente que proporciona a un programa la posibilidad de procesar archivos de sonido(.WAV) y archivos de vídeo (.MID).

componente menú emergente. Componente que, cuando se añade a un objeto en la interfaz, aparece junto al objetocon el que está asociado cuando se solicita. Puede señalar y pulsar un componente menú emergente de la paleta decomponentes o del catálogo de componentes y soltarlo en una ventana de diseño.

componente odbc/jdbc. Componente que permite a las aplicaciones VAPRG acceder y procesar archivos de base dedatos que den soporte a la API ODBC de Windows o la API JDBC de Sun Microsystem.

componente página de cuaderno. Componente utilizado para añadir páginas a un componente cuaderno. Véasetambién cuaderno.

componente página de cuaderno con lienzo. Combinación del componente cuaderno y del componente página conlienzo. Véase también cuaderno y componente lienzo.

componente panel de medios. Componente utilizado para proporcionar al usuario control sobre otros componentes.Por ejemplo, un componente panel de medios puede utilizarse para controlar el volumen de un componente medios.

componente pulsador. Botón etiquetado con texto que representa una acción que se inicia cuando un usuarioselecciona el pulsador. Puede señalar y pulsar un componente pulsador de la paleta de componentes o del catálogode componentes y soltarlo en una ventana de diseño. Véase también componente pulsador gráfico.

componente pulsador gráfico. Pulsador, etiquetado con un gráfico, que representa una acción que se inicia cuandoun usuario lo selecciona. Compárese con componente pulsador.

componente recuadro de contorno. Componente que es un recuadro rectangular colocado alrededor de un grupo decomponentes para indicar que todos los componentes están relacionados.

Glosario 497

Page 516: Manual Ibm

componente recuadro de grupo. Marco rectangular alrededor de un grupo de controles que indica que estánrelacionados y que proporciona una etiqueta opcional para el grupo. En VisualAge RPG, se señala y pulsa uncomponente recuadro de grupo de la paleta de componentes o del catálogo de componentes y se suelta en unaventana de diseño.

componente recuadro de lista. Control que contiene opciones desplazables que un usuario puede seleccionar. EnVisualAge RPG, se señala y pulsa un componente recuadro de lista de la paleta de componentes o del catálogo decomponentes y se suelta en una ventana de diseño.

componente recuadro de selección. Recuadro de selección con texto asociado que representa una opción. Cuandoun usuario selecciona una opción, aparece un indicador en el recuadro de selección que indica que la opción estáseleccionada. El usuario puede eliminar la marca del recuadro de selección volviendo a seleccionar la opción. EnVisualAge RPG, se señala y pulsa un componente recuadro de selección de la paleta de componentes o del catálogode componentes y se suelta en una ventana de diseño.

componente referencia a componente lógico. Componente que permite que un componente lógico se comuniquecon otro en una aplicación VARPG.

componentes. Objetos que componen la GUI de una aplicación VARPG.

componente selector cíclico. Tipo de campo de entrada que muestra un anillo de opciones relacionadas, pero que seexcluyen mutuamente, por el que un usuario puede desplazarse y seleccionar una opción. El usuario también puedeteclear una opción válida en el campo de entrada. Puede señalar y pulsar un componente selector cíclico de la paletade componentes o del catálogo de componentes y soltarlo en una ventana de diseño.

componente subarchivo de mensajes. Componente que puede visualizar mensajes predefinidos o textosuministrado en la lógica del programa.

componente submenú. Componente utilizado para iniciar un submenú a partir de un elemento de menú o de unmenú existente, o para iniciar un menú desplegable a partir de un elemento de menú en una barra de menú. Véasetambién submenú y componente elemento de menú.

componente temporizador. Componente utilizado para hacer un seguimiento del intervalo de tiempo entre doseventos y desencadenar el segundo evento cuando ha transcurrido el intervalo.

componente texto estático. Componente utilizado como etiqueta para otros componentes, como solicitud para uncomponente campo de entrada.

componente ventana. Área con límites visibles que representa una vista de un objeto o con la que un usuariomantiene un diálogo con un sistema. Puede señalar y pulsar un componente ventana de la paleta de componentes odel catálogo de componentes y soltarlo en la ventana de proyectos.

componente ventana con lienzo. Combinación del componente ventana y del componente lienzo. Véase tambiéncomponente ventana y componente lienzo.

comprobación de sintaxis. Verifica que la sintaxis de cada línea sea correcta mientras se edita el código fuente. Conello pueden evitarse errores de compilación. Esta opción puede activarse o desactivarse. Puede visualizarse sólodeterminados tipos de especificación, como especificaciones C, o una línea con una serie específica.

Conectividad de Baes de Datos Java (JDBC). Estándar del sector para la conectividad independiente de la base dedatos entre Java y una amplia gama de bases de datos. JDBC proporciona una interfaz de programación deaplicaciones (API) a nivel de llamada para el acceso a bases de datos basado en SQL.

CONFIG.SYS. Archivo de configuración, ubicado en el directorio raíz de la unidad de arranque, para los sistemasoperativos DOS, OS/2 o Windows. Contiene información necesaria para instalar y ejecutar hardware y software.

configuración. Manera en que el hardware y el software de un sistema de proceso de información estánorganizados y se conectan entre sí (T).

construir. Proceso por el que las diversas partes de un código fuente que forman los componentes lógicos de unaaplicación VARPG se compilan y enlazan para producir una versión ejecutable de la aplicación.

conversación DDE. El intercambio de datos entre un cliente DDE y un servidor DDE. Véase también conversación deenlace estático y conversación de enlace dinámico.

498 VisualAge RPG Manual de consulta de componentes

Page 517: Manual Ibm

conversación de enlace dinámico. En DDE, actualización automática de un programa cliente por un programaservidor cuando los datos cambian en el servidor. Compárese con conversación de enlace estático

conversación de enlace estático. En DDE, petición explícita efectuada por un programa cliente a un programaservidor. El programa servidor responde a la petición. Compárese con conversación de enlace dinámico.

cuaderno de propiedades. Representación gráfica que se asemeja a un cuaderno enlazado que contiene páginasseparadas en secciones por páginas separadoras. Seleccione las pestañas de un cuaderno para ir de una sección aotra.

cursor. Indicación visible de la posición en la que aparecerá la interacción de usuario con el teclado.

DDBCS. Juego de caracteres de doble byte.

DDE. Intercambio de datos dinámico.

definición de interfaz de procedimiento. Repetición de la información prototipo dentro de la definición de unprocedimiento. Se utiliza para declarar los parámetros de entrada para el procedimiento y para garantizar que ladefinición interna del procedimiento es coherente con la definición externa (el prototipo)

directorio destino. Directorio en el que se almacena la aplicación VARPG compilada después de una creación.Compárese con carpeta destino.

directorio fuente. Directorio en el que se almacenan todos los archivos fuente para una aplicación VARPG.

Diseñador GUI. Conjunto de herramientas utilizadas para crear interfaces arrastrando y soltando componentes dela paleta de componentes a la ventana de diseño.

DLL. Biblioteca de enlace dinámico.

DLL de programa de utilidad. Véase módulo NOMAIN

doble pulsación. Pulsar el botón del ratón dos veces rápidamente.

EEBCDIC. Código de intercambio decimal binario ampliado. Juego de caracteres de 256 caracteres de 8 bits.

edición directa. Utilización de procedimientos que permiten a un usuario trabajar con un objeto arrastrándolo conun ratón o interactuando con su menú emergente.

elemento. En intercambio de datos dinámico, una unidad de datos. Por ejemplo, la posición de la casilla superiorizquierda en una hoja de cálculo es fila 1, columna 1. Se puede hacer referencia a la posición de la casilla como elelemento R1C1.

eliminar referencia. Acción de suprimir la asociación entre un componente y un campo de base de datos deAS/400.

énfasis. Resaltado, cambio de color u otra indicación visible de condiciones relativas a un objeto o una opción queafecta a la capacidad del usuario de interactuar con ese objeto u opción. El énfasis también puede proporcionar a unusuario información adicional sobre el estado de una opción o un objeto.

entrada/salida (E/S). Datos proporcionados al sistema o datos que resultan del proceso del sistema.

estación de trabajo. Dispositivo que permite a un usuario efectuar trabajos. Véase también estación de trabajoprogramable.

estación de trabajo programable (PWS). Estación de trabajo que tiene un cierto grado de capacidad de proceso yque permite a un usuario modificar sus funciones.

Glosario 499

Page 518: Manual Ibm

evento. Señal generada como resultado de una modificación en el estado de un componente. Por ejemplo, alaccionar un pulsador se genera el evento Press.

evento de enlace. Evento que un componente destino recibe siempre que cambia el estado de un componentefuente.

excepción. (1) En lenguajes de programación, una situación anormal que se da durante la ejecución, que puedeocasionar una desviación de la secuencia normal de ejecución, para la que existen recursos en los lenguajes deprogramación a fin de definirla, activarla, reconocerla, ignorarla y manejarla. (I) (2) En VisualAge RPG, un evento osituación que impide, o puede impedir, que una acción solicitada por un usuario concluya tal como éste espera. Lasexcepciones tienen lugar cuando un producto no puede interpretar la entrada de un usuario.

EXE. Extensión de un archivo ejecutable.

exportar. Función que convierte un archivo interno en un formato de archivo estándar para utilizarlo fuera de laaplicación. Compárese con importar.

Ffoco. Sinónimo de foco de entrada.

foco de entrada. Área de una ventana en la que la interacción del usuario puede tener lugar desde el teclado odesde el ratón.

IICO. Extensión de archivo de un archivo de icono.

icono. Representación gráfica de un objeto, que se compone de una imagen, un fondo de imagen y una etiqueta.

importar. Función que convierte objetos de archivo de pantalla de AS/400 al componente VARPG adecuado.Compárese con exportar.

indicador de progreso. Uno o más controles utilizados para informar a un usuario sobre el curso de un proceso.

índice. Identificador de una entrada en componentes de VARPG como, por ejemplo, recuadros de lista o recuadrosde combinación.

INI. Extensión de archivo para un archivo del sistema operativo OS/2 o Windows que contiene informaciónespecífica de la aplicación que necesita conservarse, de una llamada a una aplicación, a otra.

intercambio de datos dinámicos (DDE). Intercambio de datos entre programas o entre un programa y un objeto dearchivo de datos. Cualquier cambio efectuado en la información de un programa o una sesión se aplica a los datosidénticos creados por el otro programa. Véase también conversación DDE, cliente DDE y servidor DDE.

Interfaz de programación de aplicaciones (API). Interfaz funcional suministrada por el sistema operativo o unprograma bajo licencia que se solicita por separado, que permite que un programa de aplicación escrito en unlenguaje de alto nivel pueda utilizar datos o funciones específicas del sistema operativo o del programa bajo licencia.

interfaz de usuario gráfica (GUI). Tipo de interfaz de usuario que proporciona las ventajas de los gráficos de altaresolución. Una interfaz gráfica de usuario incluye una combinación de gráficos, el paradigma de acción de objeto, eluso de dispositivos de puntero, barras de menú y otros menús, solapamiento de ventanas e iconos.

Interfaz Nativa de Java (JNI). Interfaz de programación que permite al código Java que se ejecuta dentro de unaMáquina Virtual Java (JVM) interoperar con las funciones escritas en otros lenguajes de programación.

IPF. Recurso de Presentación de Información.

JJava. Lenguaje de programación orientado a objeto para código interpretado portátil que soporta la interacción entreobjetos remotos. Java y sus especificaciones han sido desarrolladas por Sun Microsystems, Incorporated.

500 VisualAge RPG Manual de consulta de componentes

Page 519: Manual Ibm

JavaBean. En Java, un modelo de componente reutilizable, portátil e independiente de la plataforma.

Java Runtime Environment (JRE). Subconjunto del Kit de desarrollo Java para los usuarios finales y desarrolladoresque deseen redistribuir el JRE. El JRE consiste en la Máquina Virtual Java, las Clases de Núcleo de Java y los archivosde soporte.

Java 2 Software Development Kit (J2SDK). Software que distribuye Sun Microsystems a los desarrolladores deJava. Este software incluye el interpretador Java, clases Java y herramientas de desarrollo Java. Las herramientas dedesarrollo incluyen un compilador, un depurador, un desensamblador, un AppletViewer, un generador de archivos deapéndice y un generador de documentación.

juego de caracteres de doble byte (DBCS). Juego de caracteres en el que cada carácter se representa mediante 2bytes. Algunos idiomas como el japonés, el chino o el coreano, que contienen más símbolos de los que puedenrepresentarse mediante los 256 elementos de código, necesitan el juego de caracteres de doble byte. Puesto que cadacarácter necesita 2 bytes, la escritura, la visualización y la impresión de caracteres DBCS necesita hardware yprogramas que soporten DBCS. El sistema soporta cuatro juegos de caracteres de doble byte: japonés, coreano, chinosimplificado y chino tradicional. Compárese con juego de caracteres de un solo byte (SBCS).

juego de caracteres de un solo byte (SBCS). Juego de caracteres en el que cada carácter se representa mediante unbyte. Compárese con juego de caracteres de doble byte (DBCS).

Llínea de ejecución. La unidad más pequeña de operación que puede efectuarse dentro de un proceso.

lista desplegable. Campo de una sola selección en el que sólo puede verse la opción actual. Las demás opcionespermanecen ocultas hasta que el usuario realiza una acción específica para visualiza el recuadro de lista que lascontiene.

lugar de trabajo. Área que ocupa toda la pantalla y contiene todos los objetos que componen la interfaz del usuario.

MMáquina Virtual Java (JVM). La parte del Java Runtime Environment (JRE) responsable de interpretar bytecodes deJava.

marcador de grupo. Marcador que identifica un componente como el primero de un grupo. Cuando el usuariodesplaza el cursor por un grupo de componentes y llega al último, el cursor vuelve a la primera parte del grupo.

mensaje. (1) Información no solicitada por un usuario, pero visualizada por un producto, como respuesta a unevento no esperado o cuando puede producir algo no deseado. (2) Comunicación enviada por una persona o unprograma a otra persona u otro programa.

menú. Lista de opciones que pueden aplicarse a un objeto. Un menú puede contener opciones que no esténdisponibles para ser seleccionadas en determinados contextos. Estas opciones están atenuadas.

menú desplegable. Menú que aparece al seleccionar una opción en una barra de menú o a partir del símbolo delmenú del sistema. Las opciones de un menú desplegable están relacionadas entre sí.

menú emergente. Menú que, cuando se solicita, aparece junto al objeto con el que está asociado. Contiene opcionesadecuadas para el objeto en su contexto actual.

MID. Extensión de archivo de un archivo MIDI.

migrar. (1) Mover a entorno operativo modificado, generalmente a un nuevo release o versión de un sistema. (2)Mover datos desde una jerarquía de almacenamiento a otra.

módulo EXE. Un módulo EXE consta de un procedimiento principal y subprocedimientos. Se crea cuando la palabraclave EXE está presente en la especificación de control. Todas las subrutinas (BEGSR) deben ser locales a unprocedimiento. El EXE debe contener un procedimiento cuyo nombre coincida con el nombre del archivo fuente. Esteserá el punto de entrada principal para el EXE; es decir, el procedimiento principal.

Glosario 501

Page 520: Manual Ibm

módulo NOMAIN. Módulo que contiene solamente subprocedimientos. No contiene ninguna acción o subrutina deusuario autónoma. Un módulo NOMAIN se crea cuando la palabra clave NOMAIN se encuentra en la especificaciónde control.

Nnemotécnico. Un solo carácter, dentro del texto de una opción, identificado por un subrayado debajo de él. Véasetambién selección nemotécnica.

nivel del graduador. Indicador visual en el graduador que un usuario puede mover para modificar el valornumérico.

Oobjeto. (1) Espacio de almacenamiento con nombre que consiste en un conjunto de características que describen elespacio de almacenamiento en sí y, en algunos casos, datos. Un objeto es algo que existe en el almacenamiento yocupa parte de su espacio, y en el que se pueden efectuar operaciones. Algunos ejemplos de objetos son: programas,archivos, bibliotecas y carpetas. (2) Componente visual de una interfaz de usuario con el que un usuario puedeefectuar una tarea. Un objeto puede aparecer como texto o como un icono.

objeto de datos. Objeto que transporta información, como texto, gráficos, audio o vídeo.

Ppaleta de colores. Conjunto de colores que pueden utilizarse para cambiar el color de cualquier componente en laGUI de la aplicación.

paleta de componentes. El grupo de componentes más adecuado para construir la interfaz gráfica de usuario actualpara una aplicación. Cuando finaliza la GUI, puede vaciar la paleta y añadir los componentes del catálogo decomponentes que necesite para la siguiente aplicación.

paleta de fonts. Conjunto de fonts que pueden utilizarse para cambiar el font de un componente en la GUI de laaplicación.

panel de navegación. Grupo de botones que se pueden utilizar para controlar la selección visible de registros en unsubarchivo.

paquete. Función utilizada para reunir todos los componentes de una aplicación VARPG para su distribución.

paradigma acción-objeto. Patrón de interacción en el que un usuario selecciona un objeto y a continuaciónselecciona una acción para aplicarla a ese objeto.

procedimiento. Un procedimiento es cualquier parte del código a la que pueda llamarse mediante la operaciónCALLP.

procedimiento principal. Un procedimiento principal es un subprocedimiento que puede especificarse comoprocedimiento de entrada del programa y que recibe el control cuando se le llama por primera vez. El procedimientoprincipal sólo se genera cuando se crea un EXE. Consulte módulo EXE

programación orientada a objetos. Método para estructurar programas como clases organizadas jerárquicamenteque describen los datos y las operaciones de objetos que pueden interactuar con otros objetos. (T)

programa destino. Objeto que el proyecto ha de crear, como una biblioteca de enlace dinámico (DLL).

programa objeto. Programa destino adecuado para ser ejecutado. Un programa objeto puede o no necesitar enlace.(T)

prototipo. Definición de la interfaz de llamada. Incluye información como, por ejemplo, si la llamada está enlazada(procedimiento) o es dinámica (programa), el nombre externo, el número y la naturaleza de los parámetros, quéparámetros deben ser pasados y el tipo de datos de cualquier valor de retorno (para un procedimiento)

502 VisualAge RPG Manual de consulta de componentes

Page 521: Manual Ibm

proyecto. Conjunto de datos y acciones completo necesarios para construir un destino único, como una biblioteca deenlace dinámico (DLL) o un archivo ejecutable (EXE).

pulsar. Pulsar y liberar un botón del ratón sin mover el puntero fuera de la opción o del objeto. Véase también doblepulsación.

puntero del ratón. Sinónimo de cursor.

PWS. Estación de trabajo programable.

Rratón. Dispositivo con uno o más pulsadores que se utilizan para colocar un puntero en la pantalla sin usar elteclado. Se utiliza para seleccionar una opción o una función que se ha de efectuar o para llevar a cabo operacionesen la pantalla, como dibujar líneas y arrastrarlas de una posición a otra.

recuadro de combinación. Control que combina las funciones de un campo de entrada y de un recuadro de lista.Un recuadro de combinación contiene una lista de objetos por los que el usuario puede desplazarse y seleccionarpara completar el campo de entrada. Si lo desea, el usuario también puede escribir texto directamente en el campo deentrada. En VisualAge RPG, se señala y pulsa un componente recuadro de combinación de la paleta de componenteso del catálogo de componentes y se suelta en una ventana de diseño.

recuadro de combinación desplegable. Tipo de recuadro de combinación en el que un recuadro de lista está ocultohasta que un usuario realiza una acción específica para visualizarlo.

Recurso de Presentación de Información (IPF). Herramienta utilizada para crear ayuda en línea en una estación detrabajo programable.

resaltado de símbolos. Mejora la legibilidad del código. Puede configurar el resaltado de diferentes elementos dellenguaje con diferentes colores o fonts para identificar las estructuras del programa. Puede activar o desactivar elresaltado de símbolos.

SSBCS. Juego de caracteres de un solo byte.

sección fuente principal. En un programa VARPG, la sección que contiene todas las definiciones globales para unmódulo. Para un componente lógico, esta sección también incluye la acción y las subrutinas de usuario.

selección nemotécnica. Método de selección en el que un usuario selecciona una opción tecleando el nemotécnicode esa opción.

señalar y pulsar. (1) Método de selección que se utiliza para copiar un componente de la paleta o el catálogo decomponentes en la ventana de diseño, la vista de iconos o la vista de árbol de la GUI. (2) Para colocar uncomponente en cualquiera de las vistas, señale y pulse el componente; después, mueva el cursor a la ventana elegiday señale y suelte el componente donde desea que aparezca. En las vistas de iconos y de árbol, el componente secolocará en el componente padre, y tendrá que moverlo al lugar donde le interese que aparezca en la ventana dediseño.

servidor. Sistema de una red que maneja las peticiones de otro sistema, llamado cliente.

servidor DDE. Aplicación que proporciona datos a otra aplicación habilitada por DDE. Compárese con cliente DDE.Véase también conversación DDE.

sistema operativo. Grupo de programas del sistema que controlan la operación general de un sistema.

solicitud. (1) Mensaje visual o audible enviado por un programa para solicitar la respuesta de un usuario. (T) (2)Símbolo o mensaje que se visualiza para solicitar una entrada del usuario o proporcionar información operativa. Elusuario debe responder a la solicitud para poder proseguir.

SSL. Capa de Sockets Segura.

Glosario 503

Page 522: Manual Ibm

submenú. Menú que aparece al seleccionar una opción en cascada en otro menú y que contiene opcionesrelacionadas con dicho menú. Los submenús se utilizan para reducir la longitud de un menú desplegable o de unmenú emergente. Véase también componente submenú.

subprocedimiento. Procedimiento especificado después de la sección fuente principal. Debe tener un prototipocorrespondiente en las especificaciones de definición de la sección fuente principal.

subrutina de acción. Lógica que se escribe para responder a un evento específico.

Ttema. En intercambio de datos dinámico (DDE), el conjunto de datos que es el sujeto de una conversación DDE.

tope de tabulador. Atributo utilizado para establecer un tope de tabulador para un componente, de modo que losusuarios puedan colocar el foco en el mismo cuando utilicen la tecla tabuladora para moverse por la interfaz.

Vvalor por omisión. Valor que el sistema o un programa proporciona o presupone automáticamente cuando elusuario no especifica ninguno. El valor por omisión puede asignarse a un pulsador o a un pulsador gráfico.

ventana activa. Ventana con la que un usuario interactúa actualmente. Esta es la ventana que recibe la entrada delteclado.

ventana de diseño. Ventana en el diseñador GUI en la que se colocan componentes para crear una interfaz deusuario.

ventana emergente. Ventana movible, de tamaño fijo, en la que un usuario proporciona información necesaria parauna aplicación de manera que puede continuar procesando una petición de usuario. Sinónimo de ventana secundaria.

ventana inactiva. Ventana que no puede recibir entrada de teclado en un momento dado.

ventana primaria. Ventana en la que tiene lugar la interacción principal entre el usuario y la aplicación. Sinónimo deventana principal.

ventana principal. Véase ventana primaria.

ventana secundaria. Ventana que contiene información que depende de la información de una ventana primaria yse utiliza para complementar la interacción en dicha ventana. Véase también ventana primaria. Sinónimo de ventanaemergente.

vista de árbol. Visualización del contenido de un objeto de manera jerárquica.

vista de detalles. Vista de contenido estándar en la que un icono pequeño se combina con texto para proporcionarinformación descriptiva sobre un objeto.

vista de iconos. Vista de contenido estándar en la que cada objeto contenido en un contenedor se visualiza como unicono.

WWAV. Extensión de archivo de un archivo de ondas.

504 VisualAge RPG Manual de consulta de componentes

Page 523: Manual Ibm

Bibliografía

Para obtener información adicional sobre temas relacionados con VisualAge RPG yCODE (Cooperative Development Environment) para AS/400, consulte lassiguientes publicaciones de IBM:

Manuales de WebSphere Development Tools para AS/400:

*Nota: Se han actualizado todas las versiones en línea de las publicaciones deWebSphere Development Tools para AS/400. Las publicaciones cuyonúmero de pedido está marcado con un asterisco (*) no se han vuelto aimprimir en este release.

v Iniciación a VisualAge RPG y CODE/400, SC10-3287-01 (SC09-2625-01),proporciona información sobre WebSphere Development Tools para AS/400,dando una visión general de las características de CODE/400 y VARPG, decómo funcionan juntas y de las ventajas empresariales que se obtienen alutilizarlas.

Manuales de VisualAge RPG:v Iniciación a VisualAge RPG y CODE/400, SC10-3287-01 (SC09-2625-01)*, describe

los conceptos y las tareas de VARPG que se realizan mientras se utilizaVisualAge RPG.

v VisualAge RPG Manual de consulta del lenguaje, SC10-3066-01 (SC09-2451-01)*,proporciona información de consulta sobre el lenguaje y el compilador deVARPG.

v VisualAge RPG Manual de consulta de componentes, SC10-3065-02 (SC09-2450-02)*,proporciona una descripción de cada componente, atributo de componente,evento de componente, atributo de componente y atributo de evento de VARPG.Es un manual de consulta para todos aquellos que desarrollan aplicaciones conVisualAge RPG.

v Programación con VisualAge para RPG, SC10-3067-02 (SC09-2449-02)*, contieneinformación específica sobre cómo crear aplicaciones con VisualAge RPG.Describe los pasos a seguir en cada fase del ciclo de desarrollo de aplicaciones,desde el diseño al empaquetado y la distribución. Se incluyen ejemplos deprogramación para clarificar los conceptos y el proceso de desarrollo deaplicaciones VARPG.

v Java for RPG Programmers es una introducción al lenguaje Java (y RPG IV)mediante la comparación con el lenguaje RPG. Se trata de un comienzo muyapropiado en el mundo de Java. También incluye una guía de aprendizajeinteractiva en formato CD sobre Java y VisualAge para Java, mediante MINDQ.

v Experience RPG IV Tutorial es una guía de aprendizaje interactiva en formato CDque enseña RPG IV e ILE, paso a paso y de un modo divertido. Se trata de unmanual con preguntas y ejercicios que ayudan a adquirir experiencia prácticacon esta nueva y apasionante versión de RPG.

v Otra publicación que no es de IBM interesante para los usuarios de VisualAgeRPG es VisualAge for RPG by Example.

Información y publicaciones del AS/400:v Si tiene conexión con Internet, puede obtener información sobre otras

publicaciones del AS/400 en uno de los siguientes sitios Web:

© Copyright IBM Corp. 1994, 2000 505

Page 524: Manual Ibm

http://www.as400.ibm.com/infocenter

http://publib.boulder.ibm.com/pubs/html/as400/infocenter.htm

Para obtener una versión en copia software de las publicaciones de AS/400,consulte la publicación CD-ROM AS/400e Biblioteca en soporte software,SK3T-1325-04 (SK3T-0118-04).

Manuales de Gestor para el Desarrollo de Aplicaciones ADM:v ADTS/400: Gestor para el Desarrollo de Aplicaciones ADM Introducción y guía de

planificacion, GC10-9401-00 (GC09-1807-00), describe los conceptos básicos y laplanificación necesaria para hacer un uso efectivo de la función Gestor para elDesarrollo de Aplicaciones ADM.

v ADTS/400: Gestor para el Desarrollo de Aplicaciones ADM Guía del Usuario,SC10-9609-01 (SC09-2133-01), describe cómo crear y gestionar proyectosdefinidos para la función Gestor para el Desarrollo de Aplicaciones ADM.

v ADTS/400: Gestor para el Desarrollo de Aplicaciones ADM Guía de autoaprendizaje,SC10-9610-00 (SC09-2138-00), proporciona experiencia práctica en la utilizaciónde la función Gestor para el Desarrollo de Aplicaciones ADM del productoADTS para OS/400. Esta guía muestra cómo utilizar la función Gestor para elDesarrollo de Aplicaciones ADM guiándole a través de una serie de ejerciciospaso a paso.

v ADTS/400: Application Development Manager API Reference, SC09-2180-00, describecómo los programadores de aplicaciones pueden escribir su propia interfaz parala función Gestor para el Desarrollo de Aplicaciones ADM.

Manual Recurso de presentación de información (IPF):v Information Presentation Facility Programming Guide G25H-7110, describe los

elementos que componen el IPF (Recurso de presentación de información). IPFes una herramienta que soporta el diseño y el desarrollo de documentos en líneay de recursos de ayuda en línea.

Manuales de SQL:v IBM SQL Reference Version 2 SC26-8416, Volumen 2, compara los recursos de

– DB2– SQL/DS™

– DB2/400™

– DB2/6000™

– IBM SQL– ISO-ANSI (SQL92E)– X/Open™ (XPG4-SQL).

v DB2 Universal Database Administration Guide S10J-8157, proporciona lainformación necesaria para utilizar y administrar el producto DB2.

v DB2 Universal Database Embedded SQL Programming Guide S10J-8158, describecómo diseñar y codificar programas de aplicación para acceder a los servidoresde la familia DB2 Client/Server (como DB2 o DB2/400). Contiene informacióndetallada sobre la utilización del SQL (Lenguaje de Consulta Estructurada) yllamadas de API en las aplicaciones.

506 VisualAge RPG Manual de consulta de componentes

Page 525: Manual Ibm

Avisos

Esta información se ha elaborado para productos y servicios que se ofrecen enEstados Unidos. IBM puede no ofrecer los productos, servicios o características quese tratan en este documento en otros países. Consulte con el representante local deIBM para obtener información sobre los productos y servicios que estándisponibles en su área en la actualidad. Toda referencia hecha a un producto,programa o servicio de IBM no pretende afirmar ni implicar que sólo puedeutilizarse ese producto, programa o servicio de IBM. En su lugar puede utilizarsecualquier producto, programa o servicio funcionalmente equivalente que noinfrinja ningún derecho de propiedad intelectual de IBM. Sin embargo, esresponsabilidad del usuario evaluar y verificar el funcionamiento de todos losproductos, programas o servicios que no sean de IBM.

IBM puede tener patentes o aplicaciones pendientes de patente acerca del tema deeste documento. La entrega de este documento no le otorga ninguna licencia sobredichas patentes. Puede enviar consultas sobre licencias, por escrito, a:

Director of LicensingIntellectual Property & LicensingInternational Business Machines CorporationNorth Castle Drive, MD - NC119Armonk, New York 10504-1785Estados Unidos

El párrafo siguiente no procede en el Reino Unido ni en ningún otro país dondetales estipulaciones sean contradictorias con las leyes locales: INTERNATIONALBUSINESS MACHINES CORPORATION PROPORCIONA ESTA PUBLICACIÓN “TAL CUAL” SIN GARANTÍA DE NINGUNA CLASE, NI EXPRESA NIIMPLÍCITA, INCLUSIVE, PERO SIN LIMITARSE A, LAS GARANTÍASIMPLÍCITAS DE NO VULNERACIÓN, COMERCIALIZACIÓN O ADECUACIÓNA UN FIN DETERMINADO. En determinados países no se permite la declaraciónde limitación de responsabilidad de las garantías expresas ni implícitas endeterminadas transacciones, por lo tanto, esta declaración puede no ser procedenteen su caso.

Esta información puede contener inexactitudes técnicas o errores tipográficos. Seefectúan cambios periódicos en la información contenida en este documento; talescambios se incorporarán en nuevas ediciones de la publicación. IBM puede hacermejoras y/o modificaciones en los productos y/o programas descritos en estapublicación en cualquier momento sin previo aviso.

Las referencias hechas en esta información a páginas Web de terceros seproporcionan sólo como gentileza para los usuarios y de ninguna manera puedeninterpretarse como aprobación de esas páginas Web. Los materiales que figuran enesas páginas Web no forman parte de los materiales para este producto de IBM yla utilización de tales páginas Web es responsabilidad del usuario.

Los licenciatarios de este programa que deseen obtener información acerca delmismo con el fin de: (i) intercambiar la información entre programas creadosindependientemente y otros programas (incluyendo éste) y (ii) utilizar mutuamentela información que se ha intercambiado, deben ponerse en contacto con:

IBM Canada Ltd.

© Copyright IBM Corp. 1994, 2000 507

Page 526: Manual Ibm

Department 0711150 Eglinton Avenue EastToronto, Ontario M3C 1H7Canadá

Dicha información estará disponible de acuerdo con las condiciones oportunas, queen algunos casos puede incluir el pago de una cantidad.

IBM proporciona el programa bajo licencia descrito en esta información y todo elmaterial bajo licencia disponible para él según los términos del Contrato de ClienteIBM, Contrato de Licencia de Programa Internacional IBM o cualquier contratoequivalente entre nosotros.

Información de interfaz de programaciónEsta publicación pretende ayudarle a crear y gestionar aplicaciones e interfaces deusuario VisualAge RPG en la estación de trabajo, en un entorno cliente/servidor.Esta publicación documenta la Interfaz de programación de uso general y lainformación de guía asociada que proporciona VisualAge RPG y CODE/400.

Marcas registradas y marcas de servicioLos términos siguientes son marcas registradas de International Business MachinesCorporation en Estados Unidos y/o en otros países:

Application System/400 AS/400 AS/400eCommon User Access CUA DATABASE 2DB2 DB2 Connect DB2 Universal DatabaseIBM OS/400 SQL/DSVisualAge 400

Java y todas las marcas registradas basadas en Java son marcas registradas onombres comerciales de Sun Microsystems, Inc. en Estados Unidos y/u otrospaíses.

ActiveX, Microsoft, Windows y Windows NT son marcas registradas de MicrosoftCorporation en Estados Unidos y/o en otros países.

Otros nombres de empresas, productos y servicios pueden ser marcas registradas omarcas de servicio de otras firmas.

508 VisualAge RPG Manual de consulta de componentes

Page 527: Manual Ibm
Page 528: Manual Ibm

IBM

Número de Programa: 5769-CL3

Printed in Denmark by IBM Danmark A/S

SC10-3065-04