manual ibm
TRANSCRIPT
AS/400e™
VisualAge® RPGManual de consulta de componentesVersión 4.5.1 para Windows®
SC10-3065-04
IBM
AS/400e™
VisualAge® RPGManual de consulta de componentesVersión 4.5.1 para Windows®
SC10-3065-04
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.
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
||
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
||
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
||
||
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
||
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
||
viii VisualAge RPG Manual de consulta de componentes
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
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
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
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
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
xiv VisualAge RPG Manual de consulta de componentes
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
xvi VisualAge RPG Manual de consulta de componentes
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
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
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
|
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
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
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
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
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
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
*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
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
|
|
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
|
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
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
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
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
|
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
|
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
|
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
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
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
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
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
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
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
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
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
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
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
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
*...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
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
|
||||
|||
|
||
||
|
||||||
|
|
|||
||
|||
|
|||||||||||
|
||||||||||
|
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
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
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
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
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
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
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
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
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
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
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
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
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
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
|||
||
|||
|
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
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
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
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
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
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
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
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
|||
||
|||
|
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
|||
||
|||
|
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
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
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
|||
||
|||
|
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
|||
||
|||
|
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
||
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
||
|
|
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
|
||
||
|
||||||
|
|||
||
|||
||
|
|||||
|
|||||
|
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
|||
||
|||
||
|
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
|||
||
|||
||
|
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
|
|||
||
|
||||||
|
|||
||
|||
|
||
|||||||||
|
|||||||
|
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
|
||||
|||
|
||
||
|
||||||
|
|
|||
||
|||
|
|||||||||||
|
||||||||||
|
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
|||
||
|||
||
|
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
|||
||
|||
||
|
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
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
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
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
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
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
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
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
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
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
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
|
|||
||
|
||||||
|
|||
||
|||
|
|||||
|
|||||
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
|
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
*...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
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
|||
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
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
%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
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
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
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
|
|||||||
||
|
||||||
|
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
IBM
Número de Programa: 5769-CL3
Printed in Denmark by IBM Danmark A/S
SC10-3065-04