VisualAge RPG Parts Reference - IBM

AS/400e 

VisualAge ® RPG 

Manual de consulta de componentes 

Versión4.5.1paraWindows ® 

 

SC10-3065-04

AS/400e 

VisualAge ® RPG 

Manual de consulta de componentes 

Versión4.5.1paraWindows ® 

 

SC10-3065-04

Importante 

Antes de utilizar esta información y el producto al que da soporte, asegúrese de leer la información general que figura en el 

apartado “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 Tools 

para AS/400 (Programa 5769-CL3) y a todos los releases y modificaciones posteriores hasta que se indique lo 

contrario 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 la 

izquierda 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 la 

direcció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 Center 

Avda. Diagonal, 571 

08029 Barcelona 

Españ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ón 

del 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 . . . . . . . . ix 

Convenios de resaltado que se utilizan en este 

manual . . . . . . . . . . . . . . . . ix 

Requisito previo e información relacionada . . . . ix 

La biblioteca VisualAge RPG. . . . . . . . . ix 

Cómo enviar comentarios . . . . . . . . . . xi 

Acceso a la información en línea . . . . . . . xi 

Utilización de manuales en línea . . . . . . xi 

Publicaciones en formato PDF . . . . . . . xi 

Utilización de ayuda en línea . . . . . . . xii 

Novedades de este Release. . . . . . xv 

Capítulo 1. Componentes . . . . . . . 1 

ActiveX . . . . . . . . . . . . . . . . 1 

Control de animación . . . . . . . . . . . 3 

Calendario . . . . . . . . . . . . . . . 4 

Lienzo . . . . . . . . . . . . . . . . 5 

Recuadro de selección . . . . . . . . . . . 7 

Recuadro de combinación . . . . . . . . . . 8 

*Component . . . . . . . . . . . . . . 10 

Referencia a componente lógico. . . . . . . . 11 

Contenedor . . . . . . . . . . . . . . 12 

Cliente DDE . . . . . . . . . . . . . . 13 

Campo de entrada . . . . . . . . . . . . 14 

Gráfica . . . . . . . . . . . . . . . . 16 

Pulsador gráfico . . . . . . . . . . . . . 17 

Recuadro de grupo . . . . . . . . . . . . 19 

Barra de desplazamiento horizontal . . . . . . 20 

Imagen . . . . . . . . . . . . . . . . 21 

Bean Java . . . . . . . . . . . . . . . 23 

Recuadro de lista . . . . . . . . . . . . 24 

Medios . . . . . . . . . . . . . . . . 25 

Panel de medios . . . . . . . . . . . . . 26 

Barra de menús . . . . . . . . . . . . . 27 

Elemento de menú . . . . . . . . . . . . 28 

Subarchivo de mensajes . . . . . . . . . . 29 

Edición de múltiples líneas . . . . . . . . . 30 

Cuaderno . . . . . . . . . . . . . . . 31 

Página de cuaderno . . . . . . . . . . . 32 

Página de cuaderno con lienzo . . . . . . . . 33 

Interfaz ODBC/JDBC . . . . . . . . . . . 34 

Recuadro de contorno . . . . . . . . . . . 36 

Menú emergente. . . . . . . . . . . . . 37 

Barra de progreso . . . . . . . . . . . . 38 

Pulsador . . . . . . . . . . . . . . . 39 

Botón de selección . . . . . . . . . . . . 40 

Graduador . . . . . . . . . . . . . . 41 

Selector cíclico . . . . . . . . . . . . . 42 

Texto estático . . . . . . . . . . . . . . 43 

Barra de estado . . . . . . . . . . . . . 44 

Subarchivo . . . . . . . . . . . . . . 45 

Submenú . . . . . . . . . . . . . . . 46 

Temporizador . . . . . . . . . . . . . 47 

Barra de desplazamiento vertical . . . . . . . 48 

| 

Ventana. . . . . . . . . . . . . . . . 49 

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

Capítulo 2. Atributos de componente 51 

Activate . . . . . . . . . . . . . . . 52 

Active . . . . . . . . . . . . . . . . 53 

AddEvent . . . . . . . . . . . . . . . 54 

AddItemEnd . . . . . . . . . . . . . . 55 

AddLineEnd . . . . . . . . . . . . . . 56 

AddLink . . . . . . . . . . . . . . . 57 

AddMsgID . . . . . . . . . . . . . . 59 

AddMsgText . . . . . . . . . . . . . . 60 

AddOffset . . . . . . . . . . . . . . . 61 

AddRcd . . . . . . . . . . . . . . . 62 

AddSrcEvt. . . . . . . . . . . . . . . 64 

Alarm . . . . . . . . . . . . . . . . 65 

Alignment . . . . . . . . . . . . . . . 66 

AllowChg . . . . . . . . . . . . . . . 68 

AllowEdit . . . . . . . . . . . . . . . 69 

AllowLink . . . . . . . . . . . . . . . 70 

AppData . . . . . . . . . . . . . . . 72 

AppName. . . . . . . . . . . . . . . 73 

Arrange . . . . . . . . . . . . . . . 74 

AttrValue . . . . . . . . . . . . . . . 75 

AudioMode . . . . . . . . . . . . . . 76 

AutoInc . . . . . . . . . . . . . . . 77 

AutoScroll . . . . . . . . . . . . . . . 78 

AutoSelect. . . . . . . . . . . . . . . 80 

BackColor . . . . . . . . . . . . . . . 81 

BackMix . . . . . . . . . . . . . . . 83 

BarLabel . . . . . . . . . . . . . . . 84 

Bass . . . . . . . . . . . . . . . . . 85 

BindPart . . . . . . . . . . . . . . . 86 

BlankChar . . . . . . . . . . . . . . . 87 

Border . . . . . . . . . . . . . . . . 88 

Bottom . . . . . . . . . . . . . . . . 89 

BufferDec . . . . . . . . . . . . . . . 90 

BufferLen . . . . . . . . . . . . . . . 91 

BufferPtr . . . . . . . . . . . . . . . 92 

BufferType. . . . . . . . . . . . . . . 93 

Button . . . . . . . . . . . . . . . . 95 

ButtonIdx . . . . . . . . . . . . . . . 96 

Buttons . . . . . . . . . . . . . . . . 97 

ButtonTip . . . . . . . . . . . . . . . 98 

CanUndo . . . . . . . . . . . . . . . 99 

CapsLock. . . . . . . . . . . . . . . 100 

Case . . . . . . . . . . . . . . . . 101 

CellBGClr . . . . . . . . . . . . . . 102 

CellBGMix . . . . . . . . . . . . . . 104 

CellFGClr . . . . . . . . . . . . . . 105 

CellFGMix . . . . . . . . . . . . . . 107 

Center. . . . . . . . . . . . . . . . 108 

CharData . . . . . . . . . . . . . . . 109 

CharOffset . . . . . . . . . . . . . . 110 

Checked . . . . . . . . . . . . . . . 111 

© Copyright IBM Corp. 1994, 2000 iii

ChildCount . . . . . . . . . . . . . . 112 

ChildList . . . . . . . . . . . . . . . 113 

ClearAll . . . . . . . . . . . . . . . 114 

ClearDate. . . . . . . . . . . . . . . 115 

ClearMonth . . . . . . . . . . . . . . 116 

ClearYear . . . . . . . . . . . . . . . 117 

ClipBoard . . . . . . . . . . . . . . 118 

ColBGClr. . . . . . . . . . . . . . . 119 

ColBGMix . . . . . . . . . . . . . . 121 

ColFGClr. . . . . . . . . . . . . . . 122 

ColFGMix . . . . . . . . . . . . . . 124 

Collapsed . . . . . . . . . . . . . . 125 

ColNumber . . . . . . . . . . . . . . 126 

Color . . . . . . . . . . . . . . . . 127 

ColorArea . . . . . . . . . . . . . . 129 

ColorMix . . . . . . . . . . . . . . . 131 

Column . . . . . . . . . . . . . . . 132 

ColumnDec . . . . . . . . . . . . . . 133 

ColumnLen . . . . . . . . . . . . . . 134 

ColumnName . . . . . . . . . . . . . 135 

Columns . . . . . . . . . . . . . . . 136 

ColumnType . . . . . . . . . . . . . 137 

ColWidth. . . . . . . . . . . . . . . 138 

CompName . . . . . . . . . . . . . . 139 

Connect . . . . . . . . . . . . . . . 140 

Connected . . . . . . . . . . . . . . 141 

ConnectStr . . . . . . . . . . . . . . 142 

Copy . . . . . . . . . . . . . . . . 143 

Count . . . . . . . . . . . . . . . . 144 

CsrAtEnd . . . . . . . . . . . . . . 145 

CsrLine . . . . . . . . . . . . . . . 146 

CsrPos . . . . . . . . . . . . . . . 147 

CurrentDir . . . . . . . . . . . . . . 148 

CurrentRow . . . . . . . . . . . . . . 149 

Cut. . . . . . . . . . . . . . . . . 150 

DataGroup . . . . . . . . . . . . . . 151 

DataPoint . . . . . . . . . . . . . . 152 

DataType . . . . . . . . . . . . . . . 153 

DataValue . . . . . . . . . . . . . . 154 

Date . . . . . . . . . . . . . . . . 155 

DateIdx . . . . . . . . . . . . . . . 156 

DateText . . . . . . . . . . . . . . . 157 

DateUnder . . . . . . . . . . . . . . 158 

Day . . . . . . . . . . . . . . . . 159 

DayIdx . . . . . . . . . . . . . . . 160 

DayLen . . . . . . . . . . . . . . . 161 

DayNumPos. . . . . . . . . . . . . . 162 

DayNumRect . . . . . . . . . . . . . 163 

DayStart . . . . . . . . . . . . . . . 164 

DDEAddLink . . . . . . . . . . . . . 165 

DDEMode . . . . . . . . . . . . . . 167 

DDERmvLink . . . . . . . . . . . . . 168 

DeActivate . . . . . . . . . . . . . . 169 

Delete . . . . . . . . . . . . . . . . 170 

DeleteRow . . . . . . . . . . . . . . 171 

DelimChar . . . . . . . . . . . . . . 172 

DeSelect . . . . . . . . . . . . . . . 173 

Dialog . . . . . . . . . . . . . . . . 174 

DIRName . . . . . . . . . . . . . . 175 

DlgOwner . . . . . . . . . . . . . . 176 

DoEvents. . . . . . . . . . . . . . . 177 

iv VisualAge RPG Manual de consulta de componentes 

| 

DragEnable . . . . . . . . . . . . . . 178 

DropEnable . . . . . . . . . . . . . . 179 

DspHeight . . . . . . . . . . . . . . 180 

DspWidth . . . . . . . . . . . . . . 181 

EditItem . . . . . . . . . . . . . . . 182 

EnableBtn . . . . . . . . . . . . . . 183 

Enabled . . . . . . . . . . . . . . . 184 

Execute . . . . . . . . . . . . . . . 186 

ExecuteSQL . . . . . . . . . . . . . . 187 

ExtSelect . . . . . . . . . . . . . . . 188 

Fetch . . . . . . . . . . . . . . . . 189 

FetchNext . . . . . . . . . . . . . . 190 

FetchPrior . . . . . . . . . . . . . . 191 

FieldExit . . . . . . . . . . . . . . . 192 

FileName. . . . . . . . . . . . . . . 193 

FillStyle . . . . . . . . . . . . . . . 195 

FirstSel . . . . . . . . . . . . . . . 197 

Focus . . . . . . . . . . . . . . . . 198 

FontArea . . . . . . . . . . . . . . . 200 

FontBold . . . . . . . . . . . . . . . 202 

FontItalic . . . . . . . . . . . . . . . 204 

FontName . . . . . . . . . . . . . . 206 

FontSize . . . . . . . . . . . . . . . 207 

FontStrike . . . . . . . . . . . . . . 208 

FontUnder . . . . . . . . . . . . . . 210 

ForeColor . . . . . . . . . . . . . . 212 

ForeMix . . . . . . . . . . . . . . . 214 

Format . . . . . . . . . . . . . . . 216 

FrameRate . . . . . . . . . . . . . . 217 

FrmtString . . . . . . . . . . . . . . 218 

GetItem . . . . . . . . . . . . . . . 219 

GetNewID . . . . . . . . . . . . . . 220 

GetRcdFld . . . . . . . . . . . . . . 221 

GetRcdIcon . . . . . . . . . . . . . . 222 

GetRcdText . . . . . . . . . . . . . . 223 

GetTables. . . . . . . . . . . . . . . 224 

Ejemplo de GetTables. . . . . . . . . . 225 

GnEqGrpCol . . . . . . . . . . . . . 226 

GnEqPntCol . . . . . . . . . . . . . . 227 

GraphType . . . . . . . . . . . . . . 228 

GrphHiLite . . . . . . . . . . . . . . 229 

GroupLabel . . . . . . . . . . . . . . 230 

Handle . . . . . . . . . . . . . . . 231 

HasPrpPage . . . . . . . . . . . . . . 232 

HdgBGClr . . . . . . . . . . . . . . 233 

HdgBGMix . . . . . . . . . . . . . . 235 

HdgFGClr . . . . . . . . . . . . . . 236 

HdgFGMix . . . . . . . . . . . . . . 238 

HdgIdx . . . . . . . . . . . . . . . 239 

HdgText . . . . . . . . . . . . . . . 240 

Height. . . . . . . . . . . . . . . . 241 

HelpEnable . . . . . . . . . . . . . . 242 

HelpWindow . . . . . . . . . . . . . 244 

Hidden . . . . . . . . . . . . . . . 245 

HighLight . . . . . . . . . . . . . . 246 

HitItem . . . . . . . . . . . . . . . 248 

HlitPoints . . . . . . . . . . . . . . 250 

HRule . . . . . . . . . . . . . . . . 251 

IconHandle . . . . . . . . . . . . . . 252 

Index . . . . . . . . . . . . . . . . 253 

InPlace . . . . . . . . . . . . . . . 254

InsertItem . . . . . . . . . . . . . . 255 

InsertLine . . . . . . . . . . . . . . 256 

InsertMode . . . . . . . . . . . . . . 257 

InsertRow . . . . . . . . . . . . . . 258 

InsertText. . . . . . . . . . . . . . . 259 

Interval . . . . . . . . . . . . . . . 260 

InUse . . . . . . . . . . . . . . . . 261 

InvName . . . . . . . . . . . . . . . 262 

InvPName . . . . . . . . . . . . . . 263 

IsData. . . . . . . . . . . . . . . . 264 

Item . . . . . . . . . . . . . . . . 265 

ItemCount . . . . . . . . . . . . . . 267 

ItemKey . . . . . . . . . . . . . . . 268 

Label . . . . . . . . . . . . . . . . 269 

LabelPlace . . . . . . . . . . . . . . 271 

Left. . . . . . . . . . . . . . . . . 272 

LegendType . . . . . . . . . . . . . . 273 

Length . . . . . . . . . . . . . . . 274 

LineNumber. . . . . . . . . . . . . . 275 

LineText . . . . . . . . . . . . . . . 276 

LookNFeel . . . . . . . . . . . . . . 277 

Magnify . . . . . . . . . . . . . . . 278 

Masked . . . . . . . . . . . . . . . 279 

Maximum . . . . . . . . . . . . . . 280 

Method . . . . . . . . . . . . . . . 281 

Ejemplo de Method . . . . . . . . . . 281 

MiniIcon . . . . . . . . . . . . . . . 282 

Minimum . . . . . . . . . . . . . . 283 

Mode . . . . . . . . . . . . . . . . 284 

Month. . . . . . . . . . . . . . . . 285 

MonthArrow . . . . . . . . . . . . . 286 

MonthIdx . . . . . . . . . . . . . . 287 

MonthLen . . . . . . . . . . . . . . 288 

MouseIcon . . . . . . . . . . . . . . 289 

MouseShape. . . . . . . . . . . . . . 290 

MsgData . . . . . . . . . . . . . . . 292 

MsgFile . . . . . . . . . . . . . . . 293 

MsgID. . . . . . . . . . . . . . . . 294 

MsgSubText . . . . . . . . . . . . . . 295 

MsgText . . . . . . . . . . . . . . . 296 

Multiplier . . . . . . . . . . . . . . 297 

MultSelect . . . . . . . . . . . . . . 298 

Name . . . . . . . . . . . . . . . . 299 

NbrOfImage. . . . . . . . . . . . . . 300 

NbrOfLines . . . . . . . . . . . . . . 301 

NbrOfSel . . . . . . . . . . . . . . . 302 

NextLine . . . . . . . . . . . . . . . 303 

NextPage . . . . . . . . . . . . . . . 304 

NotSrcEvt . . . . . . . . . . . . . . 305 

NotSrcPart . . . . . . . . . . . . . . 306 

NotSrcWin . . . . . . . . . . . . . . 307 

OCXProp. . . . . . . . . . . . . . . 308 

OCXValue . . . . . . . . . . . . . . 309 

OpenEdit . . . . . . . . . . . . . . . 310 

OS . . . . . . . . . . . . . . . . . 311 

OutlineRcl . . . . . . . . . . . . . . 312 

PageNumber . . . . . . . . . . . . . 313 

PageSize . . . . . . . . . . . . . . . 314 

Panel . . . . . . . . . . . . . . . . 315 

PanelItem . . . . . . . . . . . . . . 317 

PanelMode . . . . . . . . . . . . . . 319 

| 

| 

Parent. . . . . . . . . . . . . . . . 320 

ParentId . . . . . . . . . . . . . . . 322 

ParentList . . . . . . . . . . . . . . 323 

ParentName . . . . . . . . . . . . . . 324 

PartCount . . . . . . . . . . . . . . 325 

PartList . . . . . . . . . . . . . . . 326 

PartName . . . . . . . . . . . . . . 327 

PartType . . . . . . . . . . . . . . . 328 

Paste . . . . . . . . . . . . . . . . 329 

PBRange . . . . . . . . . . . . . . . 330 

PBSetPos . . . . . . . . . . . . . . . 331 

PBStep . . . . . . . . . . . . . . . 332 

PBStepSize . . . . . . . . . . . . . . 333 

Platform . . . . . . . . . . . . . . . 334 

PlugCmd . . . . . . . . . . . . . . . 335 

PlugDLL . . . . . . . . . . . . . . . 336 

PlugID . . . . . . . . . . . . . . . 337 

PlugRC . . . . . . . . . . . . . . . 338 

PlugResult . . . . . . . . . . . . . . 339 

Poke . . . . . . . . . . . . . . . . 340 

Position . . . . . . . . . . . . . . . 341 

PrevLine . . . . . . . . . . . . . . . 342 

PrevPage . . . . . . . . . . . . . . . 343 

Print . . . . . . . . . . . . . . . . 344 

Printer. . . . . . . . . . . . . . . . 345 

ProgresBar . . . . . . . . . . . . . . 346 

Range . . . . . . . . . . . . . . . . 347 

ReadOnly . . . . . . . . . . . . . . 348 

RecordID . . . . . . . . . . . . . . . 350 

RefAttr . . . . . . . . . . . . . . . 351 

RefParent. . . . . . . . . . . . . . . 352 

RefPart . . . . . . . . . . . . . . . 353 

Refresh . . . . . . . . . . . . . . . 354 

RemoveItem. . . . . . . . . . . . . . 355 

RemoveLink. . . . . . . . . . . . . . 356 

RemoveMsg . . . . . . . . . . . . . . 357 

RemoveRcd . . . . . . . . . . . . . . 358 

Request . . . . . . . . . . . . . . . 359 

RmvSrcEvt . . . . . . . . . . . . . . 360 

RmvEvent . . . . . . . . . . . . . . 361 

RowBGClr . . . . . . . . . . . . . . 362 

RowBGMix . . . . . . . . . . . . . . 364 

RowFGClr . . . . . . . . . . . . . . 365 

RowFGMix . . . . . . . . . . . . . . 367 

Rows . . . . . . . . . . . . . . . . 368 

SBIndex . . . . . . . . . . . . . . . 369 

SBLabel . . . . . . . . . . . . . . . 370 

SBPanes . . . . . . . . . . . . . . . 371 

SBPosition . . . . . . . . . . . . . . 372 

SBStyle . . . . . . . . . . . . . . . 373 

Scale . . . . . . . . . . . . . . . . 374 

Search . . . . . . . . . . . . . . . . 375 

SearchType . . . . . . . . . . . . . . 376 

Selected . . . . . . . . . . . . . . . 377 

SelectIdx . . . . . . . . . . . . . . . 378 

SelectItem . . . . . . . . . . . . . . 379 

SelectList . . . . . . . . . . . . . . . 380 

Ejemplo de SelectList . . . . . . . . . . 380 

SelectRcd . . . . . . . . . . . . . . . 381 

SelPrinter. . . . . . . . . . . . . . . 382 

Sequence . . . . . . . . . . . . . . . 383 

Contenido v

SetItem . . . . . . . . . . . . . . . 385 

SetRcdFld . . . . . . . . . . . . . . 386 

SetRcdIcon . . . . . . . . . . . . . . 387 

SetRcdText . . . . . . . . . . . . . . 388 

SetTop. . . . . . . . . . . . . . . . 389 

SflNxtChg . . . . . . . . . . . . . . 390 

ShData . . . . . . . . . . . . . . . 391 

ShDataLen . . . . . . . . . . . . . . 392 

ShDataName . . . . . . . . . . . . . 393 

ShDataPos . . . . . . . . . . . . . . 394 

ShowMsgID . . . . . . . . . . . . . . 395 

ShowProp . . . . . . . . . . . . . . 396 

ShowRects . . . . . . . . . . . . . . 397 

ShowTabs . . . . . . . . . . . . . . 398 

ShowText. . . . . . . . . . . . . . . 399 

ShowTips. . . . . . . . . . . . . . . 400 

SizeToFit . . . . . . . . . . . . . . . 401 

SortAsc . . . . . . . . . . . . . . . 402 

SortDesc . . . . . . . . . . . . . . . 403 

SQLError . . . . . . . . . . . . . . . 404 

SQLMsgBox . . . . . . . . . . . . . . 405 

SQLQuery . . . . . . . . . . . . . . 406 

StartAt . . . . . . . . . . . . . . . 407 

Ejemplo de StartAt . . . . . . . . . . 408 

StartNew . . . . . . . . . . . . . . . 409 

StatusBar . . . . . . . . . . . . . . . 410 

SwitchTo . . . . . . . . . . . . . . . 411 

TabImage. . . . . . . . . . . . . . . 412 

TabLabel . . . . . . . . . . . . . . . 413 

Text . . . . . . . . . . . . . . . . 414 

TextEnd . . . . . . . . . . . . . . . 415 

TextLength . . . . . . . . . . . . . . 416 

TextSelect. . . . . . . . . . . . . . . 417 

TextStart . . . . . . . . . . . . . . . 418 

TextString . . . . . . . . . . . . . . 419 

TickLabel . . . . . . . . . . . . . . . 420 

TickNumber . . . . . . . . . . . . . . 421 

Tile. . . . . . . . . . . . . . . . . 422 

TimeOut . . . . . . . . . . . . . . . 423 

TimerMode . . . . . . . . . . . . . . 424 

TimerTicks . . . . . . . . . . . . . . 425 

TipText . . . . . . . . . . . . . . . 426 

Title . . . . . . . . . . . . . . . . 427 

TitlePlace . . . . . . . . . . . . . . . 428 

Top. . . . . . . . . . . . . . . . . 429 

Topic . . . . . . . . . . . . . . . . 430 

TopLine . . . . . . . . . . . . . . . 431 

TopRecord . . . . . . . . . . . . . . 432 

Treble . . . . . . . . . . . . . . . . 433 

UnBind . . . . . . . . . . . . . . . 434 

UnderPoint . . . . . . . . . . . . . . 435 

Undo . . . . . . . . . . . . . . . . 436 

UpdateRow . . . . . . . . . . . . . . 437 

UseData . . . . . . . . . . . . . . . 438 

UseDelim. . . . . . . . . . . . . . . 439 

UserData . . . . . . . . . . . . . . . 440 

Validate . . . . . . . . . . . . . . . 441 

Value . . . . . . . . . . . . . . . . 443 

View . . . . . . . . . . . . . . . . 444 

Visible. . . . . . . . . . . . . . . . 445 

VisTitle . . . . . . . . . . . . . . . 447 

vi VisualAge RPG Manual de consulta de componentes 

| 

VisTitlSep . . . . . . . . . . . . . . 448 

Volume . . . . . . . . . . . . . . . 449 

VRule . . . . . . . . . . . . . . . . 450 

WeekDay . . . . . . . . . . . . . . . 451 

WeekDayIdx. . . . . . . . . . . . . . 452 

Width . . . . . . . . . . . . . . . . 453 

WindowMode . . . . . . . . . . . . . 454 

WordWrap . . . . . . . . . . . . . . 455 

WrkStnName . . . . . . . . . . . . . 456 

X . . . . . . . . . . . . . . . . . 457 

XAxisLabel . . . . . . . . . . . . . . 458 

Y . . . . . . . . . . . . . . . . . 459 

YAxisLabel . . . . . . . . . . . . . . 460 

Year . . . . . . . . . . . . . . . . 461 

YearIdx . . . . . . . . . . . . . . . 462 

YearLen . . . . . . . . . . . . . . . 463 

Yinc . . . . . . . . . . . . . . . . 464 

Capítulo 3. Eventos de componentes 465 

Activate . . . . . . . . . . . . . . . 465 

BeanEvent . . . . . . . . . . . . . . 465 

Change . . . . . . . . . . . . . . . 466 

Click . . . . . . . . . . . . . . . . 466 

Close . . . . . . . . . . . . . . . . 467 

Collapsed . . . . . . . . . . . . . . 467 

ColSelect . . . . . . . . . . . . . . . 467 

Complete. . . . . . . . . . . . . . . 467 

Create . . . . . . . . . . . . . . . . 468 

Data . . . . . . . . . . . . . . . . 468 

DblClick . . . . . . . . . . . . . . . 469 

DeActivate . . . . . . . . . . . . . . 469 

Destroy . . . . . . . . . . . . . . . 469 

Drop . . . . . . . . . . . . . . . . 470 

DropDown . . . . . . . . . . . . . . 470 

Enter . . . . . . . . . . . . . . . . 471 

ExecuteAck . . . . . . . . . . . . . . 471 

Expanded . . . . . . . . . . . . . . 471 

FirstRec . . . . . . . . . . . . . . . 472 

GotFocus . . . . . . . . . . . . . . . 472 

KeyPress . . . . . . . . . . . . . . . 472 

LastRec . . . . . . . . . . . . . . . 473 

LClickTray . . . . . . . . . . . . . . 473 

Link . . . . . . . . . . . . . . . . 473 

LostFocus . . . . . . . . . . . . . . 473 

MenuSelect . . . . . . . . . . . . . . 474 

MouseDown. . . . . . . . . . . . . . 474 

MouseEnter . . . . . . . . . . . . . . 474 

MouseExit . . . . . . . . . . . . . . 475 

MouseMove . . . . . . . . . . . . . . 475 

MouseUp. . . . . . . . . . . . . . . 476 

Moved . . . . . . . . . . . . . . . 476 

MthChange . . . . . . . . . . . . . . 476 

NextRec . . . . . . . . . . . . . . . 476 

Notify . . . . . . . . . . . . . . . . 477 

OCXEvent . . . . . . . . . . . . . . 477 

PageDown . . . . . . . . . . . . . . 477 

PageEnd . . . . . . . . . . . . . . . 478 

PageSelect . . . . . . . . . . . . . . 478 

PageTop . . . . . . . . . . . . . . . 478 

PageUp . . . . . . . . . . . . . . . 478 

PokeAck . . . . . . . . . . . . . . . 479

Popup . . . . . . . . . . . . . . . . 479 

Press . . . . . . . . . . . . . . . . 480 

PrevRec . . . . . . . . . . . . . . . 480 

RClickTray . . . . . . . . . . . . . . 480 

ReSize . . . . . . . . . . . . . . . . 480 

Scroll . . . . . . . . . . . . . . . . 481 

Select . . . . . . . . . . . . . . . . 481 

ShutDown . . . . . . . . . . . . . . 481 

SpinDown . . . . . . . . . . . . . . 482 

SpinEnd . . . . . . . . . . . . . . . 482 

SpinUp . . . . . . . . . . . . . . . 482 

Terminate . . . . . . . . . . . . . . 482 

Tick . . . . . . . . . . . . . . . . 483 

Timeout . . . . . . . . . . . . . . . 483 

VKeyPress . . . . . . . . . . . . . . 484 

YearChange . . . . . . . . . . . . . . 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 . . . . . . . . . . . . . . 507 

Información de interfaz de programación . . . . 508 

Marcas 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 de 

VisualAge ® para RPG, que se utilizan para crear la aplicación de interfaz gráfica 

de usuario (GUI); los atributos y los eventos asociados con cada componente; y 

los atributos de evento que puede consultar en la aplicación VARPG. Está 

destinado a aquellas personas que programan aplicaciones mediante VisualAge 

RPG. 

Antes de utilizar este manual, debería leer la publicación Iniciación a VisualAge RPG 

y CODE/400. 

Convenios de resaltado que se utilizan en este manual 

A lo largo de este manual, todos los nombres de atributos, eventos y atributos de 

eventos aparecen en el tipo negrita, al igual que un término en su primera 

aparición, otros términos enfatizados y cualquier referencia a texto que aparezca en 

la interfaz de VisualAge RPG. Las variables aparecen en cursiva. Los códigos de 

operación de VisualAge RPG aparecen TOTALMENTE EN MAYÚSCULAS. 

Requisito previo e información relacionada 

La biblioteca VisualAge RPG 

Utilice el centro de información de AS/400 ® como punto de partida para consultar 

información técnica sobre AS/400. Puede acceder al Information Center desde el 

CD-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/infocenter 

http://publib.boulder.ibm.com/pubs/html/as400/infocenter.htm 

El centro de información de AS/400 contiene temas importantes como, por 

ejemplo, particiones lógicas, sistemas en clusters, Java, TCP/IP, servicios de Web y 

redes seguras. También contiene enlaces de Internet a páginas Web como, por 

ejemplo, la biblioteca en línea de AS/400 y el estudio técnico de AS/400. En el 

centro de información hay un enlace que describe a un nivel superior las 

diferencias 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). 

*Nota: Se han actualizado todas las versiones en línea de las publicaciones de 

WebSphere Development Tools para AS/400. Las publicaciones cuyo título 

está marcado con un asterisco (*) no se han vuelto a imprimir en este 

release. 

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 de 

VisualAge 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 de 

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 de programación para aclarar los conceptos y el proceso del 

desarrollo de aplicaciones VisualAge RPG. 

*VisualAge RPG Manual de consulta de componentes 

Esta publicación proporciona información sobre los componentes, atributos de 

componente, eventos de componente y atributos de evento de VisualAge RPG. Es 

un manual de consulta para todos aquellos que desarrollan aplicaciones con 

VisualAge RPG. 

*VisualAge RPG Manual de consulta del lenguaje 

Esta publicación proporciona información acerca del lenguaje RPG IV tal como se 

implementa 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 datos 

v Manejo de errores y de excepciones 

v Especificaciones 

v Funciones incorporadas, expresiones y códigos de operación. 

Para obtener una lista de publicaciones relacionadas, consulte la bibliografía al 

final 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 poder 

volver fácilmente al último ejercicio realizado. Hay unas pruebas al final de cada 

lección que sirven de ayuda para probar los conocimientos adquiridos de la 

unidad. 

Nota: Para poder utilizar esta guía de aprendizaje, necesitará un navegador que 

admita marcos, Java ® y Javascript. También necesitará una herramienta de 

extracción de archivos, como es WinZip, que pueda manejar nombres largos 

de archivos. 

También puede encontrar la información más reciente sobre VA RPG y CODE/400 

en las siguientes fuentes en línea: 

La página de presentación de VisualAge RPG y CODE/400 

http://www.ibm.com/software/ad/varpg/ 

x VisualAge RPG Manual de consulta de componentes

Cómo enviar comentarios 

Sus opiniones son importantes para ayudarnos a proporcionar la información más 

exacta y de mayor calidad posible. IBM agradece todos los comentarios sobre esta 

publicació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 Center 

Avda. Diagonal, 571 

08029 Barcelona 

España 

Si envía una hoja de comentarios del cliente desde un país fuera de Estados 

Unidos, puede entregar la hoja de comentarios a la sucursal IBM local o al 

representante 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 de 

las direcciones siguientes: 

– Comentarios sobre publicaciones 

hojacom@vnet.ibm.com 

IBMLink: to toribm(torrcf) 

– Comentarios sobre el centro de información de AS/400: 

RCHINFOC@us.ibm.com 

Asegúrese de indicar lo siguiente: 

v El título del libro 

v El número de la publicación 

v El número de página o el tema al que hace referencia el comentario. 

Acceso a la información en línea 

VisualAge RPG tiene varios manuales en línea y ayuda en línea. Puede acceder a 

la 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ínea 

Para 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 y 

CODE400. 

Publicaciones en formato PDF 

Todas las publicaciones de VA RPG y CODE/400 se incluyen como parte de la 

ayuda habitual para el producto. Además del formato normal, el producto también 

contiene la versión PDF de las publicaciones. 

Nota: Debe disponer del programa Adobe Acrobat Reader, Versión 3.01 o superior 

para 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 de 

la página Web de Adobe Systems (http://www.adobe.com). 

En la ayuda en línea están disponibles las siguientes publicaciones en formato 

PDF: 

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 de 

WebSphere Development Tools para AS/400. 

Utilización de ayuda en línea 

Hay ayuda en línea disponible para todas las áreas de VisualAge RPG. Para 

obtener ayuda para una ventana determinada, un recuadro de diálogo o un 

cuaderno de propiedades, seleccione el pulsador Ayuda (si está disponible). 

Nota: Para ver la ayuda que está en formato HTML, la estación de trabajo debe 

tener un navegador Web que soporte marcos como, por ejemplo Netscape 

Navigator 4.04 o superior, o Microsoft ® Internet Explorer 4.01 o superior. (El 

navegador recomendado es Netscape Navigator 4.6 o Internet Explorer 5.0) 

Utilización de ayuda según el contexto 

Para obtener ayuda sensible al contexto en cualquier momento, pulse F1. La ayuda 

que aparece es específica del área de la interfaz que tiene foco de entrada. El foco 

de entrada puede estar en elementos de menú, ventanas, recuadros de diálogo y 

cuadernos 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ón 

sobre el signo de interrogación (si está disponible) en el extremo superior derecho 

de 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 ayuda 

sobre ese determinado campo. 

Utilización de hipertexto 

Algunas ventanas de ayuda contienen palabras, frases o gráficos que aparecen 

resaltados. Son enlaces de hipertexto que llevan de un tema a otro. Para visualizar 

ayuda específica de un tema resaltado, pulse en él. Cuando siga un enlace de 

hipertexto, puede aparecer un botón Sincronizar en la esquina superior derecha 

del tema de ayuda. (Quizás deba retroceder páginas para verlo). Si pulsa el botón 

Sincronizar, la lista de temas del marco izquierdo se renueva a fin de mostrarle el 

lugar que ocupa el tema actual en la tabla de contenido general. 

Utilización de la tabla de contenido de la ayuda 

Cuando 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ón 

correspondiente al componente deseado. Para ver un tema, pulse en él. 

Utilización del recurso de búsqueda 

El sistema de ayuda VisualAge RPG y CODE/400 utiliza un motor de búsqueda 

avanzado de texto completo, que devuelve ″aciertos″ o ″coincidencias″ HTML 

basados 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 área 

de 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 intento 

de búsqueda. De lo contrario, aparece la página Resultado de la búsqueda con 

una lista de temas en los que se ha encontrado la palabra o frase. Pulse el 

enlace que desee ver. 

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

documentos que debe devolverse. 

Si desea obtener consejos para refinar las búsquedas, puede ver el tema Cómo 

buscar información en la ayuda en línea. 

Utilización de ayuda según el lenguaje 

Para obtener ayuda según el lenguaje, pulse F1 en una ventana de edición. Si el 

cursor está en un código de operación, recibirá ayuda para ese código de 

operació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 release 

de IBM VisualAge RPG y CODE (Cooperative Development Environment) para 

AS/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 que 

está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 

ActiveX 

Los componentes son los bloques de construcción que se utilizan al crear una 

aplicación GUI (interfaz gráfica de usuario). Actúan como plantillas sobre las que 

se construye, permitiendo al usuario crear diseños de forma rápida y sencilla. Cada 

componente tiene asociados atributos y eventos. 

Este capítulo describe los componentes de VisualAge ® 

RPG. Cada una de las 

descripciones contiene lo siguiente: 

v Una descripción general del componente 

v Una lista de los atributos que se aplican al componente 

v Una lista de los eventos que se aplican al componente 

v Cualquier restricción que se aplique 

* 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. (Otros 

proveedores se encargan del desarrollo y suministro de los controles ActiveX.) 

Debe estar familiarizado con los controles ActiveX que añade. El Diseñador GUI de 

VARPG no puede controlar las funciones que proporcionan estos componentes. 

Nota: VARPG sólo trabaja con controles ActiveX que tengan interfaces escritas en 

C++. Consulte con su suministrador de controles ActiveX para asegurarse de 

que VARPG funcionará con el control ActiveX que desea utilizar. 

© Copyright IBM Corp. 1994, 2000 1

Atributos de componente 

Activate AddEvent Bottom DeActivate 

HasPrpPage Height Left Method 

OCXProp OCXValue ParentName PartName 

PartType Refresh RmvEvent ShowProp 

Top 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 reproduce 

los archivos de vídeo con la extensión AVI. Este componente se distingue del 

componente medios en que el vídeo se reproduce independientemente de la lógica 

del programa. Un uso habitual de este componente es visualizar un archivo AVI 

que muestre un progreso como, por ejemplo, un archivo que se traspase de una 

carpeta a otra. 

El componente control de animación reproduce los archivos de vídeo sin sonido. El 

archivo AVI no puede estar en formato comprimido a menos que se haya 

comprimido con el método RLE (Running-Length Encoded). 

En las aplicaciones Java, el componente control de animación se utiliza para 

reproducir una secuencia de archivos GIF utilizando el atributo NbrOfImage. 


FileName FrameRate Handle* Left 

Mode NbrOfImage ParentName PartName 

PartType Top UserData Visible 

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

restricciones. 


Create Destroy 

Capítulo 1. Componentes 3

Calendario 

El componente calendario presenta un calendario por meses. Al efectuar una 

pulsación sobre una de las flechas de los meses, el usuario puede navegar por el 

calendario y desplazarse al mes anterior o posterior. 

También tiene un control del programa absoluto sobre el calendario para 

desplazarse hasta una fecha específica, determinar qué fecha ha seleccionado el 

usuario y añadir breves comentarios de texto a días individuales en el calendario. 


Border Bottom ClearAll ClearDate 

ClearMonth ClearYear Color ColorArea 

ColorMix Date DateIdx DateText 

DateUnder Day DayIdx DayLen 

DayNumPos DayNumRect DayStart Enabled 

FontArea FontBold FontItalic FontName 

FontSize FontStrike* FontUnder* FrmtString 

Handle* Height HRule Left 

Month MonthArrow MonthIdx MonthLen 

OutlineRcl ParentName PartName PartType 

Refresh ShowRects ShowText TipText 

Top UserData Visible VRule 

WeekDay WeekDayIdx Width Year 

YearIdx YearLen 

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



Click Create Destroy DblClick 

MouseDown MouseEnter MouseExit MouseMove 

MouseUp MthChange YearChange 


Lienzo 

Utilice el componente lienzo con una ventana o una página de cuaderno si desea 

poner más de un componente en la ventana o en la página de cuaderno. Puede 

colocar diversos componentes en el lienzo señalándolos y pulsando el botón del 

rató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 de 

cuaderno. Si en la ventana o en la página de cuaderno no hay lienzo, sólo puede 

colocar un componente en el área de cliente, a menos que sean extensiones de la 

ventana, como barras de menús y subarchivos de mensajes. 

A menudo creará ventanas y páginas de cuaderno que contendrán más de un 

componente. En este caso, deberá utilizar los componentes página de cuaderno y 

con lienzo y la ventana con lienzo. Así se ahorrará un paso, ya que estos 

componentes ya contienen el componente lienzo. 

En tiempo de creación de la aplicación, también puede incluir una imagen de 

bitmap a modo de fondo del lienzo; para ello, especifique el atributo FileName. 

Esta imagen puede ponerse en mosaico estableciendo el atributo Tile. Enlas 

aplicaciones 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 el 

valor de font por omisión (Font del sistema por omisión), heredarán la definición 

de font especificada en el componente lienzo. Para aplicar un font determinado 

a la mayor parte de componentes de un lienzo, especifique ese font en el 

componente lienzo en lugar de hacerlo en cada componente individual. 

Para obtener información relacionada, consulte el apartado: 

v “Ventana” en la página 49 

v “Ventana con lienzo” en la página 50 

v “Página de cuaderno” en la página 32 

v “Página de cuaderno con lienzo” en la página 33. 



BackColor BackMix Bottom* Enabled 

FileName FontBold FontItalic FontName 

FontSize FontStrike* FontUnder* Handle* 

Height Left ParentName PartName 

PartType ReadOnly Refresh Tile 

Top* UserData Width 




Click Create DblClick Destroy 

MouseDown MouseMove MouseUp Popup 


Recuadro de selección 

Utilice el componente recuadro de selección si desea que el usuario elija entre dos 

estados claramente diferenciados; por ejemplo, activado y desactivado. 

Una etiqueta asociada con el recuadro de selección describe el valor del mismo 

cuando se selecciona. 

Normalmente, se utiliza un grupo de recuadros de selección para proporcionar una 

lista de opciones. El usuario puede seleccionar uno, varios o ningún recuadro. Las 

opciones no son mutuamente excluyentes; por lo tanto, marcar un recuadro de 

selección no tiene ningún efecto en otros recuadros de la ventana. Si desea que el 

usuario pueda seleccionar sólo una opción de un grupo de dos o más, utilice 

botones de selección. Consulte el apartado “Botón de selección” en la página 40 si 

desea más información. 

Para definir el estado de un recuadro de selección, el usuario puede pulsar el 

botón del ratón en el mismo, pulsar la barra espaciadora cuando el recuadro tenga 

el 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 la 

publicación Programación con VisualAge para RPG, SC10-3067-02 (SC09-2449-02). 


AddLink* AllowLink* BackColor BackMix 

Bottom Checked Enabled Focus 

FontBold FontItalic FontName FontSize 

FontStrike* FontUnder* ForeColor ForeMix 

Handle* Height Highlight* Label 

Left ParentName PartName PartType 

Refresh RemoveLink* ShowTips TipText 





Create Destroy MouseEnter MouseExit 

MouseMove Popup Select 


Recuadro de combinación 

Un recuadro de combinación ofrece al usuario la opción de escribir información 

especí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 que 

presenta una lista de valores por la que el usuario puede desplazarse. Si el usuario 

selecciona uno de estos valores, aparecerá en el campo de entrada sustituyendo 

cualquier texto que hubiese antes. De manera alternativa, el usuario puede escribir 

un valor, que no tiene por qué coincidir con ninguno de los que aparecen en la 

lista, directamente en el campo de entrada. 

Hay disponibles varios estilos de recuadros de combinación. Puede seleccionar el 

estilo 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 24 

v “Campo de entrada” en la página 14 


AddItemEnd AutoScroll* BackColor BackMix 

Bottom Case* Count DelimChar 

DeSelect* DragEnable* DropEnable* Enabled 

FieldExit FirstSel Focus FontBold 

FontItalic FontName FontSize FontStrike* 

FontUnder* ForeColor ForeMix GetItem 

Handle* Height Index InsertItem* 

ItemKey Left ParentName PartName 

PartType ReadOnly Refresh RemoveItem 

Search* SearchType* Selected SelectItem 

Sequence* SetItem SetTop* Showtips 

SizeToFit* Text TipText Top 

UseDelim UserData Visible Width 

8 VisualAge RPG Manual de consulta de componentes 

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

restricciones.


Change Create Destroy Drop* 

DropDown* Enter GotFocus KeyPress 

LostFocus MouseEnter MouseExit MouseMove 

Popup Select VKeyPress 

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



*Component 

Este componente permite a los programadores acceder y utilizar atributos de 

componente lógico y del sistema. 

Un componente *component es la ″representación del componente″ del 

componente lógico. Para cada componente lógico se crea un componente 

*component; no se ve y no está en la paleta. 


Active* Alarm AppData Button 

ClipBoard CurrentDir Dialog DIRName* 

DlgOwner DoEvents* DspHeight DspWidth 

FileName HelpWindow LookNFeel* MsgData 

MsgFile* MsgID MsgText Name 

OS Parent PartCount PartList 

Platform PlugCmd* PlugDLL* PlugID* 

PlugRC* PlugResult* Printer* SelPrinter* 

ShData ShDataLen ShDataName ShDataPos 

ShowMsgID SwitchTo* WrkStnName* 




Este componente no tiene eventos asociados. 


| 

| 

Referencia a componente lógico 

El componente referencia a componente lógico permite que un componente lógico 

de VARPG se comunique con otro. Utilice el componente referencia a componente 

lógico para afectar a un componente del otro componente lógico. El componente 

lógico al que se hace referencia debe estar ejecutándose en la misma aplicación que 

el componente referencia a componente lógico. 

El componente referencia a componente lógico también supervisa un evento 

especificado en el otro componente lógico. Cuando se produzca el evento 

supervisado, el componente referencia a componente lógico señalará un evento 

Notify. 


AddSrcEvt AttrValue Bottom CompName 

Left NotSrcEvt NotSrcPart NotSrcWin 

ParentName PartName PartType RefAttr 

RefParent RefPart RmvSrcEvt UserData 

Visible 


Create Destroy Notify 


| 

Contenedor 

Utilice el componente contenedor para almacenar registros relacionados. Los 

registros se pueden mostrar en una vista de iconos, de árbol, de árbol de texto o de 

detalles. 


AddRcd Arrange BackColor BackMix 

BlankChar Bottom ChildCount ChildList 

Collapsed ColNumber Count DeSelect 

EditItem Enabled ExtSelect* FirstSel 

Focus FontBold FontItalic FontName 

FontSize FontStrike* FontUnder* ForeColor 

ForeMix GetNewID GetRcdFld GetRcdIcon 

GetRcdText Handle* Height InUse* 

Label Left MiniIcon ParentId 

ParentList ParentName PartName PartType 

ReadOnly RecordID Refresh RemoveRcd 

Selected SelectRcd SetRcdFld SetRcdIcon 

SetRcdText SetTop* ShowTips SortAsc 

SortDesc TipText Top UserData 

View* Visible VisTitle VisTitlSep 

Width 




Click Collapsed ColSelect Create 

DblClick Destroy Enter Expanded 

GotFocus KeyPress LostFocus MouseDown 

MouseEnter MouseExit MouseMove MouseUp 

Popup Select VKeyPress 


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 intercambio 

dinámico de datos (DDE). 

Este intercambio recibe el nombre de conversación DDE. La aplicación que inicia 

la conversación es el cliente y la aplicación que responde es el servidor. Para 

determinar si una aplicación da soporte a DDE, consulte la documentación que se 

ha entregado con ella. 

El componente cliente DDE da soporte a las conversaciones de enlace estático y 

enlace dinámico. Una conversación de enlace estático consta de un programa 

cliente que realiza peticiones explícitas al programa servidor. Una conversación de 

enlace dinámico consta de un programa servidor que actualiza automáticamente el 

programa cliente cuando se modifican sus datos. 

Puede configurar conversaciones de enlace estático o dinámico en el cuaderno de 

propiedades del componente cliente DDE y en la lógica del programa. 


AppName Bottom DDEAddLink DDEMode 

DDERmvLink Execute Format Item 


Poke Request TimeOut Top 

Topic UserData Visible 


Create Data Destroy ExecuteAck 

PokeAck Terminate TimeOut 


Campo de entrada 

Utilice el componente campo de entrada si desea que el usuario pueda especificar 

valores que no se pueden predecir. Un campo de entrada es un área en la que el 

usuario puede escribir o colocar texto. Sus límites suelen estar indicados. El 

usuario puede desplazarse por el texto del campo de entrada si hay más 

información disponible de la que resulta visible. 

Puede configurar el componente campo de entrada para que acepte datos de tipo 

carácter, numéricos o de doble byte (DBCS). 

También puede hacer que el campo de entrada sea de sólo lectura, para que el 

usuario no pueda modificar la información que contiene directamente. 

Puede señalar y pulsar un componente campo de entrada en la paleta de 

componentes y después pulsar el botón del ratón en el componente subarchivo 

para crear un campo de entrada de subarchivo. 


AddLink* Alignment AllowLink* AutoScroll* 

AutoSelect BackColor BackMix Bottom 

CapsLock Copy CsrAtEnd Cut 

DataType Delete DragEnable* DropEnable* 

Enabled FieldExit Focus FontBold 


FontUnder* ForeColor ForeMix Handle* 

Height InsertMode* Left Masked 

ParentName PartName PartType Paste 

ReadOnly Refresh RemoveLink* ShowTips 

Text TextEnd TextLength TextSelect 

TextStart TipText Top UserData 

Visible Width 



restricciones.


Change Click Create DblClick 

Destroy Drop GotFocus KeyPress 

Link* LostFocus MouseDown MouseEnter 

MouseExit MouseMove MouseUp Popup 

VKeyPress 




| 

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 de 

gráfico y el tipo de gráfico. El componente gráfica da soporte a los tipos de gráfica 

circular, 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 texto 

ToolTip. Si está habilitado, al mover el ratón sobre un punto de datos se visualiza 

el control de texto de ayuda flotante. Para utilizar este soporte en la lógica del 

programa, debe establecer el valor del punto en el atributo TipText y activar el 

atributo ShowTips para la ventana que contiene el componente gráfica. 


AutoInc BarLabel Bottom Color 

ColorArea ColorMix DataGroup DataPoint 

DataValue Enabled FillStyle* FontArea 


FontStrike* FontUnder* GnEqGrpCol GnEqPntCol 

GraphType GroupLabel GrphHiLite Handle* 

Height HitItem* HlitPoints* LabelPlace 

Left LegendType ParentName PartName 

PartType Refresh StartNew TipText 

Title TitlePlace Top UnderPoint* 

UseData UserData Visible Width 

XAxisLabel YAxisLabel YInc 




Click Create Destroy DblClick 

MouseDown MouseEnter MouseExit MouseMove 

MouseUp 


Pulsador gráfico 

Utilice pulsadores gráficos para proporcionar un acceso fácil a las acciones 

utilizadas con frecuencia. 

El pulsador gráfico proporciona la misma función que un pulsador. Indica una 

acción que se iniciará cuando el usuario lo seleccione, pero en lugar de visualizar 

una etiqueta que describa su función, muestra una imagen. El atributo FileName 

especifica 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/Aldus 

v GIF (Formato de Intercambio de Gráficos) de CompuServe 

v PCX (Formato de Archivo de Imagen) de ZSoft PC Paintbrush 

v TGA, VST, AFI (Bitmap Targa/Vista) de Truevision 

v IFF, ILBM (Formato de Bitmap Intercalado) de Amiga 

v XBM (Bitmap) de X Windows 

v PSE, PSEG, PSEG38PP, PSEG3820 (Segmento de Página de Impresora) de IBM 

Los formatos válidos de imágenes Java son: 


v JPG, JPEG (formato Joint Photographic Experts Group) 

Para obtener información relacionada, consulte el apartado “Pulsador” en la 

página 39. 



Bottom Enabled FileName Focus 

Handle* Height HelpEnable HighLight 


Refresh ShowTips TipText Top 

UserData Validate Visible Width 




Create Destroy GotFocus LostFocus 

MouseEnter MouseExit MouseMove Popup 

Press 


Recuadro de grupo 

Utilice un recuadro de grupo para distinguir visualmente un grupo de 

componentes de una ventana. 

Un recuadro de grupo es un rectángulo trazado alrededor de un grupo de 

componentes para indicar que están relacionados. Por lo general, es recomendable 

poner una etiqueta a un recuadro de grupo. Si no se precisa una etiqueta, puede 

utilizar un recuadro de contorno. 


Bottom Enabled FontBold FontItalic 

FontName FontSize FontStrike* FontUnder* 

ForeColor ForeMix Handle* Height 

Label Left ParentName PartName 

PartType Refresh Top UserData 

Visible Width 

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





Barra de desplazamiento horizontal 

Utilice el componente barra de desplazamiento horizontal para poder desplazarse 

por un panel de información de izquierda a derecha o viceversa. La información 

puede ser una lista de archivos, 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 los objetos por los que se efectuará el desplazamiento y el atributo 

PageSize para determinar el número de objetos que pueden visualizarse en una 

página. 


Bottom Enabled Focus Handle* 

Height Left NextLine NextPage 

PageSize ParentName PartName PartType 

Position PrevLine PrevPage Range 





Create Destroy Scroll 


Imagen 

Utilice el componente imagen para visualizar imágenes. El atributo FileName 

especifica 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/Aldus 


v PCX (Formato de Archivo de Imagen) de ZSoft PC Paintbrush 

v TGA, VST, AFI (Bitmap Targa/Vista) de Truevision 

v IFF, ILBM (Formato de Bitmap Intercalado) de Amiga 

v XBM (Bitmap) de X Windows 

v PSE, PSEG, PSEG38PP, PSEG3820 (Segmento de Página de Impresora) de IBM 

Los formatos válidos de imágenes Java son: 


v JPG, JPEG (formato Joint Photographic Experts Group) 

Estos archivos residen en la estación de trabajo programable (PWS), no en el 

sistema principal. Debe almacenar los archivos de bitmap y de icono específicos 

del sistema en el directorio de tiempo de ejecución adecuado (RT_JAVA o 

RT_WIN32) para que el programa de utilidad de empaquetado los incluya al crear 

el paquete de la aplicación. 

Nota: El componente imagen sólo se puede soltar en una página de cuaderno con 

lienzo o en una ventana con lienzo. 




Border Bottom Enabled FileName 

Handle* Height Left Magnify 

Panel ParentName PartName PartType 

Print Refresh RemoveLink* ShowTips 

TipText Top UserData Visible 

Width 





Link* MouseEnter MouseExit MouseMove 


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

restricciones.

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. Los 

beans Java sirven para llamar de forma directa a métodos Java. Si desea obtener 

más información sobre las llamadas a métodos Java, consulte la publicación 

Programación con VisualAge para RPG, SC10-3067-02 (SC09-2449-02). 

Para desarrollar aplicaciones que utilicen el componente bean Java, debe tener 

instalado Java 2 Software Development Kit (J2SDK), Standard Edition, versión 1.2 o 

superior, de JavaSoft, en la estación de trabajo. Si no tiene el J2SDK, puede bajarlo 

de Sun Microsystems en el URL siguiente: 

http://www.javasoft.com/products/ 

Tras instalar el J2SDK, establezca la variable de entorno PATH de modo que 

apunte a la ubicación tanto del compilador Java como de jvm.dll, que forma parte 

del J2SDK y del JRE (Java Runtime Environment). Por ejemplo, si el directorio 

inicial 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 


AddEvent Bottom Enabled Height 


RmvEvent ShowProp Top UserData 

Visible Width 


Create Destroy BeanEvent 


Recuadro de lista 

Utilice el componente recuadro de lista para proporcionar al usuario una lista de 

elementos de los que se pueden seleccionar uno o más. Un recuadro de lista consta 

de elementos de sólo lectura. Un elemento de un recuadro de lista es una serie de 

caracteres. 

Las barras de desplazamiento verticales y horizontales permiten al usuario ver 

partes de la lista que no están visualizadas. Puede configurar el recuadro de lista 

de modo que el usuario pueda seleccionar un solo elemento o varios. Puede 

utilizar los atributos Search, SearchType, and Case para buscar fácilmente en la 

lista un elemento determinado. 


AddItemEnd AddLink* AllowLink* BackColor 

BackMix Bottom Case* Count 

DelimChar DeSelect DragEnable* DropEnable* 

Enabled ExtSelect* FirstSel Focus 



GetItem Handle* Height Index 

InsertItem* ItemKey Left MultSelect 

NbrOfSel ParentName PartName PartType 

Refresh RemoveItem RemoveLink* Search* 

SearchType* Selected SelectItem SelectList 

Sequence* SetItem SetTop ShowTips 

SizeToFit TipText Top UseDelim 

UserData Visible Width 




Create Destroy Drop* Enter* 

GotFocus KeyPress LostFocus MouseEnter 

MouseExit MouseMove Popup Select 

VKeyPress 



restricciones.

Medios 

Utilice el componente medios para reproducir o grabar información de audio o 

para reproducir archivos de vídeo. 

El componente medios ofrece a los programas la posibilidad de procesar archivos 

de ondas (.WAV), MIDI (.MID) y QuickTime Movie (.MOV). Si desea utilizar estos 

archivos de audio, el PC debe estar equipado con una tarjeta de sonido que pueda 

procesar estos archivos. Para grabar un archivo de sonido, necesitará un micrófono 

o algún otro dispositivo de entrada soportado por la tarjeta de sonido. Los 

archivos 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 en 

el 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 en 

Windows NT/95/98. Para reproducir estos archivos de vídeo, el sistema debe tener 

los controladores adecuados. 


AddLink* AllowLink* AudioMode Bass* 

Bottom FileName Handle* InPlace 

Left Length Panel ParentName 

PartName PartType Position RemoveLink* 

Top Treble* UserData Visible 

Volumen 




Complete Create Destroy Link* 




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 las 

acciones más utilizadas. 

También puede utilizarlo para dar al usuario control sobre otros componentes sin 

necesidad de crear lógica de programa. Por ejemplo, puede utilizarlo para crear 

pulsadores o controles de graduador que controlen el volumen o la modalidad de 

un componente medios. 

En el cuaderno de propiedades del componente panel de medios, puede indicar lo 

siguiente: 

v Qué botones, de un grupo definido, contendrá el panel de medios 

v 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 de 

cuaderno con lienzo o en una ventana con lienzo. 


AddLink AllowLink BackColor BackMix 

Bottom Enabled Handle Height 

Left PanelItem PanelMode ParentName 

PartName PartType Position RemoveLink 

Top UserData Visible Volume 

Width 


Change Create Destroy Link 


Press 


Barra de menús 

Utilice el componente barra de menús para proporcionar a los usuarios acceso a 

los menús desplegables. Puede añadir componentes submenú y opción de menú a 

la barra de menús. 

Las barras de menús aparecen en la parte superior del marco de la ventana, debajo 

de la barra de título. Cuando el usuario selecciona un menú en ella, aparece un 

menú desplegable con todas sus opciones. Al seleccionar una de ellas se inicia 

inmediatamente la acción que describe. 

Nota: Las propiedades, los eventos, etcétera de este componente sólo se pueden 

manipular desde su menú emergente de la vista de árbol de proyectos. 


v “Elemento de menú” en la página 28 

v “Submenú” en la página 46 

v “Menú emergente” en la página 37 


PartType PartName ParentName UserData 




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 usuario 

selecciona 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ú. 




v “Barra de menús” en la página 27 

v “Menú emergente” en la página 37 



Checked Enabled FileName Label 

ParentName PartName PartType UserData 


Create Destroy MenuSelect 


Subarchivo de mensajes 

Utilice el componente subarchivo de mensajes para visualizar mensajes 

predefinidos o para visualizar texto proporcionado en la lógica del programa: por 

ejemplo, información de error o de estado. 

Este componente está situado siempre en la parte inferior de la ventana y ocupa la 

anchura de la ventana. No se puede cambiar la anchura de este componente; sin 

embargo, sí se puede cambiar la altura para que se visualicen más mensajes. En 

tiempo de ejecución, los usuarios pueden utilizar las barras de desplazamiento 

para ver todos los mensajes. 


AddMsgID AddMsgText Count DragEnable* 

DropEnable* Enabled FirstSel FontBold 


FontUnder* ForeColor ForeMix GetItem 

Handle* Height Index MsgSubText 

NbrOfSel ParentName PartName PartType 

RemoveMsg Selected ShowTips TipText 

UserData Visible 




Create Destroy Drop Enter 


Select 


Edición de múltiples líneas 

Utilice el componente edición de múltiples líneas si desea que el usuario pueda 

escribir varias líneas de texto. 

El componente edición de múltiples líneas tiene límites definidos. A veces no se 

visualiza todo el texto que contiene. El usuario puede desplazar el texto vertical y 

horizontalmente para ver la parte que no se visualiza. 


AddLineEnd AddOffset BackColor BackMix 

Bottom CanUndo CharOffset Copy 

CsrLine CsrPos Cut Delete 

DragEnable* DropEnable* Enabled Focus 



Handle* Height InsertLine InsertText 

Left LineNumber LineText NbrOfLines 

ParentName PartName PartType Paste 

ReadOnly Refresh ShowTips Text 

TextEnd TextLength TextSelect TextStart 

TextString TipText Top TopLine 

Undo UserData Visible Width 

WordWrap 

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


Change Click Create DblClick 

Destroy Drop GotFocus KeyPress 

LostFocus MouseDown MouseEnter MouseExit 

MouseMove MouseUp Popup VKeyPress 


Cuaderno 

Utilice el componente cuaderno para presentar datos que se pueden agrupar 

lógicamente por temas: por ejemplo, información de cliente dividida en categorías 

tales 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). Puede 

añadir páginas al cuaderno y agruparlas en secciones separadas por hojas 

separadoras con pestañas. Si la página de cuaderno tiene lienzo, puede añadir más 

de un componente a la misma. Si no tiene lienzo, sólo se puede añadir un 

componente. 

El usuario puede pasar las páginas de un cuaderno para ir de una página a otra o 

ir directamente a una sección del cuaderno pulsando el botón del ratón sobre la 

pestaña. 

Puede añadir páginas de cuaderno del modo siguiente: 

v Utilizando el cuaderno de propiedades del componente cuaderno 

v 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. 



v “Página de cuaderno con lienzo” en la página 33 


BackColor BackMix Bottom Count 

Enabled Focus FontBold FontItalic 



Left PageNumber ParentName PartName 

PartType Refresh ShowTabs* Top 







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 del 

mismo se adaptará a la página. Si desea añadir más de un componente en una 

página, debe colocar un componente lienzo en la página de cuaderno. También 

puede utilizar el componente página de cuaderno con lienzo para ahorrarse un 

paso. 



El usuario puede pulsar las teclas de flecha izquierda y derecha para ir de una 

página a otra. 

Para obtener información relacionada, consulte los apartados 

v “Cuaderno” en la página 31 

v “Página de cuaderno con lienzo” en la página 33 


Enabled ParentName PartName PartType 

Refresh TabImage TabLabel UserData 

Visible 


Create Destroy PageSelect 


Página de cuaderno con lienzo 

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

cuaderno. 

El componente lienzo ocupa el área de cliente de un componente página de 

cuaderno. Si se añaden componentes al lienzo se puede crear una interfaz gráfica 

de usuario. 

Si sólo desea añadir un componente a la página, puede utilizar el componente 

pá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 se 

añada se ajustará automáticamente. 



v “Cuaderno” en la página 31 


Enabled ParentName PartName PartType 

TabImage TabLabel UserData Visible 


Create Destroy PageSelect 


Interfaz ODBC/JDBC 

El componente Interfaz ODBC/JDBC proporciona la posibilidad de procesar 

archivos de base de datos que den soporte a la API ODBC de Windows o la API 

JDBC de JavaSoft. Foxpro, Access y Paradox son ejemplos de estos tipos de 

archivos de base de datos. 

Para desarrollar aplicaciones que puedan utilizar el componente Interfaz 

ODBC/JDBC, debe estar familiarizado con SQL y tener instalado el SDK ODBC de 

Windows o el Java 2 Software Development Kit (J2SDK), Standard Edition, de 

JavaSoft 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 Sun 

Microsystems en el URL siguiente: 

http://www.javasoft.com/products/ 

Las aplicaciones que acceden y manipulan datos de una base de datos JDBC 

necesitan el controlador de conformidad con JDBC 2.0 adecuado. Puede encontrar 

el 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 se 

almacenan en una tabla como una serie de filas. Cada fila, o registro, contiene un 

número de columnas con datos. El programa puede someter sentencias SQL junto 

con los atributos del componente Interfaz ODBC/JDBC para manipular filas, o 

para traspasar datos entre campos del programa y columnas de tablas. 

Para poder procesar una base de datos existente, el programa VARPG debe 

conectarse antes a la base de datos e indicar a qué tabla hace referencia. Para 

manipular las filas de una tabla, el programa debe crear un conjunto de registros 

que identifique los registros que el componente interfaz ODBC/JDBC debe 

devolver y mantener. Para acceder a los datos de una fila, debe enlazar cada una 

de las columnas utilizadas en la fila de la tabla con un campo del programa. En las 

aplicaciones Java no se pueden utilizar los punteros. Una columna está enlazada a 

un componente; para enlazar sólo se pueden utilizar los componentes texto estático 

y campo de entrada. 

Si crea una aplicación Java que utiliza el componente Interfaz ODBC/JDBC, los 

usuarios finales que ejecuten la aplicación deben instalar el archivo varpgjdb.jar en 

sus estaciones de trabajo y añadir su ubicación en la sentencia classpath. El 

programa de utilidad de empaquetamiento no incluye este archivo JAR. El archivo 

JAR está ubicado en el subdirectorio adtswin\java. 



AllowChg* BindPart Bottom BufferDec* 

BufferLen* BufferPtr* BufferType* CharData 

Column ColumnDec ColumnLen ColumnName 

Columns ColumnType Connect Connected 

ConnectStr CurrentRow DeleteRow ExecuteSQL 

Fetch FetchNext FetchPrior GetTables 

Handle* Height InsertRow IsData 


Refresh Rows* SQLError SQLMsgBox 

SQLQuery Top UnBind UpdateRow 







Recuadro de contorno 

Utilice un recuadro de contorno alrededor de un grupo de componentes para 

indicar que están relacionados. 

Un recuadro de contorno no tiene etiqueta. Si en el recuadro debe aparecer una 

etiqueta, 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. 


Bottom Handle* Height Left 

ParentName PartName PartType Refresh 


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





Menú emergente 

Utilice el componente menú emergente para visualizar las opciones que pertenecen 

a un componente determinado de la interfaz. Puede añadir opciones de menú y 

submenús a los menús emergentes. 

Este menú se llama “emergente” porque aparece cuando el usuario pulsa la tecla o 

el botón del ratón adecuados. 




v “Barra de menús” en la página 27 

v “Elemento de menú” en la página 28 



Handle* InvName InvPName ParentName 

PartName PartType UserData Visible* 

X Y 




No hay eventos para este componente. 


Barra de progreso 

Utilice el componente barra de progreso para indicar de forma gráfica el progreso 

de 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 el 

atributo PBRange en 100 y el atributo PBStepSize en 10. El código podría 

supervisar el proceso de copiar archivos y el indicador de barra de progreso 

avanzarí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. 


Bottom Handle* Height Left 

ParentName PartName PartType PBRange 

PBSetPos PBStep PBStepSize Top 







Pulsador 

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

utilizadas. 

Cada componente pulsador controla una acción determinada. Cuando el usuario lo 

pulsa, la acción se inicia inmediatamente. La etiqueta de texto del pulsador 

describe la acción que éste realiza. 

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


BackColor BackMix Border* Bottom 




HelpEnable HighLight Label Left 


ShowTips TipText Top UserData 

Validate Visible Width 




Create Destroy GotFocus LostFocus 


Press 


Botón de selección 

Utilice botones de selección si desea que el usuario seleccione sólo una opción de 

un grupo de opciones relacionadas pero que se excluyen mutuamente. Cuando el 

usuario efectúa una selección, la opción seleccionada anteriormente en el grupo se 

deselecciona. 

Un botón de selección tiene forma circular con los bordes en relieve yasulado 

hay texto. Cuando está seleccionado, contiene un punto. 

No utilice botones de selección si desea que el usuario pueda seleccionar más de 

una opción al mismo tiempo. En este caso, consulte el apartado “Recuadro de 

selección” en la página 7. 


BackColor BackMix Bottom Checked 




HighLight* Label Left ParentName 

PartName PartType Refresh SelectIdx 


Visible Width 




Create Destroy Enter MouseEnter 

MouseExit MouseMove Popup Select 


Graduador 

Utilice el componente graduador si desea que el usuario visualice, establezca o 

modifique un valor moviendo el eje del graduador. 

Los graduadores suelen utilizarse para valores con incrementos habituales, como 

los segundos o los grados, o con el fin de mostrar qué porcentaje se ha realizado 

de una tarea. 

Por omisión, el graduador se sitúa horizontalmente en el centro de un recuadro 

con su eje en el lado izquierdo. Se puede visualizar una escala para mostrar las 

unidades 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. 



Bottom Enabled Focus FontBold 



Height Left Maximum Minimum 


RemoveLink* ShowTips TickLabel TickNumber 

TipText Top UserData Value 

Visible Width 




Change Create Destroy GotFocus 

Link* LostFocus MouseEnter MouseExit 

MouseMove Popup 




Selector cíclico 

Utilice el componente selector cíclico para visualizar, de forma secuencial, un 

grupo de opciones relacionadas, pero que se excluyen mutuamente, que tienen un 

orden consecutivo lógico; por ejemplo, los meses del año. Las opciones se 

visualizan como si estuvieran organizadas en forma de anillo. El usuario puede 

mover (o “girar”) las opciones pulsando la flecha arriba para ir al valor superior 

siguiente o la flecha abajo para ir al valor inferior siguiente. También puede 

escribir una opción directamente en el campo de entrada del selector cíclico. 


AddItemEnd Alignment* BackColor BackMix 

Bottom Enabled Focus FontBold 



Height Left Maximum Minimum 

ParentName PartName PartType ReadOnly 

Refresh RemoveItem ShowTips Text 

TipText Top UserData Value 

Visible Width 




Change Create Destroy GotFocus 

Link* LostFocus MouseEnter MouseExit 

MouseMove Popup SpinDown SpinEnd 

SpinUp 



restricciones.

Texto estático 

Utilice el componente texto estático como etiqueta de otros componentes, por 

ejemplo, como mensaje de solicitud de un componente campo de entrada. Los 

componentes 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. 


Alignment BackColor BackMix Bottom 

DataType DragEnable* DropEnable* Enabled 



Handle* Height Label Left 



Visible Width 





Drop Link* MouseDown MouseEnter 

MouseExit MouseMove MouseUp Popup 




Barra de estado 

Utilice el componente barra de estado para proporcionar información adicional 

sobre un proceso o una acción de la ventana. Puede crear hasta cinco paneles para 

la barra de estado. El componente barra de estado proporciona al componente 

ventana mayor flexibilidad que el atributo StatusBar. 

Por omisión, la barra de estado se crea en la parte inferior de la ventana. No 

obstante, puede utilizar el cuaderno de propiedades para colocarla en la parte 

superior. También puede establecer el estilo del borde, el número de paneles y la 

alineación del texto. 


Handle* ParentName PartName PartType 

SBIndex SBLabel SBPanes UserData 

Visible 






Subarchivo 

Utilice el componente subarchivo para visualizar una lista de registros, cada uno 

de los cuales consta de uno o más campos. 

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

AS/400 ® 

. El usuario puede desplazar el contenido de la lista en sentido horizontal 

o vertical utilizando las barras de desplazamiento del subarchivo. 

Para crear un campo de entrada de subarchivo, añada un campo de la ventana 

Definir campos de referencia o de la paleta de componentes en el componente 

subarchivo. 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 cuaderno 

con lienzo o en una ventana con lienzo. 


AddItemEnd AllowEdit AutoSelect BackColor 

BackMix Bottom ButtonIdx Buttons 

ButtonTip CapsLock CellBGClr CellBGMix 

CellFGClr CellFGMix ColBGClr ColBGMix 

ColFGClr ColFGMix ColNumber ColWidth 

Count DeSelect EnableBtn Enabled 

ExtSelect* FirstSel Focus FontArea 



Handle* HdgBGClr HdgBGMix HdgFGClr 

HdgFGMix HdgIdx HdgText Height 

Hidden HRule Index ItemCount 

Left MultSelect NbrOfSel OpenEdit 


RemoveItem RowBGClr RowBGMix RowFGClr 

RowFGMix Scale Selected SelectItem 

SelectList SetTop SflNxtChg ShowTips 

SizeToFit StartAt TipText Top 

TopRecord UserData Visible VRule 

Width 




Change ColSelect Create Destroy 

Enter FirstRec GotFocus KeyPress 

LastRec LostFocus MouseEnter MouseExit 

MouseMove NextRec PageDown PageEnd 

PageTop PageUp Popup PrevRec 

Select VKeyPress 


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 componentes 

opción de menú, pero solamente en la vista de árbol. 



Para obtener información relacionada, consulte el apartado “Elemento de menú” en 

la página 28. 


ParentName PartName PartType UserData 




Temporizador 

Utilice el componente temporizador si el programa debe realizar determinadas 

operaciones en intervalos de tiempo preestablecidos. Por ejemplo, puede utilizarlo 

para cerrar una ventana o para finalizar una aplicación después de un periodo 

determinado de inactividad. 

El componente temporizador cuenta unidades de tiempo e inspecciona el intervalo 

de tiempo preestablecido entre dos eventos, desencadenando el segundo evento 

cuando ha pasado el tiempo necesario. 

Cuando se crea un componente temporizador en el constructor GUI, el 

componente aparece en forma de icono en la ventana de diseño. Sin embargo, en el 

cuaderno de propiedades de un componente temporizador, puede especificar que 

no desea que el icono se visualice mientras el programa se ejecuta. 

Nota: No utilice el componente temporizador cuando precise un control exacto del 

tiempo. El evento Tick puede no producirse en el intervalo exacto que ha 

especificado, a causa de otros programas que estén ejecutándose en el 

sistema. 


AddLink* AllowLink* Bottom Interval 

Left Multiplier ParentName PartName 

PartType RemoveLink* TimerMode TimerTicks 

Top UserData Visible 




Create Destroy Link* Tick 




Barra de desplazamiento vertical 

Utilice el componente barra de desplazamiento vertical para poder desplazarse por 

un panel de información de arriba abajo. La información puede ser una lista de 

archivos, 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 los 

objetos por los que se efectuará el desplazamiento y el atributo PageSize para 

determinar el número de objetos que pueden visualizarse en una página. 


Bottom Enabled Focus Handle* 

Height Left NextLine NextPage 


Position PrevLine PrevPage Range 





Create Destroy Scroll 


| 

Ventana 

Las ventanas son el medio primordial que tiene el usuario de interactuar con el 

programa. Las aplicaciones deben contener al menos una ventana. 

Sólo puede añadir un componente al área de cliente de una ventana, con la 

excepción de los componentes que son extensiones del marco de la ventana, como 

las barras de menús, los menús emergentes y los subarchivos de mensajes. El 

tamañ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 un 

componente lienzo. Puede utilizar el componente ventana con lienzo para 

ahorrarse un paso. 

Nota: El componente ventana se encuentra en el apartado Marcos del catálogo de 

componentes, no en la paleta de componentes. 


v “Lienzo” en la página 5 

v “Ventana con lienzo” en la página 50 


Bottom Center Enabled FileName* 

Focus* FontBold* FontItalic* FontName* 

FontSize* FontStrike* FontUnder* Handle* 

Height IconHandle* Label Left 

MouseIcon* MouseShape* ParentName PartName 

PartType PBRange PBSetPos PBStep 

PBStepSize Print ProgresBar Refresh 

SBLabel SBPosition SBStyle ShowTips 

StatusBar Top UserData Visible 

Width WindowMode* 




Activate Close Create DeActivate 

Destroy LClickTray Moved RClickTray 

ReSize ShutDown 


| 

Ventana con lienzo 

Las ventanas son el medio primordial que tiene el usuario final para interactuar 

con el programa. El lienzo, en un componente ventana con lienzo, le permite 

añadir varios componentes a la ventana. 

Puede colocar diversos componentes en el lienzo señalándolos y pulsando el botón 

del 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, no 

necesita el componente ventana con lienzo: en lugar de éste, debe usar el 

componente ventana (que se encuentra en la sección Marcos del catálogo de 

componentes). Sin lienzo, el tamaño del componente añadido se ajusta 

automáticamente al área de cliente. 


v “Lienzo” en la página 5 

v “Ventana” en la página 49 


Bottom Center Enabled FileName* 

Focus* FontBold* FontItalic* FontName* 

FontSize* FontStrike* FontUnder* Handle* 

Height IconHandle* Label Left 

MouseIcon* MouseShape* ParentName PartName 

PartType PBRange PBSetPos PBStep 

PBStepSize Print ProgresBar Refresh 

SBLabel SBPosition SBStyle ShowTips 

StatusBar Top UserData Visible 

Width WindowMode* 




Activate Close Create DeActivate 

Destroy LClickTray Moved RClickTray 

ReSize ShutDown 


Capítulo 2. Atributos de componente 

Al crear la interfaz gráfica de usuario (GUI) mediante VisualAge RPG, puede 

establecer o cambiar la mayor parte de los atributos de un componente abriendo el 

cuaderno de propiedades de ese componente. 

También puede establecer los atributos de la mayoría de los componentes en 

tiempo de ejecución en el programa de aplicación VisualAge RPG mediante las 

funciones incorporadas o los códigos de operación. Para ello, codifique la función 

incorporada %setatr en el código de operación EVAL de formato libre, o utilice el 

código de operación SETATR. Para recuperar los valores de los atributos de 

componente, codifique la función incorporada %getatr en el código de operación 

EVAL de formato libre o utilice el código de operación GETATR. 

Este apartado describe los atributos de componente. Cada una de las descripciones 

contiene 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 tabla 

también indica si se puede establecer un atributo utilizando el cuaderno de 

propiedades 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 de 

consulta 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 en 

minúsculas. 

v Cualquier restricción aplicable. 


Activate 

Establezca este atributo en 1 para activar un objeto ActiveX. 

Tipo Numérico 

Se aplica a los componentes 

ActiveX 

Códigos de operación 

SETATR 

Operativo en tiempo de ejecución 

sí 

GETATR no 

Ejemplo de formato libre 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 

CSRN01Factor1+++++++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....+....8 


* 

C 'AX1' SETATR 1 'ACTIVATE' 

* 


Active 

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

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



*Component 


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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL Act=%getatr('*Component':'*Component':'Active') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*COMPONENT' GETATR 'Active' Act 

* 

Capítulo 2. Atributos de componente 53

AddEvent 

Añade el nombre de evento a la lista de filtro de eventos. Puede utilizar el valor 

especial *ALL para que el componente ActiveX o bean Java direccione al programa 

VARPG todos los eventos disponibles almacenados en la lista. Por omisión, el 

componente ActiveX o bean Java no direcciona ningún evento. 

Para crear una nueva lista de eventos parcial después de haber emitido 

AddEvent(*ALL), primero debe vaciar la lista con el atributo RmvEvent. 

Tipo Serie 


ActiveX Bean Java 


SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'AX1':'AddEvent')='EVT2' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'AX1' SETATR 'EVT2' 'ADDEVENT' 

* 


AddItemEnd 

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

En un componente subarchivo, este atributo se aplica a un campo de entrada de 

subarchivo que tenga valores definidos como tipo de validación. Utilice este 

atributo para añadir valores a la lista de validación del campo de entrada del 

subarchivo. Primero ha de establecer el atributo ColNumber a fin de identificar la 

columna con la que se debe trabajar. 

Tipo Serie 


Recuadro de 

combinación 


Recuadro de lista Selector cíclico Subarchivo 

SETATR 


sí 

GETATR no 


El elemento que se añadirá a la lista o el valor de validación del campo de 

entrada del subarchivo 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'LB1':'AddItemEnd')=newitem 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'LB1' SETATR 'NEWITEM' 'ADDITEMEND' 

* 


AddLineEnd 

Añade una nueva línea después de la última línea de un campo de edición de 

múltiples líneas. 

Tipo Serie 

Se aplica a 

Edición de múltiples 

líneas 


SETATR 


sí 

GETATR no 


La nueva línea de texto 


Obtener el valor de texto de un campo de entrada y añadirlo al final de un 

campo de edición de múltiples líneas 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'MLE1':'AddLineEnd')=newtext 

* 


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....+....8 


* 

C 'MLE1' SETATR 'NEWTEXT' 'ADDLINEEND' 

* 


AddLink 


Enlaza un componente destino con su componente origen. Si el atributo 

AllowLink también está establecido, el componente destino genera un evento Link 

cuando este componente se modifica. 

Para obtener una lista de tipos de componentes que se pueden enlazar, consulte la 

Tabla 1. 

Tabla 1. Componentes origen y destino permitidos 

Cuando Componente 

origen 

Cambio de modalidad o 

posición 

Se selecciona Recuadro de 

selección 

Valor modificado Campo de 

entrada 

Respuesta del componente de destino 

enlazado 

Medios El Panel de medios responde al cambio de 

modalidad del componente Medios. 

El componente Temporizador se habilita o se 

inhabilita. 

Medios: se establece el nombre de archivo. 

Campo de entrada: se actualiza el valor de 

texto. 

Imagen: se establece el nombre de archivo. 

Graduador: se actualiza el valor numérico. 

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

Cambios nombre archivo Imagen 

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


Se selecciona Recuadro de 

lista 

Medios: se establece el nombre de archivo. 

Campo de entrada: se actualiza el valor de 

texto. 

Cambio de control Panel de 

medios 

Imagen: se establece el nombre de archivo. 


El componente Medios responde al cambio de 

modalidad del componente Panel de medios. 

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

texto. 

Graduador: se actualiza el valor numérico. 

Tick Temporizador 



El contador del temporizador se pone a cero. 


Tipo Serie 


Recuadro de selección Campo de entrada Imagen Recuadro de lista 

Medios Panel de medios Graduador Temporizador 


SETATR* 


sí 

GETATR no 

* Nota: Puede definirse utilizando el cuaderno de propiedades del 

diseñador GUI. Para ello, utilice la página Enlace y rellene los 

campos Nombre de componente de destino y Nombre de 

componente padre de destino. 


Nombre 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 y 

componente es el nombre del componente. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'CB1':'AddLink')='WIN1|TIMER1' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CB1' SETATR 'WIN1|TIMER1' 'ADDLINK' 

* 


AddMsgID 

Añade un mensaje al componente subarchivo de mensajes. 

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

subarchivo de mensajes. 



Subarchivo de 

mensajes 


SETATR 


sí 

GETATR no 


El identificador de mensaje (msgid), que es un número de cuatro dígitos de 

longitud como máximo. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'MSG1': 'AddMsgID') = 1234 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MSG1' SETATR 1234 'ADDMSGID' 

* 


AddMsgText 

Añade un mensaje al componente subarchivo de mensajes. El mensaje se añade en 

forma de serie. 

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

subarchivo de mensajes. 

Tipo Serie 


Subarchivo de 

mensajes 


SETATR 


sí 

GETATR no 


Serie de texto del mensaje 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'MSG1':'AddMsgText')='Help!' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MSG1' SETATR 'Help!' 'ADDMSGTEXT' 

* 


AddOffset 

Inserta el texto especificado en el campo de edición de múltiples líneas en el 

desplazamiento de caracteres especificado mediante el atributo CharOffset. 

Tipo Serie 



líneas 


SETATR 


sí 

GETATR no 


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


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'MLE1': 'CharOffset') = 10 

C EVAL %setatr('win01': 'MLE1': 'AddOffset') = 'XXX' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' SETATR 10 'CHAROFFSET' 

C 

* 

'MLE1' SETATR 'XXX' 'ADDOFFSET' 


AddRcd 

Añade un registro nuevo a un contenedor 

Tipo Serie 


Contenedor 


SETATR 


sí 

GETATR no 


El valor que se transfiere a este atributo debe ser una serie que conste de 

los parámetros siguientes, cada uno separado por un espacio: 

Estructura de registro 

ID Valor numérico utilizado para identificar el registro. Declare este 

valor de modo que pueda contener la cantidad máxima de 

registros que espera que contenga el contenedor. 

Nota: Puede utilizar el atributo GetNewID para que VisualAge 

RPG genere un identificador exclusivo para usted. 

Text Texto que aparecerá junto al icono del registro cuando el 

contenedor esté en la vista de iconos o en la vista de árbol. 

FileName 

Nombre de archivo del icono. 

ParentID 

Identificador del registro padre de este registro. Si el registro no 

tiene padre, este parámetro tendrá el valor 0. 

field_data 

Este valor es opcional. Si se especifica, los datos se situarán en los 

campos correspondientes del registro. Es necesario proporcionar 

datos para todos los campos del registro. El número de campos de 

cada registro del componente contenedor en el diseñador GUI ya 

está definido; por tanto, sólo debe especificar ese número. 

Nota: Si los datos de un campo no están disponibles, utilice el 

carácter de subrayado (_)como reserva de posición para el 

campo. Si un campo contiene blancos intercalados, deben 

sustituirse por el carácter de subrayado antes de añadir el 

registro. Los blancos intercalados aparecerán en los datos del 

campo del registro añadido. 

Los datos de los campos se pueden actualizar después de añadir el 

registro utilizando el atributo SetRcdFld. 



*...1....+....2....+....3....+....4....+....5....+....6....+....7....+. 

DName+++++++++++ETDsFrom+++To/L+++IDc.Keywords+++++++++++++++++++++++++ 

D NewRecord 

D RecordID 1 6 

D FileName 8 64 

D Parent 1 6 INZ(0) 

D Text 8 20 INZ('Next record') 

* 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C Eval RecordID=%getatr('win01': 'CN1': 'GetNewID') 

C Eval FileName = 'D:\VRPG\NEW.ICO' 

C Eval %setatr('win01': 'CN1': 'AddRcd') = NewRecord 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' SETATR NewRecord 'ADDRCD' 

* 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

AddSrcEvt 

Añade un nuevo evento de origen a la lista actual de eventos que supervisa el 

componente de referencia a componente lógico. Este atributo permite que un 

componente de referencia a componente lógico supervise varios eventos. Para 

eliminar eventos de origen de la lista, utilice el atributo RmvSrcEvt. 

Para identificar el evento de origen que se añade, especifique juntos los nombres 

del componente lógico, la ventana, el componente y el evento. El formato de la 

serie 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 


Referencia a 

componente lógico 


SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+. 


D Event 

* 

S 100 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL Event='compb|win02|ef02|change' 

C EVAL %setatr('win01': 'CRP1': 

C 

* 

'AddSrcEvt')=Event 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+. 


D Event 

* 

S 100 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 


C 

* 

'CRP1' SETATR Event 'ADDSRCEVT' 


Alarm 

Hace que el altavoz emita un pitido. 



*Componente lógico 


SETATR 


sí 

GETATR no 


El valor de este atributo debe establecerse en 1. 


Hacer que se oiga un pitido: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('*Component':'*Component':'Alarm')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*COMPONENT' SETATR 1 'ALARM' 

* 


Alignment 

Este atributo determina cómo se alinean el texto y las etiquetas en los 

componentes. 



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

* Restricciones:: Una vez establecido este atributo, no puede cambiarse en 

tiempo de ejecución. 


SETATR* 


sí 

GETATR sí 

*Nota: Puede definirse utilizando el cuaderno de propiedades en el 

diseñador GUI. 


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 



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....+....8 


* 

C 

* 

EVAL align = %getatr('win01': 'ST1': 'Alignment') 

C align IFEQ 1 

C 

* 

EVAL %setatr('win01': 'ST1': 'Alignment') = 2 

C ELSE 

C EVAL %setatr('win01': 'ST1': 'Alignment') = 1 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ST1' GETATR 'ALIGNMENT' ALIGN 1 0 

C ALIGN IFEQ 1 

C 

* 

'ST1' SETATR 2 'ALIGNMENT' 

C ELSE 

C 

* 

* 

'ST1' SETATR 1 'ALIGNMENT' 

C 

* 

ENDIF 


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. En 

esta columna de datos no se realizan actualizaciones. 

Al ejecutar una acción FetchNext, FetchPrior, InsertRow o UpdateRow, los datos 

se traspasan del almacenamiento intermedio del campo de programa a la columna 

de tabla correspondiente, o viceversa. Si la columna tiene un tipo de datos VARPG 

no soportado, debe establecer el atributo AllowChg en 0. El valor por omisión es 

1. (Consulte el apartado “BufferType” en la página 93 para obtener una lista de los 

tipos de datos soportados). 

Establezca el atributo Column en la columna deseada antes de establecer el valor 

AllowChg. 





SETATR 


sí 

GETATR sí 


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. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'ODBC1': 'AllowChg') = 0 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' SETATR 0 'AllowChg' 

* 


AllowEdit 

Determina si se pueden editar los campos de entrada de subarchivo. El estado de 

edición se puede especificar para el subarchivo, el registro, la columna o la casilla. 



Subarchivo 


SETATR 


sí 

GETATR no 


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 e 

Index. 

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 e 

Index. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'SFL1': 'Index') = 5 

C 

* 

EVAL %setatr('win01': 'SFL1': 'AllowEdit') = 12 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SFL1' SETATR 5 'INDEX' 

C 

* 

'SFL1' SETATR 12 'ALLOWEDIT' 


AllowLink 


Este atributo determina si el componente destino especificado por el atributo 

AddLink o DDEAddLink generará un evento Link cuando el componente origen 

se modifique. 






SETATR* 


sí 

GETATR sí 


diseñador GUI. Para ello, utilice la página Enlace y seleccione 

Habilitar notificación al destino. 


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 



*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL allow = %getatr('win01': 'EF1': 'AllowLink') 

* 

C allow IFEQ 1 

C EVAL %setatr('win01': 'EF1': 'AllowLink') = 0 

* 

C ELSE 

C EVAL %setatr('win01': 'EF1': 'AllowLink') = 1 

C ENDIF 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'EF01' GETATR 'ALLOWLINK' ALLOW 1 0 

C ALLOW IFEQ 1 

C 

* 

'EF01' SETATR 0 'ALLOWLINK' 

C ELSE 

C 

* 

'EF01' SETATR 1 'ALLOWLINK' 

C 

* 

ENDIF 


AppData 

Contiene datos globales a los que cualquier componente puede hacer referencia. 

Este atributo proporciona una alternativa a la transferencia de parámetros que, en 

caso contrario, deben declararse. 

Tipo Serie 




SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('*Component': '*Component': 'AppData') 

C = NData 

C EVAL TmpFld=%getatr('*Component':'*Component': 

C 

* 

'AppData') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*COMPONENT' SETATR NData 'APPDATA' 

C 

* 

'*COMPONENT' GETATR 'APPDATA' TmpFld 


AppName 


Es el nombre de la aplicación del servidor a la que se conectará el componente 

Cliente DDE en una conversación DDE. La aplicación del servidor determina el 

nombre del servidor. Consulte la documentación de la aplicación para averiguar el 

valor de AppName que se utilizará para dicha aplicación. 

El establecimiento de AppName no inicia la conversación DDE. Para obtener 

información acerca del inicio de una conversación DDE, consulte el apartado 

“DDEMode” en la página 167. 

Tipo Serie 


Cliente DDE 


SETATR* 


sí 

GETATR sí 




Nombre de la aplicación del servidor 

Si el programa del servidor es una aplicación VisualAge RPG, este atributo 

será el nombre de la aplicación, incluida la extensión. Por ejemplo, si la 

aplicación VisualAge RPG se llama server, el atributo AppName debe 

definirlo como se indica a continuación: 

EVAL %setatr('WIN':'DDE1':'AppName') = 'SERVER.EXE' 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'DDE1': 'AppName') = 'APP01' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'DDE1' SETATR 'APP01' 'APPNAME' 

* 


Arrange 

Ordena los elementos de un contenedor en la vista de iconos de manera que los 

iconos quedan alineados en filas. 



Contenedor 


SETATR 


sí 

GETATR no 


El valor de este atributo debe ser 1. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C Eval %setatr('window': 'CN1': 'Arrange') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' SETATR 1 'ARRANGE' 

* 


AttrValue 

Valor del atributo al que hace referencia el componente referencia a componente. 

En primer lugar, debe establecer el componente referencia a componente a fin de 

identificar el componente, la ventana y el nombre del componente para el atributo. 

Tipo Serie 


Referencia a 



SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'COMP1': 'AttrValue')='Test' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'COMP1' SETATR 'Test' 'ATTRVALUE' 

* 


AudioMode 

Establece la modalidad de operación para el componente. 



Medios 


SETATR 


sí 

GETATR no 


El valor de AudioMode puede ser uno de los siguientes: 

1 Pausa 

2 Reproducir 

3 Grabar 

4 Parar 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'AUDIO01': 'AudioMode') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'AUDIO01' SETATR 1 'AUDIOMODE' 

* 


AutoInc 

Este atributo hace que se incremente el valor actual de DataPoint cada vez que se 

establece el atributo DataValue. 



Gráfica 


SETATR 


sí 

GETATR sí 


El atributo AutoInc devuelve uno de los valores siguientes: 

0 DataPoint no se incrementa automáticamente 

1 DataPoint se incrementa automáticamente. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL auto = %getatr('win01': 'GP1': 'AutoInc') 

C auto IFEQ 1 

C 

* 

EVAL %setatr('win01': 'GP1': 'AutoInc') = 0 

C ELSE 

C EVAL %setatr('win01': 'GP1': 'AutoInc') = 1 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'GP01' GETATR 'AUTOINC' Auto 1 0 

C AUTO IFEQ 1 

C 

* 

'GP01' SETATR 0 'AUTOINC' 

C ELSE 

C 

* 

'GP01' SETATR 1 'AUTOINC' 

C 

* 

ENDIF 


| 

| 

| 

| 

| 

AutoScroll 


Permite que un usuario pueda desplazar datos en un campo de entrada cuando se 

puede escribir más texto o cuando hay más información disponible de la que se 

puede visualizar en el campo de entrada. 



Recuadro de 

combinación 



SETATR 


sí 

GETATR sí 


El valor de AutoScroll puede ser uno de los siguientes: 

0 Desplazamiento automático no permitido 

1 Desplazamiento automático permitido 



Conmutar el atributo AutoScroll de un campo de entrada. 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL rc = %getatr('win01': 'EF1': 'AutoScroll') 

* 

C rc IFEQ 1 

C EVAL %setatr('win01': 'EF1': 'AutoScroll') = 0 

* 

C ELSE 

C EVAL %setatr('win01': 'EF1': 'AutoScroll') = 1 

C ENDIF 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'EF1' GETATR 'AUTOSCROLL' rc 1 0 

C rc IFEQ 1 

C 

* 

'EF1' SETATR 0 'AUTOSCROLL' 

C ELSE 

C 'EF1' SETATR 1 'AUTOSCROLL' 

C 

* 

ENDIF 


AutoSelect 

Indica si se resalta el texto que figura en el campo de entrada cuando éste recibe el 

foco. En el caso de un componente subarchivo, establezca primero el atributo 

ColNumber para identificar la columna con la que se debe trabajar. 



Campo de entrada Subarchivo 


SETATR* 


sí 

GETATR sí 




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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL highlight=%getatr('win01':'EF1':'AutoSelect') 

C highlight IFEQ 0 

C EVAL %setatr('win01':'EF1':'AutoSelect')=1 

C ELSE 

C EVAL %setatr('win01':'EF1':'AutoSelect')=0 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'EF1' GETATR 'AUTOSELECT' highlight 1 0 

C 

* 

'EF1' SETATR 1 'AUTOSELECT' 


BackColor 

Valor 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 el 

valor de mezcla de colores de fondo. 



Lienzo Recuadro de selección Recuadro de 

combinación 

Contenedor 

Campo de entrada Imagen Recuadro de lista Panel de medios 


líneas 

Cuaderno Pulsador Botón de selección 

Graduador Selector cíclico Texto estático Subarchivo 


SETATR* 


sí 

GETATR sí 




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 


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. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL color = %getatr('win01': 'EF1': 'BackColor') 

C color IFEQ *Red 

C EVAL %setatr('win01': 'EF1': 'BackColor') = *Blue 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8 


* 

C 'EF1' SETATR *BLUE 'BACKCOLOR' 

* 


BackMix 

Consulta o establece la mezcla del color de fondo. 

Tipo Serie 



combinación 

Contenedor 

Campo de entrada Imagen Recuadro de lista Panel de medios 


líneas 

Cuaderno Pulsador Botón de selección 



SETATR* 


sí 

GETATR sí 




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 representan 

la intensidad del color respectivo. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL color=%getatr('win01':'EF1':'BackMix') 

C color IFNE '10:23:200' 

C EVAL %setatr('win01':'EF1':'BackMix')='10:23:200' 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8 


* 

C 'EF1' SETATR '10:23:200' 'BACKMIX' 

* 


BarLabel 

Indica cuál es la etiqueta del elemento de datos actual (según lo especificado en 

DataPoint y DataGroup). 

Tipo Serie 


Gráfica 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'GPH1': 'BarLabel') = 'BAR01' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GPH1' SETATR 'BAR01' 'BARLABEL' 

* 


Bass 

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

Establece el nivel de bajos del componente medios. 



Medios 


SETATR 


sí 

GETATR sí 


El valor de Bass puede estar entre 0 y 100. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'AUD1': 'Bass') = 37 

* 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'AUD1' SETATR 37 'BASS' 

* 


| 

| 

| 

| 

| 

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 de 

datos. En el entorno Java, sólo se permite enlazar en los componentes campo de 

entrada y texto estático. 

Tipo Serie 




SETATR 


sí 

GETATR no 


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

siguiente: 

'FRAMEWINDOW|PARTNAME' 

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


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'WIN1': 'BindPart') 

C = 'WIN1|ENT2' 

* 


*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8 


* 

C 'WIN1' SETATR 'WIN1|ENT2' 'BINDPART' 

* 


| 

| 

| 

| 

| 

BlankChar 

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

El componente contenedor utiliza un blanco como delimitador de elementos en un 

registro. Si el elemento que añade contiene blancos como, por ejemplo, el texto del 

icono, 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 


Contenedor 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'CTR1':'BlankChar')='&' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CTR1' SETATR '&' 'BLANKCHAR' 

* 


Border 

Determina si el componente tiene un borde. 



Calendario Imagen Pulsador* 

* Restricción: Este atributo sólo se puede establecer y obtener para el 

componente pulsador en las aplicaciones Java. 


SETATR* 


sí 

GETATR sí 




El valor de Border puede ser uno de los siguientes: 

0 El componente no tiene borde 

1 El componente tiene borde 


Conmutar el atributo Border de un componente: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL brdval = %getatr('win01': 'IMG1': 'Border') 

C brdval IFEQ 0 

C EVAL %setatr('win01': 'IMG1': 'Border') = 1 

* 

C ELSE 

C EVAL %setatr('win01': 'IMG1': 'Border') = 0 

C ENDIF 

* 


Conmutar el valor de borde actual de un pulsador: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'IMG1' GETATR 'BORDER' brdval 1 0 

C brdval IFEQ 1 

C 

* 

'IMG1' SETATR 0 'BORDER' 

C ELSE 

C 'IMG1' SETATR 1 'BORDER' 

C ENDIF 


Bottom 

Especifica 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. 



ActiveX Calendario Lienzo* Recuadro de selección 

Recuadro de 

Referencia a 

Contenedor Cliente DDE 

combinación 


Campo de entrada Gráfica Pulsador gráfico Recuadro de grupo 

Barra de 

desplazamiento 

horizontal 

Imagen Bean Java Recuadro de lista 

Medios Panel de medios Edición de múltiples 

líneas 

Cuaderno 

Interfaz ODBC/JDBC Recuadro de contorno Barra de progreso Pulsador 

Botón de selección Graduador Selector cíclico Texto estático 

Subarchivo Temporizador Barra de 


vertical 

Ventana 

* Restricción: Este atributo sólo se puede obtener en tiempo de ejecución 

para el componente lienzo. 


SETATR 


sí 

GETATR sí 


Número de pixels 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL bot = %getatr('win01': 'Image1': 'Bottom') 

C bot SUB 100 newbot 

C 

* 

EVAL %setatr('win01': 'Image1': 'Bottom') = newbot 


Mover una imagen 200 pixels dentro de su ventana. 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'IMAGE1' GETATR 'BOTTOM' OldBot 4 0 

C OldBot ADD 200 NewBot 4 0 

C 

* 

'IMAGE' SETATR NewBot 'BOTTOM' 


| 

| 

| 

| 

| 

BufferDec 


Especifica el número de posiciones decimales del almacenamiento intermedio de la 

columna. 





SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL 

%setatr('win01':'ODBC1':'BufferDec')=4 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' SETATR 4 'BufferDec' 

* 


BufferLen 


Especifica la longitud del campo de programa disponible para los datos de 

columna. El componente Interfaz ODBC/JDBC necesita conocer la longitud de los 

datos establecida y entrar en el campo de programa al traspasar los datos hacia 

una columna y desde una columna. 

Establezca el atributo Column en la columna deseada antes de utilizar este 

atributo. 





SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'ODBC1':'BufferLen')=20 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' SETATR 20 'BufferLen' 

* 


BufferPtr 


Especifica el valor de puntero para el campo de programa. El componente Interfaz 

ODBC/JDBC utiliza este valor para traspasar datos de la base de datos al campo 

de programa. 

Establezca el atributo Column en la columna deseada antes de utilizar este 

atributo. 

Para obtener la dirección de un campo de programa, utilice la función %ADDR 

incorporada según se muestra a continuación: 

D FieldPtr S * INZ(%Addr(Campo)) 

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





SETATR 


sí 

GETATR sí 

Nota: En el caso de la operación SETATR, el atributo BufferPtr puede 

codificarse solamente con sintaxis de formato fijo. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' SETATR FieldPtr 'BufferPtr' 

* 


BufferType 


Indica el tipo de datos del campo del programa VisualAge RPG al que hace 

referencia el atributo BufferPtr. El componente Interfaz ODBC/JDBC utiliza el 

atributo BufferType para realizar la conversión de datos correcta al traspasar datos 

entre el campo del programa y la columna de la tabla. Es importante establecer 

correctamente este atributo, ya que no se comprueba si los tipos de campo son 

adecuados. 

Establezca el atributo Column antes de utilizar el atributo BufferType. Si el campo 

de programa está asociado a un componente de la interfaz, puede utilizar el 

atributo DataType para obtener el tipo de almacenamiento intermedio. 

Si una columna contiene un tipo de datos que el componente Interfaz ODBC/JDBC 

no soporta, establezca el atributo AllowChg en 0 para esa columna. El componente 

Interfaz ODBC/JDBC no traspasará datos entre ningún campo de programa y la 

columna. No se efectuará ningún cambio en los datos. 

Utilice el siguiente diagrama para establecer el tipo de datos VARPG en el 

correspondiente tipo de datos SQL soportado. Especifique los atributos BufferLen 

y BufferDec sólo como se listan en el diagrama. 

Tipo de datos SQL Tipo de datos 

VARPG 

Especifica la longitud 

del campo de 

programa (utilice 

BufferLen) 

Especifica las posiciones 

decimales de la columna 

del almacenamiento 

intermedio (utilice 

BufferDec) 

Carácter CHAR X 

Decimal Decimal con zona X 

Entero Decimal con zona X 

Entero pequeño Decimal con zona X 

Doble 8F 

Doble Decimal con zona X X 

Coma flotante 4F 

Coma flotante Decimal con zona X X 

Real 4F 

Real Decimal con zona X X 

Para los tipos de datos carácter, decimal, entero o entero pequeño, especifique sólo 

el atributo BufferLen. 

Tenga en cuenta que los tipos de datos doble, flotante y real pueden definirse en 

VARPG, como flotante (F) o decimal con zona. Si los define como decimal con 

zona, el tiempo de ejecución de VARPG sólo utilizará el número de posiciones 

decimales que especifica el atributo BufferDec cuando traslade datos de la 

columna. Esto puede provocar una pérdida de precisión si el origen de datos tiene 

más posiciones decimales que las especificadas por el atributo BufferDec. Si define 

estos campos como flotantes (F), NO especifique los atributos BufferLen ni 

BufferDec. 






SETATR 


sí 

GETATR sí 


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 Decimal 

v Entero 

v Entero pequeño 

v Coma flotante 

v Real 

v Doble 

1 Datos de tipo carácter. 

Los tipos de datos SQL que se pueden utilizar son: 

v Carácter 

v Carácter de longitud variable 

v Fecha 

v Hora 

v Indicación de la hora 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01':'ODBC1':'BufferType')=1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' SETATR 1 'BUFFERTYPE' 

* 


Button 

Averigua si se ha pulsado el botón ACEPTAR o CANCELAR o bien si se ha 

cerrado el diálogo de archivo. 



*Component 


SETATR 


no 

GETATR sí 


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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL But=%getatr('*Component':'*Component':'Button') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*COMPONENT' GETATR 'Button' But 

* 


ButtonIdx 

Establece y obtiene el índice para los botones de navegación. El índice debe 

establecerse antes de activar el atributo EnableBtn. 



Subarchivo 


SETATR 


sí 

GETATR sí 


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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'SFI1': 'ButtonIdx') = 4 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SFI1' SETATR 4 'BUTTONIDX' 

* 


Buttons 

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



Subarchivo 


SETATR 


sí 

GETATR sí 


El valor de Buttons puede ser uno de los siguientes: 

0 No mostrar los botones 

1 Mostrar los botones 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL btnval = %getatr('win01': 'SF1': 'Buttons') 

C btnval IFEQ 0 

C 

* 

EVAL %setatr('win01': 'SF1': 'Buttons') = 1 

C ELSE 

C EVAL %setatr('win01': 'SF1': 'Buttons') = 0 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SF1' GETATR 'BUTTONS' btnval 1 0 

C btnval IFEQ 1 

C 

* 

'SF1' SETATR 0 'BUTTONS' 

C ELSE 

C 'SF1' SETATR 1 'BUTTONS' 

C ENDIF 


ButtonTip 

Define el texto de la ayuda flotante de los botones de navegación correspondientes 

establecidos con ButtonIdx. 

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

Tipo Serie 


Subarchivo 


SETATR 


sí 

GETATR no 


Texto de ayuda flotante 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'SFI1': 'ButtonTip') = string 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SFI1' SETATR STRING 'BUTTONTIP' 

* 


CanUndo 

Indica si se puede deshacer la última acción. Si se devuelve 1, la última acción se 

puede deshacer. El valor 0 indica que no se puede. 




líneas 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL Chng=%getatr('win01':'ML1':'CanUndo') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ML1' GETATR 'CANUNDO' CHNG 

* 


CapsLock 

Determina si el texto que se escribe en un campo de entrada o en un subarchivo de 

un 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 columna 

correcto. 



Campo de entrada Subarchivo 


SETATR* 


sí 

GETATR sí 




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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'EF1': 'CapsLock') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'EF1' SETATR 1 'CAPSLOCK' 

* 


Case 


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

minúsculas. 



Recuadro de 

combinación 



SETATR 


sí 

GETATR sí 


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. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'CB1': 'Case') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CB1' SETATR 1 'CASE' 

* 


CellBGClr 

Valor 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 que 

se establecerá el color. 

Si el color de fondo se ha establecido mediante el atributo CellBGMix, el color de 

fondo devuelto es el que se parece más al color de mezcla. 



Subarchivo 


SETATR 


sí 

GETATR sí 


El color debe ser uno de los siguientes: 


0 Blanco 

1 Negro 

2 Azul (Blue) 

3 Rojo (Red) 

4 Rosa 

5 Verde 

6 Cian 


8 Gris oscuro 

9 Azul oscuro 






14 Marrón 

15 Gris claro 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL CBcolor = %getatr('win01': 'SFL1': 'CellBGClr') 

C EVAL %setatr('win01': 'SFL1': 'ColNumber') = 1 


C 

* 

EVAL %setatr('win01': 'SFL1': 'CellBGClr') = 5 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'SFL1' GETATR 'CELLBGCLR' 'CBcolor' 2 0 

C 'SFL1' SETATR 1 'COLNUMBER' 


C 

* 

'SFL1' SETATR 5 'CELLBGCLR' 


CellBGMix 

Consulta o establece la mezcla de colores de fondo de una casilla de un 

subarchivo. Debe utilizar los atributos Index y ColNumber para identificar la 

casilla en la que se consultará o se establecerá la mezcla de colores. 

Tipo Serie 


Subarchivo 


SETATR 


sí 

GETATR sí 







*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL CBclrMx = %getatr('win01': 'SFL1': 'CellBGMix') 

C CBclrMx IFNE '10:23:200' 

C EVAL %setatr('win01': 'SFL1': 'CellBGMix') = '10:23:200' 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8 


* 

C 'SFL1' SETATR '10:23:200' 'CELLBGMIX' 

* 


CellFGClr 

Valor numérico que determina el color de primer plano de una casilla de un 


casilla en la que se establecerá el color. 

Si el color de primer plano se ha establecido mediante el atributo CellFGMix, el 

color de primer plano devuelto es el que se parece más al color de mezcla. 



Subarchivo 


SETATR 


sí 

GETATR sí 




0 Blanco 

1 Negro 

2 Azul (Blue) 

3 Rojo (Red) 

4 Rosa 

5 Verde 

6 Cian 


8 Gris oscuro 

9 Azul oscuro 






14 Marrón 

15 Gris claro 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL CFcolor = %getatr('win01': 'SFL1': 'CellFGClr') 



C 

* 

EVAL %setatr('win01': 'SFL1': 'CellFGClr') = 5 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'SFL1' GETATR 'CELLFGCLR' 'CFcolor' 2 0 



C 

* 

'SFL1' SETATR 5 'CELLFGCLR' 


CellFGMix 

Consulta o establece la mezcla de colores de primer plano de una casilla de un 


casilla en la que se consultará o se establecerá la mezcla de colores. 

Tipo Serie 


Subarchivo 


SETATR 


sí 

GETATR sí 


La mezcla de colores de primer plano debe tener el formato siguiente: 





*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL CFclrMx=%getatr('win01':'SFL1':'CellFGMix') 

C CFclrMx IFNE '10:23:200' 

C EVAL %setatr('win01':'SFL1':'CellFGMix')='10:23:200' 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8 


* 

C 'SFL1' SETATR '10:23:200' 'CELLFGMIX' 

* 


Center 

Cuando se establece en 1, la ventana se centrará al visualizarse por primera vez. El 

usuario podrá mover después esta ventana como desee. 

Si después de centrar la ventana, la coordenada xoydelángulo superior 

izquierdo es negativa, ambas coordenadas se establecerán en (0,0) para garantizar 

que la barra de título de la ventana sea siempre visible. 



Ventana Ventana con lienzo 


SETATR* 


sí 

GETATR no 




El atributo sólo puede establecerse en 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('FW1': 'FW1': 'Center') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'FW1' SETATR 1 'CENTER' 

* 


CharData 

Devuelve el texto de tipo carácter para una columna específica de un conjunto de 

registros devuelto. Establezca el atributo Column antes de utilizar este atributo. 

Tipo Serie 




SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL ColData=%getatr('win01':'ODBC1':'CharData') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' GETATR 'CHARDATA' COLDATA 

* 


CharOffset 

Determina el valor de desplazamiento de carácter en un campo de edición de 

múltiples líneas donde se insertará el texto cuando se establezca el atributo 

AddOffset. 




líneas 


SETATR 


sí 

GETATR sí 


Desplazamiento de carácter 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'MLE1': 'CharOffset') = 10 

C 

* 

EVAL value = %getatr('win01': 'MLE1': 'CharOffset') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' SETATR 10 'CHAROFFSET' 

C 

* 

'MLE1' SETATR 'text' 'ADDOFFSET' 


Checked 

Determina si el componente está marcado. 



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


SETATR* 


sí 

GETATR sí 


diseñador GUI. Para ello, en el caso de los componentes recuadro 

de selección y botón de selección, es necesario elegir el estilo 

Selected (seleccionado). En el caso de los componentes opción de 

menú, hay que seleccionar el estilo Checked (marcada). 


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

0 El componente no está marcado 

1 El componente está marcado 


Establecer el estado de marca de un recuadro de selección con el mismo 

estado que un botón de selección: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL ischecked = %getatr('win01': 'RB1': 'Checked') 

* 

C EVAL %setatr('win01': 'CB1': 'Checked') = ischecked 

* 


Conmutar el estado de marca de un recuadro de selección: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'CB1' GETATR 'CHECKED' ischecked 

C ischecked IFEQ 1 

C 

* 

'CB1' SETATR 0 'CHECKED' 

C ELSE 

C 'CB1' SETATR 1 'CHECKED' 

C 

* 

ENDIF 


ChildCount 

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



Contenedor 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL children = %getatr('win01': 'CTR1': 'ChildCount') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CTR1' GETATR 'CHILDCOUNT' children 

* 


ChildList 

Devuelve una lista, delimitada por espacios en blanco, de los hijos directos de un 

registro que se halla en el componente contenedor. Para especificar de qué registro 

desea la lista, utilice el atributo RecordId. 

Tipo Serie 


Contenedor 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL list = %getatr('win01': 'CTR1': 'ChildList') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CTR1' GETATR 'CHILDLIST' list 

* 


ClearAll 

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



Calendario 


SETATR 


sí 

GETATR no 


El único valor válido de ClearAll es 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CAL1': 'ClearAll') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' SETATR 1 'CLEARALL' 

* 


ClearDate 

Si se establece ClearDate, se elimina el texto de usuario para la fecha indicada por 

DayIdx/MonthIdx/YearIdx. 



Calendario 


SETATR 


sí 

GETATR no 


El único valor válido de ClearDate es 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CAL1': 'ClearDate') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' SETATR 1 'CLEARDATE' 

* 


ClearMonth 

Si se establece ClearMonth, se elimina el texto de usuario establecido para el mes 

indicado por MonthIdx/YearIdx. 



Calendario 


SETATR 


sí 

GETATR no 


El único valor válido de ClearMonth es 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CAL1': 'ClearMonth') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' SETATR 1 'CLEARMONTH' 

* 


ClearYear 

Si se establece ClearYear, se elimina el texto de usuario establecido para el año 

indicado por YearIdx. 



Calendario 


SETATR 


sí 

GETATR no 


El único valor válido de ClearYear es 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CAL1': 'ClearYear') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' SETATR 1 'CLEARYEAR' 

* 


ClipBoard 

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

Tipo Serie 




SETATR 


sí 

GETATR sí 


Obtener el contenido del portapapeles: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('*Component':'*Component':'ClipBoard')=text 

C 

* 

EVAL text=%getatr('*Component':'*Component':'ClipBoard') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'*COMPONENT' SETATR text 'CLIPBOARD' 

C 

* 

'*COMPONENT' GETATR 'CLIPBOARD' text 


ColBGClr 

Valor 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 fondo 

devuelto es el que se parece más al color de mezcla. 



Subarchivo 


SETATR 


sí 

GETATR sí 




0 Blanco 

1 Negro 

2 Azul (Blue) 

3 Rojo (Red) 

4 Rosa 

5 Verde 

6 Cian 


8 Gris oscuro 

9 Azul oscuro 






14 Marrón 

15 Gris claro 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL CBcolor = %getatr('win01': 'SFL1': 'ColBGClr') 


C 

* 

EVAL %setatr('win01': 'SFL1': 'ColBGClr') = 5 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'SFL1' GETATR 'COLBGCLR' 'CBcolor' 2 0 


C 

* 

'SFL1' SETATR 5 'COLBGCLR' 


ColBGMix 

Consulta 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 se 

consultará o se establecerá la mezcla de colores. 

Tipo Serie 


Subarchivo 


SETATR 


sí 

GETATR sí 







*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL CBclrMx = %getatr('win01': 'SFL1': 'ColBGMix') 

C CBclrMx IFNE '10:23:200' 

C EVAL %setatr('win01': 'SFL1': 'ColBGMix') = '10:23:200' 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8 


* 

C 'SFL1' SETATR '10:23:200' 'COLBGMIX' 

* 


ColFGClr 

Valor numérico que determina el color de primer plano de una columna de 

subarchivo. Debe utilizar el atributo ColNumber para identificar la columna que 

tendrá definido el color. 

Si el color de primer plano se ha establecido mediante el atributo ColFGMix, el 




Subarchivo 


SETATR 


sí 

GETATR sí 




0 Blanco 

1 Negro 

2 Azul (Blue) 

3 Rojo (Red) 

4 Rosa 

5 Verde 

6 Cian 


8 Gris oscuro 

9 Azul oscuro 






14 Marrón 

15 Gris claro 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL CFcolor = %getatr('win01': 'SFL1': 'ColFGClr') 


C 

* 

EVAL %setatr('win01': 'SFL1': 'ColFGClr') = 5 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'SFL1' GETATR 'COLFGCLR' 'CFcolor' 2 0 


C 

* 

'SFL1' SETATR 5 'COLFGCLR' 


ColFGMix 

Consulta o establece la mezcla de colores de primer plano de una columna de 

subarchivo. Debe utilizar el atributo ColNumber para identificar la columna en la 

que se consultará o se establecerá la mezcla de colores. 

Tipo Serie 


Subarchivo 


SETATR 


sí 

GETATR sí 







*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL CFclrMx = %getatr('win01': 'SFL1': 'ColFGMix') 

C CFclrMx IFNE '10:23:200' 

C EVAL %setatr('win01': 'SFL1': 'ColFGMix') = '10:23:200' 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8 


* 

C 'SFL1' SETATR '10:23:200' 'COLFGMIX' 

* 


Collapsed 

Se aplica a un contenedor en la vista de árbol. Este atributo puede utilizarse para 

ampliar o contraer elementos en un registro especificado por el atributo RecordID. 

La especificación del identificador de registro cero invierte el estado de todos los 

registros en la vista de árbol. 

Al ampliar un registro específico de una aplicación Java, los registros hijo y padre 

del registro se hacen visibles. Al contraer un registro, sólo se ocultan los registros 

hijo; los registros padre permanecen visibles. 



Contenedor 


SETATR 


sí 

GETATR sí 


El valor de Collapsed puede ser uno de los siguientes: 

1 Contraer el registro 

0 Ampliar el registro 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

* Contraer el registro 

C Eval %setatr('window': 'CN1': 'Collapsed') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' SETATR 1 'COLLAPSED' 

* 


ColNumber 

Establece el número de columna de campo a utilizar al establecer otros atributos 

de subarchivo. Este atributo se utiliza con el atributo Index para indicar a qué 

campo de un registro de subarchivo se hace referencia. 



Contenedor Subarchivo 


SETATR 


sí 

GETATR no 


Número de columna de campo 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'SF1': 'Index') = 5 

C EVAL %setatr('win01': 'SF1': 'ColNumber') = 2 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SF1' SETATR 5 'INDEX' 

C 

* 

'SF1' SETATR 2 'COLNUMBER' 


Color 

Establece y obtiene el color de las áreas indicadas por el valor del atributo 

ColorArea. 



Calendario Gráfica 


SETATR* 


sí 

GETATR sí 






0 Blanco 

1 Negro 

2 Azul (Blue) 

3 Rojo (Red) 

4 Rosa 

5 Verde 

6 Cian 


8 Gris oscuro 

9 Azul oscuro 






14 Marrón 

15 Gris claro 



*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL color = %getatr('win01': 'GP1': 'Color') 

C color IFEQ *Red 

C EVAL %setatr('win01': 'GP1': 'Color') = *Blue 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8 


* 

C 'GP1' SETATR *BLUE 'COLOR' 

* 


ColorArea 

Indica el área a la que deben aplicarse los atributos Color y ColorMix al obtenerla 

o definirla. 





SETATR* 


sí 

GETATR sí 




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

siguientes: 

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 de 

los 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 


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) 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL colarea = %getatr('win01': 'GP1': 'ColorArea') 

C colarea IFEQ 3 

C EVAL %setatr('win01': 'GP1': 'ColorArea') = 4 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8 


* 

C 'GP1' SETATR 4 'COLORAREA' 

* 


ColorMix 

Establece y obtiene la mezcla de colores indicada mediante el valor del atributo 

ColorArea. 

Tipo Serie 




SETATR* 


sí 

GETATR no 




La mezcla de colores debe tener el formato siguiente: 





*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL color=%getatr('win01':'GP1':'ColorMix') 

C color IFNE '10:23:200' 

C EVAL %setatr('win01':'GP1':'ColorMix')='0:0:255' 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8 


* 

C 'GP1' SETATR '10:23:200' 'COLORMIX' 

* 


Column 

Establece cuál es la columna de una tabla a la que hacen referencia otros atributos 

como, por ejemplo, BufferLen, BufferPtr y BufferType. 





SETATR 


sí 

GETATR sí 


Entre 1yelnúmero de columnas de la tabla. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'ODBC1':'Column')=12 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' SETATR 12 'COLUMN' 

* 


ColumnDec 

Devuelve el número de posiciones decimales definido para una columna. 

Establezca el atributo Column antes de utilizar este atributo. 





SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL Dec=%getatr('win01':'ODBC1':'ColumnDec') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' GETATR 'COLUMNDEC' DEC 

* 


ColumnLen 

Devuelve la longitud definida de una columna específica de una tabla. Establezca 

el atributo Column antes de utilizar este atributo. 





SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL Len=%getatr('win01':'ODBC1':'ColumnLen') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' GETATR 'COLUMNLEN' LEN 

* 


ColumnName 

Devuelve el nombre de una columna específica de un conjunto de registros. 

Establezca el atributo Column antes de utilizar este atributo. Una consulta SQL con 

los atributos SQLQuery y ExecuteSQL ejecutada correctamente mostrará los 

nombres de columna disponibles. 

Tipo Serie 




SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL CName=%getatr('win01':'ODBC1':'ColumnName') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' GETATR 'COLUMNNAME' CNAME 

* 


Columns 

Devuelve el número de columnas en el conjunto de resultados. Una consulta SQL 

con los atributos SQLQuery y ExecuteSQL ejecutada correctamente mostrará el 

número de columnas disponibles. 





SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL Cols=%getatr('win01':'ODBC1':'Columns') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' GETATR 'COLUMNS' COLS 

* 


ColumnType 

Devuelve el tipo de datos de una columna. Antes de utilizar este atributo, 

establezca los atributos Column y ExecuteSQL. 





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, entero 

grande, bit, doble, flotante, real, entero pequeño, binario, binario de 

longitud variable largo, binario de longitud variable, otros, nulo 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL CType=%getatr('win01':'ODBC1':'ColumnType') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' GETATR 'COLUMNTYPE' CTYPE 

* 


ColWidth 

Determina el ancho de una columna de subarchivo en pixels. 

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



Subarchivo 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'SFI1': 'ColWidth') = 50 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SFI1' SETATR 50 'COLWIDTH' 

* 


| 

| 

| 

| 

| 

CompName 

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

Tipo Serie 


Referencia a 



SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C Eval %setatr('win1': 'comp1': 'CompName')='Palette' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'COMP1' SETATR 'Palette' 'COMPNAME' 

* 


Connect 

Establezca este atributo en 1 para conectar el componente Interfaz ODBC/JDBC 

con una base de datos. Antes de utilizar este atributo, establezca el atributo 

ConnectStr para determinar con qué origen de datos se conecta. 





SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'ODBC1':'Connect')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' SETATR 1 'CONNECT' 

* 


Connected 

Determina tras un intento de conexión con una tabla si la conexión se ha 

establecido 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. 





SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL Status=%getatr('win01':'ODBC1':'Connected') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' GETATR 'CONNECTED' STATUS 

* 


ConnectStr 

Proporciona la serie de conexión que debe pasarse al gestor ODBC para establecer 

una conexión con un origen de datos. Establezca este atributo antes de utilizar el 

atributo Connect. Si establece la serie de conexión en *BLANKS, aparecerá el 

diálogo Seleccionar origen de datos. En este diálogo podrá seleccionar la tabla con la 

que conectarse. 

Consulte la documentación de la API ODBC para conocer la sintaxis de una serie 

de conexión. 

Tipo Serie 




SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'ODBC1':'ConnectStr')=Str 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' SETATR STR 'CONNECTSTR' 

* 


Copy 

Copia el texto seleccionado en el portapapeles, sin suprimirlo. 



Campo de entrada Edición de múltiples 

líneas 


SETATR 


sí 

GETATR no 


El valor permitido es 1. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'MLE1': 'Copy') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' SETATR 1 'copy' 

* 


Count 

Proporciona 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 la 

lista. 



Recuadro de 

Contenedor Recuadro de lista Subarchivo de 

combinación 

mensajes 

Cuaderno Subarchivo 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL rc = %getatr('win01': 'LB1': 'Count') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'LB1' GETATR 'COUNT' count 2 0 

* 


CsrAtEnd 

Establezca este atributo en 1 para colocar el cursor detrás del último carácter de un 

campo de entrada, cuando éste pasa a ser el campo activo. 





SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'EN1': 'CsrAtEnd') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'EN1' SETATR 1 'CSRATEND' 

* 


CsrLine 

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




líneas 


SETATR 


sí 

GETATR sí 


Número de línea 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'MLE1': 'CsrLine') = 2 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' SETATR 2 'CSRLINE' 

* 


CsrPos 

Indica la posición del cursor respecto al primer carácter del campo de edición de 

múltiples líneas. 




líneas 


SETATR 


sí 

GETATR sí 


La posición del cursor 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'MLE1': 'CsrPos') = 4 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' SETATR 4 'CSRPOS' 

* 


CurrentDir 

Devuelve el directorio de trabajo actual. 

Tipo Serie 


*Component 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL Dir = %getatr('*component': '*component': 

C 

* 

'CurrentDir) 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' GETATR 'CurrentDir' Dir 

* 


CurrentRow 

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

Nota: En las aplicaciones Java, este atributo necesita el controlador adecuado de 

conformidad con JDBC 2.0. 





SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL CRow=%getatr('win01':'ODBC1':'CurrentRow') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' GETATR 'CURRENTROW' CROW 

* 


Cut 

Suprime el texto seleccionado y lo copia en el portapapeles. 




líneas 


SETATR 


sí 

GETATR no 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'MLE1': 'Cut') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' SETATR 1 'cut' 

* 


DataGroup 

Se utiliza junto con DataPoint para indicar un dato específico o independiente 

cuando se hace referencia a un grupo de puntos en su totalidad. 



Gráfica 


SETATR 


sí 

GETATR sí 


El valor debe ser mayor que 0. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'GR1': 'DataGroup') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GR1' SETATR 1 'DATAGROUP' 

* 


DataPoint 

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



Gráfica 


SETATR 


sí 

GETATR sí 


El valor debe ser mayor que 0. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'GR1': 'DataPoint') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GR1' SETATR 1 'DATAPOINT' 

* 


DataType 

Determina el tipo de datos permitidos en este campo. 



Campo de entrada Texto estático 


SETATR* 


no 

GETATR sí 




El valor de DataType puede ser uno de los siguientes: 

0 Numéricos con zona - Este componente sólo admite caracteres 

numéricos. También admite un guión (-)como carácter inicial 

para 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 o 

DBCS, pero no ambos al mismo tiempo, en función del primer 

carácter que se entre. 

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


Obtener el tipo de carácter para un campo de entrada: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL type = %getatr('win01': 'EF1': 'DataType') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'EF1' GETATR 'DATATYPE' type 1 0 

* 


DataValue 

Especifica el valor asignado a un dato en concreto 



Gráfica 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'GR1': 'DataValue') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GR1' SETATR 1 'DATAVALUE' 

* 


Date 

Indica la fecha seleccionada actualmente. La fecha siempre es una serie con el 

formato AAAAMMDD y se corresponde con los atributos Year/Month/Day. 

Tipo Serie 


Calendario 


SETATR* 


sí 

GETATR sí 




La fecha cuyo formato sea AAAAMMDD 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CAL1': 'Date') = '19980221' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' SETATR '19980221' 'DATE' 

* 


DateIdx 

Permite que el usuario defina datos en una fecha que no se visualiza en la página 

actual del calendario. La fecha siempre es una serie con el formato AAAAMMDD 

y coincide con YearIdx/MonthIdx/DayIdx. 

Tipo Serie 


Calendario 


SETATR 


sí 

GETATR sí 


El valor de índice 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CAL1': 'DateIdx') = 

C = '19980221' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' SETATR '19980221' 'DATEIDX' 

* 


DateText 

Es el texto que se visualiza dentro de la casilla de la fecha indicada por 

DayIdx/MonthIdx/YearIdx. 

Tipo Serie 


Calendario 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CAL1': 'DateText') = 'text' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' SETATR 'text' 'DATETEXT' 

* 


DateUnder 

Devuelve la fecha que hay debajo del cursor en forma de serie AAAAMMDD. Si el 

ratón no se encuentra encima de una fecha, DateUnder devuelve una serie vacía. 

Tipo Serie 


Calendario 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL yyyymmdd = %getatr('win01': 'CAL1': 

C 

* 

'DateUnder') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' GETATR 'DATEUNDER' yyyymmdd 

* 


Day 

Indica el día seleccionado actualmente. Si se establece, se actualiza la fecha 

seleccionada en el componente calendario para que los cambios queden reflejados. 



Calendario 


SETATR* 


sí 

GETATR sí 




El día del mes 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CAL1': 'Day') = 21 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' SETATR 21 'DAY' 

* 


DayIdx 


actual del calendario. 



Calendario 


SETATR 


sí 

GETATR sí 


El valor de índice 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CAL1': 'DayIdx') = 21 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' SETATR 21 'DAYIDX' 

* 


DayLen 

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



Calendario 


SETATR* 


sí 

GETATR sí 




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...) 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'CAL1': 'DayLen') = 2 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' GETATR 'DAYLEN' daylen 

* 


DayNumPos 

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



Calendario 


SETATR 


sí 

GETATR sí 


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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'CAL1': 'DayNumPos') = 3 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' GETATR 'DAYNUMPOS' daynumpos 

* 


DayNumRect 

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



Calendario 


SETATR 


sí 

GETATR sí 


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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL isout = %getatr('win01': 'CAL1': 'DayNumRect') 

C 

* 

EVAL %setatr('win01': 'CAL1': 'DayNumRect') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' GETATR 'DAYNUMRECT' isout 

* 


DayStart 

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



Calendario 


SETATR 


sí 

GETATR sí 


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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'CAL1': 'DayStart') = 2 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' SETATR 2 'DAYSTART' 

* 


DDEAddLink 

Al establecer este atributo se establece una conversación de enlace dinámico DDE 

entre la aplicación del servidor definida por los atributos AppName y Topic yel 

componente indicado por el parámetro componente. 

Cuando se establece una conversación de enlace dinámico, la aplicación del 

servidor señalará automáticamente un evento Data al componente cliente DDE 

cuando cambie el elemento especificado mediante el atributo Item del componente 

cliente DDE. A continuación, el componente cliente DDE actualizará el componente 

enlazado con los datos nuevos si se ha establecido el atributo AllowLink. 

Tipo Serie 


Cliente DDE 


SETATR* 


sí 

GETATR no 


diseñador GUI. Para ello, seleccione el pulsador Añadir y 

especifique valores en el recuadro de diálogo Añadir enlace DDE. 


El parámetro componente debe codificarse tal como se muestra a 

continuación: 




Establecer una conversación de enlace dinámico entre un campo de 

entrada y una celda de una hoja de cálculo. Cuando la celda cambie, el 

contenido del campo de entrada también cambiará. 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

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' 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'DDE1' SETATR 'win1|ef1' 'DDEADDLINK' 

* 


DDEMode 

Determina la modalidad actual de un componente cliente DDE. 



Cliente DDE 


SETATR 


sí 

GETATR no 


La modalidad del componente representada por uno de los valores 

siguientes: 

1 Initiate - Inicia una conversación DDE. Antes de poder iniciar la 

conversación, se deben haber establecido los atributos AppName y 

Topic. 

Cuando se ha iniciado la conversación DDE satisfactoriamente, se 

establece una conversación de enlace estático entre la aplicación del 

servidor y el componente Cliente DDE. Una conversación de enlace 

estático quiere decir que el componente cliente DDE debe 

establecer el atributo Request para obtener datos de la aplicación 

del servidor, y establecer el atributo Poke para enviar datos a la 

aplicación del servidor. 

2 Terminate - Finaliza la conversación DDE. Cuando se establece este 

atributo, se envía una solicitud de finalización a la aplicación del 

servidor. Cuando la aplicación del servidor haya procesado la 

solicitud de terminación, responderá señalizando un evento 

Terminate en el programa. Para procesar este evento, debe 

codificar una subrutina de acción de terminación en el programa. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'DDE1': 'DDEMode') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'DDE1' SETATR 1 'DDEMODE' 

* 


DDERmvLink 

Suprime un enlace de este componente cliente DDE. El atributo Item se utiliza 

para determinar el enlace que se va a eliminar. 

Tipo Serie 


Cliente DDE 


SETATR 


sí 

GETATR no 


El parámetro part debe codificarse de la forma siguiente: 



*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'DDE1':'DDERmvLink')='win1|ef1' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'DDE1' SETATR 'win1|ef1' 'DDERMVLINK' 

* 


DeActivate 

Establezca este atributo en 1 para desactivar un objeto ActiveX. 



ActiveX 


SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'AX1': 'DeActivate') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'AX1' SETATR 1 'DEACTIVATE' 

* 


Delete 

Suprime el texto seleccionado. 




líneas 


SETATR 


sí 

GETATR no 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'MLE1': 'Delete') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' SETATR 1 'delete' 

* 


DeleteRow 

Determina el número de fila que se suprime del conjunto de resultados. No es 

necesario buscar antes una fila para suprimirla. Este atributo ocasionará que se 

suprima cualquier fila. 

Para suprimir una fila que se acaba de buscar, utilice el atributo CurrentRow para 

obtener el número de fila. 







SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'ODBC1':'DeleteRow')=4 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' SETATR 4 'DELETEROW' 

* 


DelimChar 

Especifica el carácter delimitador que separa varios elementos de una serie de 

datos. Los atributos DelimChar y UseDelim se utilizan juntos. 

Por ejemplo, puede utilizar el punto y coma (;) para delimitar los elementos de una 

serie de datos como se indica: abcd;efgh;ijkl. Al especificar el atributo 

AddItemEnd, se generará una lista vertical de elementos de esta serie. De este 

modo, se pueden añadir varios elementos con una sola operación. 

Tipo Serie 


Recuadro de 

combinación 



SETATR* 


sí 

GETATR sí 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'CB1':'DelimChar') = ';' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CB1' SETATR ';' 'DELIMCHAR' 

* 


DeSelect 

Anula 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ón 

ampliada o múltiple en la vista de árbol. 



Recuadro de 

combinación* 

Contenedor Recuadro de lista Subarchivo 

* Restricción: Este atributo no está soportado en tiempo de ejecución en 

las aplicaciones Java para este componente. 


SETATR 


sí 

GETATR no 


Especifique el número del elemento que va a deseleccionar. Para 

deseleccionar todos los elementos de la lista, establezca el valor en cero. 


Deseleccionar el quinto elemento de la lista. 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'LB1': 'DeSelect') = 5 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'LB1' SETATR 5 'DESELECT' 

* 


Dialog 

Permite que el usuario elija un diálogo Abrir o Guardar como. 



*Component 


SETATR 


sí 

GETATR sí 


El valor de Dialog puede ser uno de los siguientes: 

1 Abrir 

2 Guardar como 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL rc = %getatr('*component': '*component': 

C 

* 

'Dialog') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' GETATR 'DIALOG' rc 

* 


DIRName 


Devuelve el nombre del directorio en el que se halla el componente lógico. 

Tipo Serie 


*Component 


SETATR 


no 

GETATR sí 


Texto 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL dir = %getatr('*component': '*component': 

C 'DIRName') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' GETATR 'DIRNAME' dir 

* 


DlgOwner 

Indica qué ventana es propietaria de un diálogo. Si no se especifica, por omisión 

será propiedad del escritorio. 

Tipo Serie 


*Component 


SETATR 


sí 

GETATR sí 


El valor debe tener el formato: 

NombVent NombVent 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('*component':'*component':'DlgOwner')= 

C 

* 

='win1 win1' 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' SETATR 'win1 win1' 'DLGOWNER' 

* 


DoEvents 


Establezca este atributo en 1 para liberar el control de la subrutina de acciones que 

está en ejecución actualmente para que se puedan ejecutar otros eventos. Es útil 

sobre todo cuando una subrutina de acciones está en un bucle de larga ejecución. 



*component 


SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('*component':'*component':'DoEvents')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*COMPONENT' SETATR 1 'DOEVENTS' 

* 


DragEnable 


Cuando este atributo está habilitado, el usuario puede mover el texto o la etiqueta 

de un componente colocando el puntero encima del componente y pulsando y 

manteniendo pulsado el botón 2 del ratón. 



Recuadro de 

combinación 


líneas 




Recuadro de lista Subarchivo de 

mensajes 

SETATR* 


sí 

GETATR sí 




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. 


Permitir DragEnable para un componente: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'EF1': 'DragEnable') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'EF1' SETATR 1 'DRAGENABLE' 

* 


DropEnable 


Determina si el componente responderá a eventos Drop 



Recuadro de 

combinación 


líneas 





mensajes 

SETATR* 


sí 

GETATR sí 





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 vez 

que se ha establecido en 1 en el constructor, no se puede restablecer. 


Permitir operaciones de soltar en un componente: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'EF1': 'DropEnable') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'EF1' SETATR 1 'DROPENABLE' 

* 


DspHeight 

Devuelve la altura de la pantalla en pixels. 





SETATR 


no 

GETATR sí 


Obtener la altura de la pantalla: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL DH=%getatr('*Component':'*Component':'DspHeight') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*COMPONENT' GETATR 'DSPHEIGHT' DH 

* 


DspWidth 

Devuelve la anchura de la pantalla en pixels. 





SETATR 


no 

GETATR sí 


Obtener la anchura de la pantalla: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL Dwd=%getatr('*Component':'*Component': 

C 'DspWidth') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*COMPONENT' GETATR 'DSPWIDTH' Dwd 

* 


EditItem 

En las aplicaciones de Windows, al establecer este atributo en 1 se abre un campo 

de 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. 



Contenedor 


SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CN1': 'EditItem')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' SETATR 1 'EDITITEM' 

* 


EnableBtn 

Habilita e inhabilita los botones de navegación. Es necesario establecer ButtonIdx 

antes de utilizar el atributo EnableBtn. 



Subarchivo 


SETATR 


sí 

GETATR sí 


Puede ser uno de los siguientes: 

0 Inhabilitar el botón 

1 Habilitar el botón 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'SFI1': 'EnableBtn') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SFI1' SETATR 1 'ENABLEBTN' 

* 


Enabled 

Determina si el componente responderá a eventos de interfaz del usuario. 

Nota: Si se especifica este atributo para los componentes en un lienzo, el valor del 

atributo establecido para el lienzo tiene preferencia. 



Calendario Lienzo Recuadro de selección Recuadro de 

combinación 

Contenedor Campo de entrada Gráfica Pulsador gráfico 

Recuadro de grupo Barra de 


horizontal 

Imagen Bean Java 

Recuadro de lista Panel de medios Opción de menú Subarchivo de 

mensajes 

Edición de múltiples Cuaderno Página de cuaderno Página de cuaderno 

líneas 

con lienzo 

Pulsador Botón de selección Graduador Selector cíclico 

Subarchivo Barra de 


vertical 

Ventana 


SETATR* 


sí 

GETATR sí 





0 El componente no puede responder a eventos 

1 El componente puede responder a eventos 



Conmutar el estado habilitado de un componente: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL rc = %getatr('win01': 'EF1': 'Enabled') 

C rc IFEQ 0 

C 

* 

EVAL %setatr('win01': 'EF1': 'Enabled') = 1 

C ELSE 

C EVAL %setatr('win01': 'EF1': 'Enabled') = 0 

C 

* 

ENDIF 


Conmutar el estado de habilitación de un campo de entrada: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'EF1' GETATR 'ENABLED' rc 1 0 

C rc IFEQ 1 

C 

* 

'EF1' SETATR 0 'ENABLED' 

C ELSE 

C 'EF1' SETATR 1 'ENABLED' 

C 

* 

ENDIF 


Execute 

Al establecer este atributo se envía un mandato execute a la aplicación del servidor 

en una conversación DDE. La aplicación del servidor determina la estructura de la 

serie del mandato. Consulte en la documentación de la aplicación del servidor los 

mandatos a los que se da soporte y la estructura de los mismos. 

Se debe haber iniciado una conversación DDE satisfactoriamente antes de 

establecer este atributo. 

Cuando la aplicación del servidor procesa el mandato execute, genera un evento 

ExecuteAck. Compruebe el atributo de evento %DDEAck en la subrutina de 

acción del evento ExecuteAck para determinar si execute se ha realizado de 

manera satisfactoria. 

Tipo Serie 


Cliente DDE 


SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'DDE1': 'Execute') = 'FILEOPEN' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'DDE1' SETATR 'FILEOPEN' 'EXECUTE' 

* 


ExecuteSQL 

Si se establece este atributo en 1, se ejecuta la sentencia SQL que ha sometido el 

último atributo SQLQuery. 





SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'ODBC1':'ExecuteSQL')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' SETATR 1 'EXECUTESQL' 

* 


ExtSelect 

Determina si el componente permite la selección ampliada. La selección ampliada 

permite que el usuario seleccione un elemento y a continuación seleccione 

elementos adicionales. El usuario puede marcar varias entradas arrastrando el 

cursor del ratón sobre ellas. 

El atributo MultSelect no tiene ningún efecto en el atributo ExtSelect. El atributo 

ExtSelect prevalece sobre los valores para MultSelect o para una única selección. 



Contenedor (1) Recuadro de lista(2.) Subarchivo (2.) 

Restricciones: 

1. Este atributo sólo se puede establecer en tiempo de 

ejecución para el componente contenedor en las 

aplicaciones Windows. 

2. Este atributo sólo se puede obtener en tiempo de 

ejecución para los componentes recuadro de lista y 

subarchivo en las aplicaciones Java. 


SETATR 


sí 

GETATR no 



0 La selección ampliada no está permitida 

1 La selección ampliada está permitida 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL rc = %getatr('win01': 'LB1': 'ExtSelect') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'LB1' GETATR 'EXTSELECT' rc 1 0 

* 


Fetch 

Si se establece este atributo en 1, devuelve una fila específica del origen de datos 

asociado. Los datos devueltos dependen del último tipo de petición de búsqueda 

realizada. Con una petición de atributo GetTables, Fetch devuelve una lista de 

tablas de la base de datos. Con una petición ExecuteSQL, Fetch devuelve una fila 

de datos de la tabla. 







SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'ODBC1':'Fetch')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' SETATR 1 'FETCH' 

* 


FetchNext 

Si se establece este atributo en 1, se busca la siguiente fila de datos del conjunto de 

resultados. 





SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'ODBC1':'FetchNext')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' SETATR 1 'FETCHNEXT' 

* 


FetchPrior 

Si se establece este atributo en 1, se busca la fila de datos anterior del conjunto de 

resultados. 







SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'ODBC1':'FetchPrior')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' SETATR 1 'FETCHPRIOR' 

* 


FieldExit 

Hace que, al pulsar Intro, el cursor se desplace al siguiente campo de entrada de 

salto de tabulación. 



Recuadro de 

combinación 



SETATR 


sí 

GETATR no 



0 El cursor no se colocará en el siguiente campo de entrada que 

corresponda 

1 El cursor se colocará en el siguiente campo de entrada que 

corresponda 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'EF1': 'FieldExit') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'EF1' SETATR 1 'FIELDEXIT' 

* 


| 

| 

FileName 

Especifica 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 de 

animación, el archivo puede ser de vídeo con la extensión .avi. En las aplicaciones 

Java 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 los 

formatos de imagen válidos, consulte “Imagen” en la página 21. 

En el componente opción de menú, siFileName hace referencia a un bitmap, la 

opción de menú se visualiza como el bitmap. Si FileName hace referencia a un 

archivo de icono, el icono se visualiza junto al texto de la opción de menú. En las 

aplicaciones Java, si FileName hace referencia a un archivo GIF, la imagen GIF se 

visualiza junto al texto de la opción de menú. 

En las aplicaciones Java, FileName hace referencia a un archivo GIF que se 

visualiza como un icono en el componente Ventana. 

Si se cambia el atributo FileName de un componente medios, no se procesa el 

archivo. Para procesarlo, se debe establecer el atributo AudioMode. 

Al cambiar el atributo FileName para un componente lienzo, pulsador gráfico o 

imagen, la imagen de ese componente cambiará de inmediato. 

Si se establece el atributo FileName para *Component, se visualizará el diálogo 

especificado 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 el 

subdirectorio de ejecución: el subdirectorio RT_JAVA para una aplicación Java o el 

subdirectorio RT_WIN32 para una aplicación de Windows 95, Windows 98 o 

Windows NT. Si sólo se especifica el nombre de archivo, los archivos sólo se 

localizará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ás 

información sobre consideraciones de nombres de archivo. 


| 

| 

| 

| 

Tipo Serie 


Control de animación Lienzo *Component Pulsador gráfico 

Imagen Medios Opción de menú Ventana 

Ventana con lienzo 


SETATR* 


sí 

GETATR sí 



* Restricción: en aplicaciones Java, este atributo es sólo de escritura. 


El nombre del archivo de estación de trabajo que se va a asociar con este 

componente 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'audio1':'FileName')='BARK.WAV' 

* 


Guardar el nombre de archivo actual de un componente imagen y 

establecer un nuevo valor para el mismo: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'IMAGE01' GETATR 'FILENAME' oldfile 64 

C 'IMAGE01' SETATR newfile 'FILENAME' 

* 


FillStyle 


Describe la forma en que se rellenará un área 



Gráfica 


SETATR 


sí 

GETATR sí 


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 



*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL style = %getatr('win01': 'GP1': 'FillStyle') 

* 

C style IFEQ 3 

C EVAL %setatr('win01': 'GP1': 'FillStyle') = 12 

C ENDIF 

* 


*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8 


* 

C 'GP1' SETATR 12 'FILLSTYLE' 

* 


FirstSel 

Devuelve el valor de índice del primer elemento seleccionado de la parte de lista 

de un componente. Los valores de índice empiezan por 1. Si no hay ningún 

elemento seleccionado en la lista, se devuelve cero. 



Recuadro de 

combinación 

Subarchivo 



mensajes 

SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL ix = %getatr('win01': 'LB1': 'FirstSel') 

* 


Comprobar si se ha seleccionado un elemento de un recuadro de lista y 

visualizar un mensaje si no se ha seleccionado: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'LB1' GETATR 'FIRSTSEL' IX 3 0 

C IX IFEQ *ZERO 

C 'Select error'DSPLY STYLE rc 

C 

* 

ENDIF 


Focus 

Determina si el componente tiene el foco actualmente. Cuando un componente 

tiene el foco, el cursor de entrada se traslada a él y la entrada del usuario se dirige 

hacia é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. 



Recuadro de selección Recuadro de 

combinación 

Contenedor Campo de entrada 

Pulsador gráfico Barra de 

Recuadro de lista Edición de múltiples 


horizontal 

líneas 

Cuaderno Pulsador Botón de selección Graduador 

Selector cíclico Subarchivo Barra de 


vertical 

Ventana* 

* Restricción: Este atributo sólo se puede establecer en tiempo de 

ejecución para el componente ventana en las aplicaciones 

Java. 


SETATR 


sí 

GETATR sí 



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.


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'EF1': 'Focus') = 1 

* 

C EVAL rc = %getatr('win01': 'EF1': 'Focus') 

* 


Conmutar el foco para un componente: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'EF1' GETATR 'FOCUS' HasFocus 1 0 

C 

* 

'EF1' SETATR 1 'FOCUS' 


FontArea 

Indica el área del componente calendario, gráfica o subarchivo a la que deben 

aplicarse el resto de atributos relacionados con el font. 



Calendario Gráfica Subarchivo 


SETATR 


sí 

GETATR sí 


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


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL Farea = %getatr('win01': 'GRA1': 'FontArea') 

* 

C EVAL %setatr('win01': 'GRA1': 'FontArea') = 5 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GRA1' GETATR 'FONTAREA' Farea 1 0 

* 


FontBold 

Determina si la etiqueta o el texto se visualiza en negrita. 




combinación 

Contenedor Campo de entrada Gráfica Recuadro de grupo 

Recuadro de lista Subarchivo de Edición de múltiples Cuaderno 

mensajes 

líneas 


Texto estático Subarchivo Ventana* 



Nota: En el caso de los componentes calendario y gráfica, el área de font 

real afectada queda determinada por el valor del atributo FontArea. 


SETATR* 


sí 

GETATR sí 



diseñador GUI. Para ello, utilice la página Font y seleccione el 

pulsador Cambiar font.


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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL bold = %getatr('win01': 'ST1': 'FontBold') 

C bold IFEQ 0 

C EVAL %setatr('win01': 'ST1': 'FontBold') = 1 

C ELSE 

C EVAL %setatr('win01': 'ST1': 'FontBold') = 0 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'ST1' GETATR 'FONTBOLD' bold 1 0 

C 

* 

'ST1' SETATR 1 'FONTBOLD' 


FontItalic 

Determina si la etiqueta o el texto se muestra en Cursiva. 




combinación 



mensajes 

líneas 








SETATR* 


sí 

GETATR sí 






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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL italic = %getatr('win01': 'ST1': 'FontItalic') 

C italic IFEQ 0 

C EVAL %setatr('win01': 'ST1': 'FontItalic') = 1 

C ELSE 

C EVAL %setatr('win01': 'ST1': 'FontItalic') = 0 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'ST1' GETATR 'FONTITALIC' italic 1 0 

C 

* 

'ST1' SETATR 1 'FONTITALIC' 


FontName 

Especifica el font que va a utilizarse para el texto o la etiqueta que se aplica a este 

componente. 

Tipo Serie 



combinación 



mensajes 

líneas 








SETATR* 


sí 

GETATR sí 



pulsador Cambiar font. 


Nombre del font 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL oldfont = %getatr('win01': 'ST1': 'FontName') 

* 

C EVAL %setatr('win01': 'ST1': 'FontName') = 'COURIER' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'ST1' GETATR 'FONTNAME' oldfont 64 

C 

* 

'ST1' SETATR 'COURIER' 'FONTNAME' 


FontSize 

Especifica el tamaño del font a utilizar con este componente. El atributo FontSize 

se expresa en puntos. 




combinación 



mensajes 

líneas 








SETATR* 


sí 

GETATR sí 





El tamaño de font especificado en puntos 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL oldsize = %getatr('win01': 'ST1': 'FontSize') 

* 

C EVAL %setatr('win01': 'ST1': 'FontSize') = 10 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'ST1' GETATR 'FONTSIZE' oldsize 2 0 

C 

* 

'ST1' SETATR 10 'FONTSIZE' 


FontStrike 


Determina si el texto o la etiqueta aparecen en font tachado. 




combinación 



mensajes 

líneas 


Texto estático Subarchivo Ventana 




SETATR* 


sí 

GETATR sí 






El valor de FontStrike puede ser uno de los siguientes: 

0 El font no se visualiza tachado 

1 El font se visualiza tachado 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL strikeout=%getatr('win01':'ST1':'FontStrike') 

C strikeout IFEQ 0 

C EVAL %setatr('win01':'ST1':'FontStrike')=1 

C ELSE 

C 

* 

EVAL %setatr('win01':'ST1':'FontStrike')=0 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'ST1' GETATR 'FONTSTRIKE' strikeout 1 0 

C 

* 

'ST1' SETATR 1 'FONTSTRIKE' 


FontUnder 


Determina si el texto o la etiqueta aparece subrayado. 




combinación 



mensajes 

líneas 


Texto estático Subarchivo Ventana 




SETATR* 


sí 

GETATR sí 





El valor de FontUnder puede ser uno de los siguientes: 

0 El texto no se subraya 

1 El texto se subraya 



*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL underline=%getatr('win01':'ST1':'FontUnder') 

* 

C underline IFEQ 0 

C EVAL %setatr('win01':'ST1':'FontUnder')=1 

C ELSE 

C EVAL %setatr('win01':'ST1':'FontUnder')=0 

C ENDIF 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'ST1' GETATR 'FONTUNDER' underline 1 0 

C 

* 

'ST1' SETATR 1 'FONTUNDER' 


ForeColor 

Valor 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, el 

color de primer plano devuelto es el más próximo al color de mezcla. 




combinación 


Recuadro de grupo Recuadro de lista Subarchivo de Edición de múltiples 

mensajes 

líneas 


Selector cíclico Texto estático Subarchivo 


SETATR* 


sí 

GETATR sí 






0 Blanco 

1 Negro 

2 Azul (Blue) 

3 Rojo (Red) 

4 Rosa 

5 Verde 

6 Cian 


8 Gris oscuro 

9 Azul oscuro 






14 Marrón 

15 Gris claro 



Establecer contraste invertido de un campo: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL fcolor = %getatr('win01': 'EF1': 'ForeColor') 

C 

* 

EVAL bcolor = %getatr('win01': 'EF1': 'BackColor') 

C EVAL %setatr('win01': 'EF1': 'ForeColor') = 2 

C 

* 

EVAL %setatr('win01': 'EF1': 'BackColor') = 15 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'EF1' GETATR 'FORECOLOR' fcolor 2 0 

C 

* 

'EF1' SETATR 2 'FORECOLOR' 


ForeMix 

Consulta o establece la mezcla de colores de primer plano. 

Tipo Serie 



combinación 


Recuadro de grupo Recuadro de lista Subarchivo de Edición de múltiples 

mensajes 

líneas 




SETATR* 


sí 

GETATR sí 



diseñador GUI.







*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL colormix = %getatr('win01': 'EF1': 'ForeMix') 

C 

* 

EVAL %setatr('win01': 'EF1': 'ForeMix') = '10:23:200' 


*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8 


* 

C 'EF1' SETATR '10:23:200' 'FOREMIX' 

* 


Format 

Determina el formato de los datos a los que el atributo Item hace referencia y que 

se han enviado a la aplicación del servidor en una conversación DDE. El valor de 

este atributo lo determina la aplicación del servidor. Consulte la documentación de 

dicha aplicación para ver cuáles son los tipos de formato válidos. El valor por 

omisión es cf_text. Debe establecerse este atributo antes de utilizar el atributo Poke. 

Tipo Serie 


Cliente DDE 


SETATR 


sí 

GETATR sí 


El formato de los datos a los que se hace referencia y que se envían a la 

aplicación del servidor 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'DDE1': 'Format') = 'bitmap' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'DDE1' SETATR 'bitmap' 'Format' 

* 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

FrameRate 

Determina el tiempo, en milisegundos, que transcurre entre cada fotograma de una 

secuencia GIF animada. 





SETATR 


sí 

GETATR no 


El número de milisegundos que transcurren entre las distintas imágenes. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'WIN1':'FrameRate')=1000 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ANI' SETATR 1000 'FRAMERATE' 

* 


FrmtString 

Indica 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, se 

sustituirán, respectivamente, por el mes o el año actual. Por ejemplo, la serie de 

formato ″MMONTH - YYEAR″ correspondiente a julio de 1997 se convierte en 

″Julio - 1997″. 

Tipo Serie 


Calendario 


SETATR* 


sí 

GETATR sí 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CAL1': 'FrmtString') = 

C 'MMONTH/YYEAR' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' SETATR 'MMONTH/YYEAR''FRMTSTRING' 

* 


GetItem 

Devuelve un elemento de una lista. El elemento a devolver se determina 

estableciendo primero el valor del atributo Index. 

Tipo Serie 


Recuadro de 

combinación 



mensajes 

SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL x = %getatr('win01': 'LB1': 'GetItem') 

* 


Guardar un elemento en un recuadro de lista y cambiarlo: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'LB1' SETATR 3 'INDEX' 

C 'LB1' GETATR 'GETITEM' saveitem 64 

C 

* 

'LB1' SETATR 'New string' 'SetItem' 


GetNewID 

Devuelve un ID nuevo y exclusivo para un registro de contenedor. Utilice este 

atributo para asegurarse de que todos los ID de registros de contenedor son 

exclusivos. El identificador de registro devuelto es un valor numérico. 



Contenedor 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL id = %getatr('win01': 'CN1': 'GetNewID') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' GETATR 'GetNewID' id 

* 


GetRcdFld 

Devuelve el contenido de un campo de un registro de contenedor. El atributo 

RecordID del contenedor debe estar establecido para indicar qué registro de 

contenedor se ha de utilizar. También debe estar establecido el atributo 

ColNumber para indicar el campo del que se recuperarán los datos. 

Tipo Serie 


Contenedor 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CN1': 'RecordID')=ID 

C EVAL %setatr('win01': 'CN1': 'ColNumber')=1 

C 

* 

EVAL data = %getatr('win01': 'CN1': 'GetRcdFld') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' SETATR ID 'RECORDID' 

C 'CN1' SETATR 1 'COLNUMBER' 

C 

* 

'CN1' GETATR 'GETRCDFLD' data 


GetRcdIcon 

Devuelve el nombre de archivo del icono que se utiliza para representar este 

registro en la vista de árbol y de iconos. El atributo RecordID debe estar 

establecido para identificar a qué registro se hace referencia. 

Tipo Serie 


Contenedor 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL file = %getatr('win01': 'CN1': 'GetRcdIcon') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' GETATR 'GETRCDICON' file 

* 


GetRcdText 

Devuelve el texto del icono correspondiente a un registro del contenedor. El 

atributo RecordID debe estar establecido para identificar a qué registro se hace 

referencia. 

Tipo Serie 


Contenedor 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL text = %getatr('win01': 'CN1': 'GetRcdText') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' GETATR 'GETRCDTEXT' text 

* 


GetTables 

Al establecer este atributo en 1, se recupera la lista de las tablas almacenadas en 

una fuente de datos. El componente Interfaz ODBC/JDBC devuelve la lista como 

un 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 del 

conjunto de datos devuelto. 

Para ODBC, cada registro de la lista corresponde a una tabla y contiene la 

información siguiente: 

Columna Nombre de 

columna 

Tipo de datos Comentarios 

1 Calificador de tabla Carácter 

2 Propietario de tabla Carácter El propietario de la tabla 

3 Nombre de tabla Carácter El nombre de la tabla 

4 Tipo de tabla Carácter Una serie que representa el tipo 

de la tabla 

5 Observaciones Carácter Una descripción de la tabla 

Consulte la documentación de la API ODBC para conocer los detalles de las 

descripciones de columna. 

Para JDBC, se devuelve la información siguiente: 

Columna Nombre de 

columna 

Tipo de datos Comentarios 

1 TABLE_CAT Carácter Catálogo de tablas (puede ser un 

nulo) 

2 TABLE_SCHEM Carácter Esquema de tablas (puede ser un 

nulo) 

3 TABLE_NAME Carácter El nombre de la tabla 

4 TABLE_TYPE Carácter Una serie que representa el tipo 

de la tabla. Los valores usuales 

son: TABLE, VIEW, SYSTEM 

TABLE, 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 las 

descripciones de columna. 






SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'ODBC1':'GetTables')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' SETATR 1 'GETTABLES' 

* 

Ejemplo de GetTables 

En este ejemplo se muestra cómo obtener una lista de tablas de una fuente de 

datos y listarlas en el recuadro de lista TABLES: 


C 'ODBC1' Setatr 1 'GetTables' 

C 'ODBC1' Setatr 1 'Fetch' 

C 'ODBC1' Getatr 'IsData' Temp 1 0 

* 

C If Temp = 1 

C 'Tables' Setatr 0 'RemoveItem' 

* 

C DoW Temp = 1 

C 'ODBC1' Setatr 3 'Column' 

C 'ODBC1' Getatr 'CharData' TableName 20 

C 'Tables' Setatr TableName 'AddItemEnd' 

C 'ODBC1' Setatr 1 'FetchNext' 

C 'ODBC1' Getatr 'IsData' Temp 

C EndDo 

* 

C EndIf 


GnEqGrpCol 

Genera un conjunto aleatorio de colores de manera que todos los puntos de datos 

de un mismo grupo sean del mismo color. 

Este atributo resulta útil cuando se muestra una gráfica de barras. 



Gráfica 


SETATR 


sí 

GETATR no 


El valor sólo puede definirse en 1. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'GR1':'GnEqGrpCol')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GR1' SETATR 1 'GNEQGRPCOL' 

* 


GnEqPntCol 

Genera un conjunto aleatorio de colores de manera que todos los valores de un 

punto de datos determinado sean del mismo color. 

Este atributo resulta útil cuando se muestra un diagrama circular. 



Gráfica 


SETATR 


sí 

GETATR no 


El valor sólo puede definirse en 1. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'GR1':'GnEqPntCol')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GR1' SETATR 1 'GNEQPNTCOL' 

* 


GraphType 

Indica qué tipo de gráfica se utiliza. 



Gráfica 


SETATR* 


sí 

GETATR sí 




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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL GRtype = %getatr('win01': 'GRT1': 'GraphType') 

C 

* 

EVAL %setatr('win01': 'GRT1': 'GraphType') = 2 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'GRT1' GETATR 'GRAPHTYPE' 'GRtype' 1 0 

C 

* 

'GRT1' SETATR 2 'GRAPHTYPE' 


GrphHiLite 

Determina si se resalta un elemento. 



Gráfica 


SETATR 


sí 

GETATR sí 


El valor de GrphHiLite puede ser uno de los siguientes: 

0 No se resalta el elemento 

1 Sí se resalta el elemento 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL lite = %getatr('win01': 'GR1': 'GrphHiLite') 

C lite IFEQ 0 

C EVAL %setatr('win01': 'GR1': 'GrphHiLite') = 1 

C ELSE 

C EVAL %setatr('win01': 

'GR1': 'GrphHiLite') = 0 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'GR1' GETATR 'GRPHHILITE' lite 1 0 

C 

* 

'GR1' SETATR 1 'GRPHHILITE' 


GroupLabel 

Indica cuál es la etiqueta del grupo actual. Las etiquetas de grupo se utilizan como 

encabezamiento de cada uno de los grupos de puntos, si la gráfica es un diagrama 

circular, o como leyenda, si ésta está definida para mostrar las etiquetas de grupo. 

Tipo Serie 


Gráfica 


SETATR* 


sí 

GETATR sí 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'graph1':'GroupLabel')='July' 

* 


Guardar la etiqueta actual de un componente gráfica y establecer un nuevo 

valor para la misma: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GRAPH01' GETATR 'GROUPLABEL' oldlabel 

C 'GRAPH01' SETATR 'July' 'GROUPLABEL' 

* 


Handle 


Devuelve el handle de ventana del componente. Si está familiarizado con las API 

de Windows, puede utilizar este handle para invocar las funciones de API. En el 

proceso ODBC, devuelve el handle de entorno. 

Por ejemplo, cuando el componente Interfaz ODBC/JDBC se conecta a una base de 

datos, se crea un handle de entorno y se devuelve al componente. El componente 

utiliza este handle para comunicarse con la API ODBC. El atributo Handle se 

puede utilizar para recuperar la variable de handle del programa e invocar las 

funciones de la API ODBC. La variable de handle es un valor de 32 bits. Debe 

codificar la variable para recibir el handle como tipo de datos entero con una 

longitud de 10 y 0 decimales: 

DName+++++++++++ETDsFrom+++To/L+++IDc.Keywords+++++++++++++ 

D hWnd S 10I 0 



Todos los componentes excepto los siguientes: ActiveX, *componente 

ló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ú y 

temporizador. 


SETATR 


no 

GETATR sí 


Devuelve el handle del componente. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL hWnd = %getatr('win01': 'FW1': 'Handle') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'FW1' GETATR 'HANDLE' hWnd 

* 


HasPrpPage 

Devuelve el valor 1 si el objeto ActiveX tiene su propio diálogo de página de 

propiedades. Devuelve el valor 0 si no lo tiene. 



ActiveX 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL PPG=%getatr('win01':'AX1':'HasPrpPage') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'AX1' GETATR 'HASPRPPAGE' PPG 

* 


HdgBGClr 

Valor 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 de 

fondo devuelto es el que se parece más al color de mezcla. 



Subarchivo 


SETATR 


sí 

GETATR sí 



-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 






14 Marrón 

15 Gris claro 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL HBcolor = %getatr('win01': 'SFL1': 'HdgBGClr') 

C 

* 

EVAL %setatr('win01': 'SFL1': 'HdgBGClr') = 5 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'SFL1' GETATR 'HDGBGCLR' HBcolor 2 0 

C 

* 

'SFL1' SETATR 5 'HDGBGCLR' 


HdgBGMix 

Consulta o establece la mezcla de colores de fondo de una cabecera de subarchivo. 

Tipo Serie 


Subarchivo 


SETATR 


sí 

GETATR sí 







*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL HBclrMx=%getatr('win01':'SFL1':'HdgBGMix') 

C HBclrMx IFNE '10:23:200' 

C EVAL %setatr('win01':'SFL1':'HdgBGMix')='10:23:200' 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8 


* 

C 'SFL1' SETATR '10:23:200' 'HDGBGMIX' 

* 


HdgFGClr 

Valor numérico que determina el color de primer plano de una cabecera de 

subarchivo. 

Si el color de primer plano se ha establecido mediante el atributo HdgFGMix, el 




Subarchivo 


SETATR 


sí 

GETATR sí 



-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 





14 Marrón 

15 Gris claro 



*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL HFcolor = %getatr('win01': 'SFL1': 'HdgFGClr') 

* 

C EVAL %setatr('win01': 'SFL1': 'HdgFGClr') = 5 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'SFL1' GETATR 'HDGFGCLR' HFcolor 2 0 

C 

* 

'SFL1' SETATR 5 'HDGFGCLR' 


HdgFGMix 

Consulta o establece la mezcla de colores de primer plano de una cabecera de 

subarchivo. 

Tipo Serie 


Subarchivo 


SETATR 


sí 

GETATR sí 







*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

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 


*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8 


* 

C 'SFL1' SETATR '10:23:200' 'HDGFGMIX' 

* 


HdgIdx 

Identifica la fila en una cabecera de columna de varias líneas. Por ejemplo, un 

valor de 1 especifica la primera fila. Utilice este atributo junto con el atributo 

ColNumber para recuperar o cambiar el texto especificado en el atributo HdgText. 



Subarchivo 


SETATR 


sí 

GETATR sí 


HdgIdx puede estar entre 1y3. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'SF1':'HdgIdx')=3 

C EVAL %setatr('win01': 'SF1': 'ColNumber') = 2 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SF1' SETATR 3 'HDGIDX' 

C 

* 

'SF1' SETATR 2 'COLNUMBER' 


HdgText 

El texto de la cabecera de columna. Este texto puede contener hasta tres líneas de 

texto. Puede ser un identificador de mensaje del archivo de mensajes o etiqueta de 

sustitución. Para cambiar este texto en tiempo de ejecución, debe establecer antes 

los atributos ColNumber y HdgIdx. 

Tipo Serie 


Subarchivo 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'SF1':'HdgText')='HEAD1' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SF1' SETATR 'HEAD1' 'HDGTEXT' 

* 


| 

| 

| 

| 

| 

| 

| 

Height 

Especifica la altura del componente en pixels. 

El atributo Height no puede sobrepasar la altura máxima determinada por la 

resolución de pantalla utilizada. Por ejemplo, no se puede crear un componente 

que tenga 600 pixels de altura si se trabaja con una pantalla de 480 pixels de 

altura. 



ActiveX Calendario Lienzo Recuadro de selección 

Recuadro de 

combinación 

Contenedor Campo de entrada Gráfica 

Pulsador gráfico Recuadro de grupo Barra de 


horizontal 

Imagen 

Bean Java Recuadro de lista Panel de medios Subarchivo de 

mensajes 


líneas 

Cuaderno Interfaz ODBC/JDBC Recuadro de contorno 

Barra de progreso Pulsador Botón de selección Graduador 


Ventana 

Texto estático Subarchivo Barra de 


vertical 


SETATR* 


sí 

GETATR sí 




La altura del componente en pixels 


Cambiar la altura de un componente: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL howtall = %getatr('win01': 'PB1': 'Height') 

C howtall add 150 howtall 

C EVAL %setatr('win01': 'PB1': 'Height') = howtall 

* 


Hacer que un pulsador tenga 100 pixels menos de altura: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'PB1' GETATR 'HEIGHT' OldHeight 2 0 

C OldHeight SUB 100 NewHeight 2 0 

C 

* 

'PB1' SETATR NewHeight 'HEIGHT' 


HelpEnable 

Visualiza información de Ayuda cuando el usuario pulsa un pulsador o un 

pulsador gráfico. Es lo más útil si desea visualizar Ayuda general para una 

ventana. Generalmente, para visualizar Ayuda para un componente, el usuario 

debe pulsar la tecla F1 cuando el componente tiene el foco. 

Nota: Para que el usuario pueda visualizar la ayuda, primero debe dar el foco al 

componente pulsador o pulsador gráfico. 



Pulsador gráfico Pulsador 


SETATR* 


sí 

GETATR sí 

*Nota: Puede definirse utilizando el cuaderno de propiedades del 

diseñador GUI. Para ello, seleccione el estilo Visualizar ayuda. 


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 



Conmutar el estado de ayuda habilitada de un componente: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL rc = %getatr('win01': 'PB1': 'HelpEnable') 

C rc IFEQ 0 

C 

* 

EVAL %setatr('win01': 'PB1': 'HelpEnable') = 1 

C ELSE 

C EVAL %setatr('win01': 'PB1': 'HelpEnable') = 0 

C 

* 

ENDIF 


Conmutar el estado de ayuda habilitada de un campo de entrada: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'PB1' GETATR 'HELPENABLE' HasHelp 1 0 

C HasHelp IFEQ 1 

C 

* 

'PB1' SETATR 0 'HELPENABLE' 

C ELSE 

C 'PB1' SETATR 1 'HELPENABLE' 

C 

* 

ENDIF 


HelpWindow 

Origina la visualización de una ventana específica de panel de ayuda. El valor de 

helpid es el identificador de ayuda especificado en el archivo de ayuda. Si se 

utiliza el valor de identificador de ayuda 0, se visualizará un diálogo de temas de 

ayuda del estilo de Windows 95. 



*Component 


SETATR 


sí 

GETATR no 


El helpid 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('*component':'*component':'HelpWindow')= 

C 12 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' SETATR 12 'HELPWINDOW' 

* 


Hidden 

Determina si una columna de un subarchivo será visible. El atributo ColNumber 

debe estar establecido para indicar a qué columna afecta. 



Subarchivo 


SETATR 


sí 

GETATR sí 


El valor de Hidden puede ser uno de los siguientes: 

0 La columna no está oculta 

1 La columna está oculta 


Cambiar el estado Hidden de una columna 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL rc = %getatr('win01': 'SF1': 'Hidden') 

C rc IFEQ 0 

C 

* 

EVAL %setatr('win01': 'SF1': 'Hidden') = 1 

C ELSE 

C EVAL %setatr('win01': 'SF1': 'Hidden') = 0 

C 

* 

ENDIF 


Cambiar el estado Hidden de un atributo 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SF1' GETATR 'HIDDEN' IsHidden 1 0 

C IsHidden IFEQ 1 

C 

* 

'SF1' SETATR 0 'HIDDEN' 

C ELSE 

C 'SF1' SETATR 1 'HIDDEN' 

C 

* 

ENDIF 


HighLight 

Determina si se resalta el componente especificado. Un componente resaltado tiene 

el mismo aspecto que un botón en el que se pulse el botón 1 del ratón mientras el 

puntero del ratón está sobre el control del botón. 



Recuadro de 

selección* 

Pulsador gráfico Pulsador Botón de selección* 




SETATR 


sí 

GETATR sí 


El valor de HighLight puede ser uno de los siguientes: 

0 El componente no está resaltado 

1 El componente está resaltado 



Conmutar el estado de HighLight de un componente: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL rc = %getatr('win01': 'PB1': 'HighLight') 

C rc IFEQ 0 

C 

* 

EVAL %setatr('win01': 'PB1': 'HighLight') = 1 

C ELSE 

C EVAL %setatr('win01': 'PB1': 'HighLight') = 0 

C 

* 

ENDIF 


Conmutar el estado de HighLight de un componente: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'PB1' GETATR 'HIGHLIGHT' IsHighlighted 1 0 

C IsHilighted IFEQ 1 0 

C 

* 

'PB1' SETATR 0 'HIGHLIGHT' 

C ELSE 

C 'PB1' SETATR 1 0 'HIGHLIGHT' 

C 

* 

ENDIF 


HitItem 

Una 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 establecen 

DataGroup y DataPoint. 

Si la gráfica es un diagrama circular y debajo del punto especificado hay una 

etiqueta de grupo, se establece DataGroup. 

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



Gráfica 


SETATR 


no 

GETATR sí 



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 



*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL itemhit = %getatr('win01': 'GRA1': 'HitItem') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GRA1' GETATR 'HITITEM' itemhit 1 0 

* 


HlitPoints 


Si se establece HlitPoints, se resaltan todos los datos del grupo indicado por 

DataGroup. Este es relevante sólo si la gráfica es de barras. 



Gráfica 


SETATR 


sí 

GETATR sí 


Los valores permitidos son los siguientes: 

0 El grupo de datos actual no está resaltado 

Cualquier valor que no sea cero 

El grupo de datos actual está resaltado 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'GP1': 'HlitPoints') = 20 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GP1' SETATR 20 'HLITPOINTS' 

* 


HRule 

Visualiza reglas horizontales. 



Calendario Subarchivo 


SETATR 


sí 

GETATR sí 


El valor de HRule puede ser uno de los siguientes: 

0 Desactiva la regla 

1 Activa la regla 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL Hzrule = %getatr('win01': 'SF1': 'HRule') 

C Hzrule IFEQ 0 

C EVAL %setatr('win01': 'SF1': 'HRule') = 1 

C ELSE 

C EVAL %setatr('win01': 'SF1': 'HRule') = 0 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'SF1' GETATR 'HRULE' Hzrule 1 0 

C 

* 

'SF1' SETATR 1 'HRULE' 


IconHandle 


Devuelve el handle del icono de ventana. 





SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL ichW=%getatr('win01':'FW1':'IconHandle') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'FW1' GETATR 'ICONHANDLE' ICHW 

* 


Index 

Establece el valor de índice para la parte de lista de un componente. Este valor 

determina el elemento que se ve afectado cuando se utilizan determinados 

atributos. Por ejemplo, el atributo Index debe establecerse para un elemento para 

que el atributo GetItem se pueda utilizar para recuperarlo. 



Recuadro de 

combinación 



mensajes 

Subarchivo 

SETATR 


sí 

GETATR sí 


Valor de índice 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'LB1': 'Index') = 4 

C 

* 

EVAL index = %getatr('win01': 'LB1': 'Index') 


Guardar el valor de índice actual para un recuadro de lista y, a 

continuación, cambiarlo: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'LB1' GETATR 'INDEX' OldIndex 2 0 

C 'LB1' SETATR NewIndex 'INDEX' 2 0 

* 


InPlace 


Utilice InPlace para designar dónde debe reproducirse el archivo de vídeo. Si 

InPlace se establece en 1, el vídeo se reproducirá en la posición del componente 

medios. Si se establece en 0, el archivo se reproducirá en una ventana aparte. 



Medios 


SETATR 


sí 

GETATR sí 


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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'AUD1': 'InPlace') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'AUD1' SETATR 1 'INPLACE' 

* 


InsertItem 


Inserta un elemento en la parte de lista de un componente. El valor actual del 

atributo Sequence para el componente determina dónde se insertará el elemento 

en la lista. 

Si se utiliza el método Index para insertar elementos en la lista, el elemento que 

aparece en la posición del valor de índice y todos los que le siguen descienden un 

puesto en la lista. 

Tipo Serie 


Recuadro de 

combinación 



SETATR 


sí 

GETATR no 


El elemento a insertar en la lista 


Insertar un elemento en un recuadro de lista: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'LB1': 'Index') = 3 

C EVAL %setatr('win01': 'LB1': 'InsertItem') = 'new' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 


C 

* 

'LB1' SETATR 'new' 'InsertItem' 


InsertLine 

Inserta la serie especificada en el campo de edición de múltiples líneas en la 

posición especificada mediante el atributo LineNumber actual. Todas las líneas 

siguientes a la que se ha insertado descienden una línea. 

Tipo Serie 



líneas 


SETATR 


sí 

GETATR no 


La serie que se añadirá al campo de edición de múltiples líneas 


Insertar texto en el desplazamiento 10 en un campo de edición de 

múltiples líneas: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'MLE1': 'LineNumber') = 10 

C EVAL %setatr('win01': 'MLE1': 'InsertLine') = 'text' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' SETATR 10 'LINENUMBER' 

C 

* 

'MLE1' SETATR 'text' 'INSERTLINE' 


InsertMode 


Determina si la parte del campo de entrada del componente está en modalidad de 

inserción. Cuando la modalidad de inserción está activada, al escribir caracteres en 

un campo, se desplazan los caracteres situados a la derecha del cursor. Cuando 

está desactivada, al escribir caracteres en un campo, se escribe encima de los 

existentes. 





SETATR 


no 

GETATR sí 


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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL mode = %getatr('win01': 'EF1': 'InsertMode') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'EF1' GETATR 'INSERTMODE' InsertMode 1 0 

* 


InsertRow 

Al establecer este atributo en 1, se añade otra fila a la tabla. Antes de añadir la 

nueva fila, los datos se traspasan de los campos de programa que están enlazados 

a las columnas de las tablas. 







SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'ODBC1':'InsertRow')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' SETATR 1 'INSERTROW' 

* 


InsertText 

Inserta el texto especificado en la posición actual del cursor del campo de edición 

de múltiples líneas. 

Tipo Serie 



líneas 


SETATR 


sí 

GETATR no 


La serie de texto que se debe insertar 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'MLE1': 'InsertText') = 'New' 

* 


Añadir texto a un campo de edición de múltiples líneas en la posición 

actual del cursor:: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' SETATR 'New' 'InsertText' 

* 


Interval 

Determina el valor de intervalo para un componente temporizador. Este atributo se 

utiliza con el atributo Multiplier para determinar el número de milisegundos que 

transcurrirán hasta que el temporizador genere un evento Tick. 



Temporizador 


SETATR* 


sí 

GETATR sí 




Valor del intervalo en milisegundos 

El valor máximo del intervalo es 65535. 

El valor mínimo del intervalo es 100. 


Cambiar el valor de intervalo para un componente temporizador a un 

segundo (1000 milisegundos): 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL oldint=%getatr('win01':'TIMER01':'Interval') 

* 

C EVAL %setatr('win01':'TIMER01':'Interval')=1000 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'TIMER01' GETATR 'INTERVAL' OldInt 6 0 

C 

* 

'TIMER01' SETATR 1000 'INTERVAL' 


InUse 


Consulta si un objeto del contenedor tiene actualmente un énfasis que indica que 

se está utilizando. Un objeto con este énfasis está en una ventana de diseño abierta 

y se muestra con un recuadro sombreado detrás de su icono, como se indica a 

continuación: 

El atributo RecordID debe estar establecido para indicar a qué registro se hace 

referencia. 



Contenedor 


SETATR 


sí 

GETATR sí 


El valor de InUse puede ser uno de los siguientes: 

0 No se está utilizando 

1 Se está utilizando 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'CN1': 'InUse') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' SETATR 1 'INUSE' 

* 


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 




SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'POP1':'InvName')='INVN1' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'POP1' SETATR 'INVN1' 'INVNAME' 

* 


InvPName 


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 




SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'POP1':'InvPName')='INVPN1' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'POP1' SETATR 'INVPN1' 'INVPNAME' 

* 


IsData 

Indica si una operación Fetch, FetchNext o FetchPrior ha devuelto datos. 





SETATR 


no 

GETATR sí 


0 Indica que no se ha devuelto ningún dato. 

1 Indica que se han devuelto datos. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL Flag=%getatr('win01':'ODBC1':'IsData') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' GETATR 'ISDATA' FLAG 

* 


Item 

Un elemento DDE es la unidad de datos específica a la que se hace referencia en 

una conversación DDE. Un ejemplo de un elemento DDE es una casilla en una 

aplicación de hoja de cálculo. El formato de un elemento DDE lo determina la 

aplicación del servidor. Consulte la documentación de la aplicación del servidor 

para ver cuáles son los tipos de este formato. En el ejemplo de una hoja de cálculo 

podría ser ’A1’. 

En la tabla siguiente se resume qué componentes pueden ser un elemento de una 

conversación DDE, y a qué atributo se hace referencia durante un evento Poke o 

Request. Si se hace referencia a cualquier otro tipo de componente, la operación se 

pasa 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 


Cliente DDE 


SETATR 


sí 

GETATR sí 


La 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, el 

elemento será el nombre del componente al que se hace referencia. Se 

especifica del modo siguiente: 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'DDE1': 'Item') = 'A1' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'DDE1' SETATR 'A1' 'ITEM' 

* 


ItemCount 

Devuelve el número de elementos que hay en la lista de valores de una columna 

de subarchivo. Primero ha de establecerse el atributo ColNumber a fin de 

identificar la columna con la que se debe trabajar. El tipo de validación de la 

columna de subarchivo debe ser Values. 



Subarchivo 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL ItCnt = %getatr('win01': 'SF1': 'ItemCount') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SF1' GETATR 'ITEMCOUNT' ITCNT 

* 


ItemKey 

Devuelve el valor de clave de un elemento de la lista. El atributo Index debe estar 

establecido para indicar a qué elemento se hace referencia. 

Nota: Si no hay definida ninguna clave, ItemKey devolverá una serie nula. 

Tipo Serie 


Recuadro de 

combinación 



SETATR 


no 

GETATR sí 

Nota: El atributo ItemKey de recuadro de combinación puede establecerse 

utilizando el cuaderno de propiedades. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL keyitem = %getatr('win01': 'LB1': 'ItemKey') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'LB1' GETATR 'ITEMKEY' keyitem 

* 


Label 

La serie de texto que está asociada con un componente, como por ejemplo el texto 

que aparece en un pulsador. 

El atributo label puede tener uno de los formatos siguientes: 

v Una serie tecleada 

v Una etiqueta de sustitución 

v Un identificador de mensaje del archivo de mensajes 

Si el título de una columna del contenedor tiene blancos, el contenedor no se 

visualizará correctamente. Para corregir esto, sustituya todos los espacios en blanco 

del título por el carácter de subrayado ( _ ). 

Windows visualiza la barra de título aunque se haya inhabilitado la misma en el 

cuaderno de propiedades. Cuando el valor de Barra de título es de no 

seleccionado, el usuario todavía puede desplazar la ventana utilizando el ratón en 

el área de la barra de título, pero tiene que cerrar la ventana utilizando el teclado. 

Tipo Serie 


Recuadro de selección Contenedor Recuadro de grupo Opción de menú 

Pulsador Botón de selección Texto estático Ventana 


SETATR* 


sí 

GETATR sí 


diseñador GUI. Para ello, utilice la página General y especifique un 

valor en el campo Etiqueta o Título. 


La etiqueta del componente 



Cambiar la etiqueta de un pulsador: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL checked = %getatr('win01': 'CB1': 'Checked') 

C checked IFEQ 0 

C 

* 

EVAL %setatr('win01': 'PB1': 'Label') = 'No' 

C ELSE 

C EVAL %setatr('win01': 'PB1': 'Label') = 'Yes' 

C 

* 

ENDIF 


Cambiar el texto de un pulsador: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'PB1' GETATR 'LABEL' OldText 2 0 

C 'PB1' SETATR 'Cancel' 'LABEL' 

* 


LabelPlace 

Indica 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. 



Gráfica 


SETATR 


sí 

GETATR sí 


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 del 

elemento es positivo, y por debajo si es negativo. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('Win1': 'Gra1': 'LabelPlace') = 2 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'Gra1' SETATR 2 'LABELPLACE' 

* 


| 

| 

| 

| 

| 

| 

| 

Left 

Especifica la coordenada, en pixels, desde el borde izquierdo del objeto o pantalla 

que contiene este componente. 



ActiveX Control de animación Calendario Lienzo 


Referencia a 

Contenedor 

combinación 


Cliente DDE Campo de entrada Gráfica Pulsador gráfico 



horizontal 


Recuadro de lista Medios Panel de medios Edición de múltiples 

líneas 

Cuaderno Interfaz ODBC/JDBC Recuadro de contorno Barra de progreso 



Ventana 



vertical 


SETATR* 


sí 

GETATR sí 






Mover un componente a la izquierda en su ventana: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL leftside = %getatr('win01': 'image1': 'Left') 

C EVAL %setatr('window': 'part': 'Left') = 

leftside - 120 

* 


Mover un pulsador 200 pixels a la derecha: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'PB01' GETATR 'LEFT' OldLeft 2 0 

C OldLeft ADD 200 NewLeft 2 0 

C 

* 

'PB01' SETATR NewLeft 'LEFT' 


LegendType 

Indica el tipo de leyenda utilizada en el componente gráfica. 



Gráfica 


SETATR 


sí 

GETATR sí 


El valor debe ser uno de los siguientes: 

0 Sin leyenda 

1 Sólo puntos 

2 Sólo grupos 

3 Todos los elementos 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('Win1': 'Gra': 'LegendType') = 2 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'Gra1' SETATR 2 'LegendType' 

* 


Length 


Especifica la longitud del archivo en milisegundos. 



Medios 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL Len = %getatr('win01': 'AUD01': 'Length') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'AUD01' GETATR 'LENGTH' Len 6 0 

* 


LineNumber 

Determina en que línea insertará el atributo InsertLine una nueva línea en un 

campo de edición de múltiples líneas. Este valor debe ser superior a cero e inferior 

o igual al atributo NbrOfLines actual. Si es mayor que el atributo NbrOfLines 

actual, la nueva línea se insertará después de la última. 




líneas 


SETATR 


sí 

GETATR sí 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL oldline = %getatr('win01': 'MLE01': 'LineNumber') 

C EVAL %setatr('win01': 'MLE01': 'LineNumber') = 5 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE01' GETATR 'LINENUMBER' OldLine 2 0 

C 

* 

'MLE01' SETATR 5 'LINENUMBER' 


LineText 

Recupera el texto de una línea de edición de múltiples líneas especificada por 

LineNumber. 

Tipo Serie 



líneas 


SETATR 


no 

GETATR sí 


El texto de la línea 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL lines = %getatr('win01': 'MLE1': 'NbrOfLines') 

C Do lines ix 

C EVAL %setatr('win01': 'MLE1': 'LineNumber') = ix 

C EVAL nextline= %getatr('win01': 'MLE1': 'LineText') 

C ... 

C 

* 

EndDo 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' GETATR 'LINETEXT' line 

* 


LookNFeel 

*Restricción: Este atributo es sólo de Java. 

Permite que las aplicaciones Java utilicen el mecanismo PLAF (Pluggable Look and 

Feel) de Swing para controlar el aspecto y la funcionalidad de la interfaz gráfica de 

usuario. 

Tipo Serie 


*Component 


SETATR 


sí 

GETATR no 


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 

Windows 

com.sun.java.swing.plaf.windows.WindowsLookAndFeel 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C eval %setatr('*component':'*component': 

C 'LookNFeel')= 

C 'com.sun.java.swing.plaf.motif.' + 

C 

* 

'MotifLookAndFeel' 


Magnify 

Especifica el valor, en forma de porcentaje, del graduador de ampliación en el 

componente imagen, que controla la escala de la imagen visualizada. El valor cero 

hará que la escala de la imagen se ajuste al componente imagen. 



Imagen 


SETATR 


sí 

GETATR sí 


El valor del graduador de ampliación puede ser uno de los siguientes: 

0 

25 - 200 

Ajustar a escala 

El valor de ampliación en forma de porcentaje 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win1': 'Img1': 'Magnify') = 50 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'IMG1' SETATR 50 'MAGNIFY' 

* 


Masked 

Cuando se establece este atributo, al escribir en el campo de entrada se 

visualizarán caracteres asteriscos (*) en lugar de los caracteres que se están 

escribiendo. Este atributo se utiliza muy a menudo cuando el usuario va a escribir 

datos confidenciales, tales como una contraseña o un número de cuenta. 





SETATR* 


no 

GETATR sí 




El estado de protección de contraseña del campo puede ser uno de los 

siguientes: 

0 El campo no está enmascarado 

1 El campo está enmascarado 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL isMasked = %getatr('win01': 'EF1': 'Masked') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'EF1' GETATR 'MASKED' isMasked 1 0 

* 


Maximum 

Determina 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. 



Graduador Selector cíclico 


SETATR 


sí 

GETATR sí 


Valor máximo del componente 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL oldmax=%getatr('window':'SLIDER01':'Maximum') 

C 

* 

EVAL %setatr('window':'SLIDER01':'Maximum')=100 


Cambiar el valor máximo de un graduador: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SLIDER01' GETATR 'MAXIMUM' OldMax 3 0 

C 'SLIDER01' SETATR 100 'MAXIMUM' 

* 


Method 

Especifica el nombre del método ActiveX que se ha de invocar, junto con los 

valores que se han de pasar al método. Los componentes ActiveX se controlan 

estableciendo 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ñador 

GUI o una aplicación VARPG. Téngalo presente, ya que parecerá que la aplicación 

o 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étodo 

y propiedad son numérico (es decir, entero y flotante) y serie (char*). 

Los tipos de datos Font, Color, UserDefined, PTR (puntero) no están 

soportados. 

Tipo Serie 


ActiveX 


SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'AX1':'Method')='PN1' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'AX1' SETATR 'PN1' 'METHOD' 

* 

Ejemplo de Method 

En el ejemplo siguiente, se invoca el método DisplayText de un componente 

ActiveX 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' 


MiniIcon 

Este atributo determina la forma de presentar los iconos del componente 

contenedor. Si se establece, los iconos aparecen en el componente contenedor en 

forma de miniiconos. Si no se establece, los iconos aparecen en su forma normal. 



Contenedor 


SETATR* 


sí 

GETATR sí 




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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'Cont1': 'Miniicon') = 0 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'Cont1' SETATR 0 'MINIICON' 

* 


Minimum 

Determina 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. 





SETATR 


sí 

GETATR sí 


Valor mínimo del componente 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL oldmin = %getatr('window': 'SLIDER01': 'Minimum') 

C 

* 

EVAL %setatr('window': 'part': 'Minimum') = 0 


Cambiar el valor mínimo de un graduador:: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SLIDER01' GETATR 'MINIMUM' OldMin 3 0 

C 'SLIDER01' SETATR 0 'MINIMUM' 

* 


Mode 

Determina si se reproduce o no el archivo de vídeo o GIF. 





SETATR 


sí 

GETATR no 


El valor de Mode puede ser uno de los siguientes: 

1 Empezar a reproducir el archivo 

2 Parar de reproducir el archivo 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'WIN1': 'Mode') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'WIN1' SETATR 1 'MODE' 

* 


Month 

Indica el mes seleccionado actualmente. Si se establece, se actualizará la fecha 

seleccionada en el componente calendario para que los cambios queden reflejados. 



Calendario 


SETATR* 


sí 

GETATR sí 




El mes 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CAL1': 'Month') = 02 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' SETATR 02 'Month' 

* 


MonthArrow 

Indica si las flechas de mes (< o >) o de año (>) están disponibles para que 

los usuarios puedan avanzar o retroceder por los meses o los años. Si no hay 

ninguna flecha, el usuario no tiene forma de cambiar el mes o el año visualizado 

actualmente. 



Calendario 


SETATR 


sí 

GETATR sí 


El valor de MonthArrow puede ser uno de los siguientes: 

0 No se mostrarán las flechas 

1 Se mostrarán las flechas 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL isshown = %getatr('win01': 'CAL1': 'MonthArrow') 

C 

* 

EVAL %setatr('win01': 'CAL1': 'MonthArrow') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' GETATR 'MONTHARROW' isshown 

* 


MonthIdx 





Calendario 


SETATR 


sí 

GETATR sí 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CAL1': 'MonthIdx') = 2 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' SETATR 2 'MonthIdx' 

* 


MonthLen 

Indica el formato de visualización del nombre del mes. 



Calendario 


SETATR* 


sí 

GETATR sí 




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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'CAL1': 'MonthLen') = 3 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' GETATR 'MONTHLEN' MonthLen 1 0 

* 


MouseIcon 


Especifica el nombre del archivo de iconos que se utilizará para la forma del 

puntero del ratón. Antes de utilizar este atributo, debe establecer el valor de 

MouseShape en 99. 

El archivo puede ser de cursor (.CUR) o de icono (.ICO o .ANI). 

Tipo Serie 


Ventana 


SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'WIN1':'MouseIcon')=Myicon 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'WIN1' SETATR MYICON 'MOUSEICON' 

* 


MouseShape 

Cambia la forma del puntero del ratón cuando el puntero está situado en el marco 

de la ventana del componente padre o de sus hijos. 



Ventana 


SETATR 


sí 

GETATR no 


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 atributo 

MouseIcon. (Este valor sólo se utiliza en las aplicaciones de 

Windows.) 


El atributo MouseShape no es permanente; sólo se aplica al marco de la 

ventana. Si modifica la forma por omisión del puntero del ratón, debe 

restablecer este atributo en 0 para utilizar la forma por omisión del 

puntero. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('Win1': 'Win1': 'MouseShape') = 2 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'Win1' SETATR 2 'MOUSESHAPE' 

* 


MsgData 

Especifica el texto de sustitución para las variables que aparezcan en el texto del 

mensaje. Si hay varias variables, utilice un espacio para delimitar cada texto de 

sustitución. Utilice el carácter de subrayado ( _ ) para incluir espacios en blanco 

en el texto de sustitución. Por ejemplo, para utilizar ″A BC″ y ″CustNo″ en las 

variables %1 y %2 de un mensaje respectivamente, especifique los datos del 

mensaje del modo siguiente: 

'A_B_C CustNo' 

Tipo Serie 




SETATR 


sí 

GETATR no 


La serie de sustitución de la variable de mensaje 


Obtener el texto del mensaje 0001 y utilizar CustNo para la sustitución: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('*Component':'*Component':'MsgID')=0001 

C EVAL %setatr('*Component':'*Component':'MsgData')=CustNo 

C EVAL text = %getatr('*Component':'*Component':'MsgText') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*COMPONENT' SETATR 0001 'MSGID' 

C '*COMPONENT' SETATR CustNo 'MSGDATA' 

C 

* 

'*COMPONENT' GETATR 'MSGTEXT' text 


MsgFile 


Especifica el archivo de mensajes por omisión que se utilizará cuando no se 

encuentre un identificador de mensaje en el archivo de mensajes del componente 

lógico. 

Tipo Serie 




SETATR 


sí 

GETATR sí 


Nombre completo del archivo de mensajes por omisión (archivo.txm). Se 

utiliza la vía de acceso actual para la búsqueda de archivos. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('*Component':'*Component':'MsgFile') 

C = Fn 

C EVAL Mf = %getatr('*Component':'*Component': 

C 

* 

'MsgFile') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'*COMPONENT' SETATR Fn 'MSGFILE' 

C 

* 

'*COMPONENT' GETATR 'MSGFILE' Mf 


MsgID 

Especifica el número de mensaje en el archivo de mensajes del componente lógico. 





SETATR 


sí 

GETATR no 


El número de mensaje 


Obtener el texto del mensaje 0001 y utilizar CusNo para la sustitución: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 


C EVAL %setatr('*Component':'*Component':'MsgData')=CusNo 

C EVAL text=%getatr('*Component':'*Component':'MsgText') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*COMPONENT' SETATR 0001 'MSGID' 

C '*COMPONENT' SETATR CusNo 'MSGDATA' 

C 

* 



MsgSubText 

Define el texto de sustitución del mensaje para un componente subarchivo de 

mensajes. Este atributo debe estar establecido antes de añadir un mensaje a un 

componente subarchivo de mensajes mediante el atributo AddMsgID o 

AddMsgText. Se hace referencia al texto de sustitución de mensaje cuando un 

mensaje tiene variables de sustitución en el texto del mensaje. Las variables de 

sustitución de mensaje se identifican mediante un símbolo ’%’ seguido por un 

valor numérico. Cada variable de sustitución de mensaje se sustituye por la 

palabra correspondiente delimitada por blancos en el atributo MsgSubText antes 

de añadir el mensaje al componente subarchivo de mensajes. La serie de 

sustitución del mensaje permanece vigente hasta que se establece otro atributo 

MsgSubText. 

Tipo Serie 


Subarchivo de 

mensajes 


SETATR 


sí 

GETATR no 


El texto de sustitución de mensaje 


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....+....8 


* 

C EVAL %setatr('win01':'MSG1':'MsgSubText')='Yes No' 

C EVAL %setatr('win01':'MSG1':'AddMsgID')=1000 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MSG1' SETATR 'Yes No' 'MSGSUBTEXT' 

C 

* 

'MSG1' SETATR 1000 'ADDMSGID' 


MsgText 

Devuelve el texto del mensaje del archivo de mensajes del componente lógico para 

el identificador de mensaje especificado. 

Tipo Serie 




SETATR 


no 

GETATR sí 


Obtener el texto del mensaje 0001: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 


C EVAL text=%getatr('*Component':'*Component':'MsgText') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*COMPONENT' SETATR 'MSGID' 0001 

C 

* 



Multiplier 

Determina la cantidad de intervalos del temporizador que deben transcurrir antes 

de que el temporizador cause un evento Tick. 

El valor máximo del multiplicador es 65535. 

El valor mínimo del multiplicador es 1. 



Temporizador 


SETATR* 


sí 

GETATR no 




El valor del multiplicador 


Si se ha establecido el atributo Interval en 1000 milisegundos, el 

temporizador generará un evento Tick cada tres segundos: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'TIMER01': 'Multiplier') = 3 

* 


Cambiar el atributo Multiplier de un temporizador: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'TIMER01' SETATR 3 'MULTIPLIER' 

* 


MultSelect 

Determina si puede haber más de un elemento seleccionado en la parte de lista de 

un componente. Cuando no se ha establecido este atributo, al seleccionar un 

elemento se deselecciona cualquier elemento seleccionado actualmente. 

Este atributo debe estar establecido para que el recuadro de lista permita la 

selección ampliada proporcionada por el atributo ExtSelect. 

El atributo MultSelect no tiene ningún efecto en el atributo ExtSelect. El atributo 

ExtSelect prevalece sobre los valores para MultSelect o para una única selección. 



Recuadro de lista Subarchivo 


SETATR 


no 

GETATR sí 


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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 


EVAL rc = %getatr('win01': 'LB1': 'MultSelect') 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'LB1' GETATR 'MULTSELECT' rc 1 0 


Name 

Devuelve el nombre del componente lógico. 

Tipo Serie 




SETATR 


no 

GETATR sí 


Obtener el nombre del componente lógico: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL appname=%getatr('*Component':'*Component':'Name') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*COMPONENT' GETATR 'NAME' appname 

* 


NbrOfImage 

*Restricción: Este atributo es sólo de Java. 

Establece el número de imágenes que se reproducen en una secuencia de 

animación GIF. Utilice este atributo junto con los atributos FileName y Mode. 

Por ejemplo, para reproducir un archivo base Archivo.GIF como una secuencia de 

10 imágenes, debe establecer FileName en Archivo.GIF, NbrOfImage en 10 y 

Mode en 1. También, puede reproducir varias imágenes GIF distintas, como 

Archivo1.GIF, Archivo2.GIF, ... Archivo10.GIF. 





SETATR 


sí 

GETATR no 


El número de imágenes que se reproducen. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'WIN1':'NbrOfImage')=10 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'WIN1' SETATR 1 'NBROFIMAGE' 

* 


NbrOfLines 

Devuelve 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. 




líneas 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL NumL = %getatr('win01': 'MLE1': 'NbrOfLines') 

* 


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....+....8 


* 

C 'MLE1' GETATR 'NBROFLINES' NumL 2 0 

* 


NbrOfSel 

Devuelve el número de elementos seleccionados en la parte de lista de un 

componente. 

Si no hay ningún elemento seleccionado actualmente, se devuelve el valor cero. 




mensajes 


Subarchivo 

SETATR 


no 

GETATR sí 


Obtener el número de elementos seleccionados en un recuadro de lista: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL num=%getatr('win01':'LB1':'NbrOfSel') 

C num IFEQ *ZERO 

C EVAL %setatr('win01':'MSG1':'AddMsgText')='None' 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'LB1' GETATR 'NBROFSEL' NbrSelected 2 0 

* 


NextLine 

Si este atributo se establece en 1, el graduador de la barra de desplazamiento se 

traslada a una posición que representa la siguiente línea dentro de una lista de 

elementos. El movimiento descrito por el graduador es relativo al atributo Range 

establecido para el componente barra de desplazamiento. 

Por ejemplo, supongamos que tiene un componente subarchivo y desea indicar 

dónde se halla un usuario dentro de un conjunto de registros cuando se pulsa una 

tecla de movimiento del cursor o de mandato. El componente barra de 

desplazamiento conectado a un subarchivo indica únicamente dónde se encuentra 

el usuario tomando como base el número de registros que hay actualmente en el 

subarchivo. Al capturar el evento VKeyPress, se puede establecer el atributo de 

graduador 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 elementos 

visualizados. El atributo Range determina el límite superior correspondiente al 

número de elementos por los que se pasará al realizar el desplazamiento. 



Barra de 


horizontal 


Barra de 


vertical 

SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'VSC1':'NextLine')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'VSC1' SETATR 1 'NEXTLINE' 

* 


NextPage 


traslada a una posición que representa la siguiente página dentro de una lista de 
















Barra de 


horizontal 


Barra de 


vertical 

SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'VSC1':'NextPage')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'VSC1' SETATR 1 'NEXTPAGE' 

* 


NotSrcEvt 

Utilice este atributo, junto con los atributos NotSrcPart y NotSrcWin, para que el 

componente referencia a componente lógico supervise la aparición de un evento 

específico en un componente determinado de una ventana en particular de otro 

componente lógico. Este atributo se utiliza para identificar el evento que desea. 

Utilice NotSrcPart y NotSrcWin para especificar el componente y la ventana 

determinados que desea supervisar para la aparición de ese evento. 

Tipo Serie 


Referencia a 



SETATR* 


sí 

GETATR sí 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL event = %getatr('win01': 'CR1': 'NotSrcEvt') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CR1' GETATR 'NOTSRCEVT' event 

* 


NotSrcPart 

Utilice este atributo, junto con los atributos NotSrcEvt y NotSrcWin, para que el 



componente lógico. Este atributo se utiliza para identificar el componente que 

desea. Utilice NotSrcEvt y NotSrcWin para especificar el evento que desea 

supervisar para ese componente y la ventana en la que se encuentra el 

componente. 

Tipo Serie 


Referencia a 



SETATR* 


sí 

GETATR sí 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL PartN = %getatr('win1': 'CR1': 'NotSrPart') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CR1' GETATR 'NOTSRCPART' PartN 

* 


NotSrcWin 

Utilice este atributo, junto con los atributos NotSrcEvt y NotSrcPart, para que el 



componente lógico. Este atributo se utiliza para identificar la ventana que desea. 

Utilice NotSrcPart y NotSrcEvt para especificar el componente y el evento que 

desea supervisar en dicha ventana. 

Tipo Serie 


Referencia a 



SETATR* 


sí 

GETATR sí 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL WinNam = %getatr('win1': 'CR1': 'NotSrcWin') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CR1' GETATR 'NotSrcWin' WinNam 

* 


OCXProp 

Determina el nombre de la propiedad. Este nombre se utiliza para determinar el 

valor de propiedad con el atributo OCXValue. 

Tipo Serie 


ActiveX 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'AX1':'OCXProp')='PN1' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'AX1' SETATR 'PN1' 'OCXPROP' 

* 


OCXValue 

Determina el valor de la propiedad según proporciona el atributo OCXProp. 

Tipo Serie 


ActiveX 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'AX1':'OCXValue')='VL1' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'AX1' SETATR 'VL1' 'OCXVALUE' 

* 


OpenEdit 

Determina 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 del 

subarchivo abierto en este momento para su edición. Por consiguiente, no es 

necesario establecer primero los atributos ColNumber e Index antes de obtener 

este atributo. 

Cuando el atributo OpenEdit está establecido en 0, se cierran todos los campos 

abiertos actualmente para edición. Los atributos ColNumber e Index se pasan por 

alto. 



Subarchivo 


SETATR 


sí 

GETATR sí 


OpenEdit puede tener uno de los siguientes valores: 

0 El campo no se puede editar 

1 El campo se puede editar 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL isopen = %getatr('win01': 'SF1': 'OpenEdit') 

C 

* 

EVAL %setatr('win01': 'SF1': 'OpenEdit') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SF1' GETATR 'OPENEDIT' isopen 

* 


OS 

Devuelve el nombre del sistema operativo. 

Tipo Serie 




SETATR 


no 

GETATR sí 


Sistema operativo WINDOWS: Windows NT, Windows 95 o Windows 98 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL ostring=%getatr('*Component':'*Component':'Os') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*COMPONENT' GETATR 'OS' ostring 

* 


OutlineRcl 

Indica si hay o no un rectángulo bordeando la fecha YearIdx/MonthIdx/DayIdx. 



Calendario 


SETATR 


sí 

GETATR sí 


OutlineRcl puede tener uno de los siguientes valores: 

0 No hay ningún rectángulo 

1 Hay un rectángulo 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'CAL1': 'OutlineRcl') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' SETATR 1 'OUTLINERCL' 

* 


PageNumber 

Determina qué número de página está seleccionado actualmente. 



Cuaderno 


SETATR 


sí 

GETATR sí 


El número de página seleccionado actualmente 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'NB1': 'PageNumber') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'NB1' SETATR 1 'PAGENUMBER' 

* 


PageSize 

Para un componente subarchivo, indica el número de filas de datos visibles. Este 

atributo es útil si desea efectuar el proceso página a página. 

Para un componente barra de desplazamiento horizontal o vertical, determina el 

tamaño de página visible. El valor de PageSize no puede sobrepasar el valor de 

Range. 



Barra de 


horizontal 

Barra de 


vertical 

Subarchivo* 


para el componente subarchivo. 


SETATR 


sí 

GETATR sí 


Para un componente barra de desplazamiento horizontal o vertical, el valor 

de PageSize puede estar entre 1 y 32.767. No puede sobrepasar el valor de 

Range. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL PS = %getatr('win01':'SFL1':'PageSize') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SFL1' GETATR 'PAGESIZE' PS 

* 


Panel 


En el componente imagen, panel determina si el componente tiene un panel de 

ampliación asociado. El panel de ampliación contiene dos controles que permiten 

la manipulación de la imagen: 

Recuadro de selección Ajustar escala 

Cuando este recuadro de selección no está marcado, la imagen se ajusta 

proporcionalmente para encajar en el componente imagen. Cuando está 

marcado, se habilita el graduador de ampliación. 

Graduador de ampliación 

Cuando está habilitado, este graduador ajusta la ampliación de la imagen entre 

un 25% y un 200% de su tamaño original. 

En el componente medios, panel se utiliza para mostrar un panel de medios para 

reproducir archivos. 



Imagen Medios 


SETATR 


sí 

GETATR sí 




0 No se conecta el panel de ampliación o se oculta el panel de 

reproducción. 

1 Se conecta el panel de ampliación o se muestra el panel de 

reproducción. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL oldval = %getatr('window': 'MMP1': 'Panel') 

C 

* 

EVAL %setatr('window': 'MMP1': 'Panel') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MMP1' GETATR 'PANEL' OldVal 1 0 

C 

* 

'MMP1' SETATR 1 'PANEL' 


PanelItem 

Devuelve un valor que indica el último botón que se ha cambiado en un panel de 

medios. Un botón se puede cambiar pulsando sobre el mismo con el ratón o 

estableciendo el atributo PanelMode. Puede establecer la verificación de este 

atributo 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 el 

atributo PanelItem de la subrutina de acción Press para determinar la función que 

debe llevarse a cabo. 





SETATR 


no 

GETATR sí 


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 



*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL button = %getatr('win01': 'MMP1': 'PanelItem') 

* 

C button CASEQ 2 PLAY 

C button CASEQ 3 RECORD 

C ... 

C ENDCS 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'MMP1' GETATR 'PANELITEM' button 2 0 

C button CASEQ 2 PLAY 

C button CASEQ 3 RECORD 

C ... 

C 

* 

ENDCS 


PanelMode 

Establece la modalidad operativa para el componente panel de medios. 





SETATR 


sí 

GETATR no 


La modalidad operativa de un componente panel de medios puede ser: 


2 Play (Reproducir) 

3 Grabar 



*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'MMP1': 'PanelMode') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MMP1' SETATR 1 'PANELMODE' 

* 


Parent 

Establece el componente padre cuya lista de hijos ha de recuperarse mediante el 

atributo PartList. Se devolverá la lista de hijos inmediatos. Para obtener la lista de 

ventanas de un componente lógico, establezca el atributo Parent con el nombre 

reservado *component. 

Nota: Este atributo debe establecerse antes de utilizar PartCount o PartList. 

Tipo Serie 




SETATR 


sí 

GETATR sí 


El formato del nombre de componente padre es: 

PARENTNAME|PARTNAME 


ParentName es el nombre del componente ventana propietario de 

PartName. Si desea obtener una lista de los componentes de una ventana, 

utilice el nombre del componente lienzo como nombre del componente 

padre.


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('*component':'*component':'Parent') 

C = 'WIN1|CANVS1' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

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ódigo 

muestra cómo hacerlo. (La variable WinName contiene el nombre de la ventana 

padre). 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

* 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 EVAL 

Canvas=%getatr('*component':'*component':'PartList') 

Consulte la descripción de PartList para obtener información sobre los valores 

devueltos por este atributo. 


ParentId 

Devuelve el ID del registro padre de un registro de un contenedor. Antes de 

utilizar este atributo, establezca el atributo RecordID en el ID del registro cuyo ID 

de padre desea determinar. 

Tipo Serie 


Contenedor 


SETATR 


no 

GETATR sí 


En el ejemplo siguiente, se supone que se ha seleccionado un registro. Se 

determinará cuál es el ID del registro padre del registro seleccionado. 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


CSRN01Factor1+++++++Opcode(E)+Extended-factor2+++++++++++++++++++++++++---- 

* Establecer el ID del registro seleccionado 

C EVAL %setatr('Main':'CT1':'RecordID')= 

C %getatr('Main':'CT1':'FirstSel') 

* Obtener el ID del registro padre del registro seleccionado 

C EVAL Parent=%getatr('Main':'CT1':'ParentId') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CT1' GETATR 'FIRSTSEL' ID 4 0 

C 'CT1' SETATR ID 'RECORDID' 

C 

* 

'CT1' GETATR 'PARENTID' PARENT 4 0 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

ParentList 

Devuelve 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 registro 

actual. 

Tipo Serie 


Contenedor 


SETATR 


no 

GETATR sí 


En el ejemplo siguiente, se supone que se ha seleccionado un registro. Se 

determinará cuál es el ID de registro del registro seleccionado. 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


CSRN01Factor1+++++++Opcode(E)+Extended-factor2+++++++++++++++++++++++++---- 

* Establecer el ID del registro seleccionado 

C EVAL %setatr('Main':'CT1':'RecordID')= 

C %getatr('Main':'CT1':'FirstSel') 

* Obtener la lista de los ID de padre del registro seleccionado 

C EVAL ParentL=%getatr('Main':'CT1':'ParentList') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CT1' GETATR 'FIRSTSEL' ID 4 0 

C 'CT1' SETATR ID 'RECORDID' 

C 

* 

'CT1' GETATR 'PARENTLIST' PARENTL 4 0 


ParentName 

Devuelve el nombre del componente que contiene el componente al que el 

parámetro part hace referencia. En el caso de los componentes que están en una 

ventana, se devuelve el nombre de ésta. Cuando utilice este atributo para un 

componente ventana, se devolverá el nombre del componente ventana. 

Tipo Serie 


Todos los componentes excepto el componente *component 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL PName = %getatr('win01': 'EF1': 'ParentName') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'EF1' GETATR 'PARENTNAME' PName 1 0 

* 


PartCount 

Devuelve el número de hijos del componente padre establecido por el atributo 

Parent. 



*Componente lógico Bean Java 


SETATR 


no 

GETATR sí 


El número de hijos del componente padre especificado. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL Numchild=%getatr('*component':'*component': 

C 'PartCount') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' GETATR 'PARTCOUNT' Numchild 

* 


PartList 

Devuelve una lista de los componentes hijo del componente padre que ha 

establecido el atributo Parent. 

Tipo Serie 




SETATR 


no 

GETATR sí 


El formato de la serie es una serie continua de nombres de componente. El 

nombre de cada uno de los componentes es una serie fija de 10 caracteres 

de longitud. Si una parte del nombre de componente tiene menos de 10 

caracteres, el nombre se rellena por la derecha con espacios en blanco. 

FRAMEbbbbbCANVASbbbbENTRYFIELD 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL list = %getatr('*component': '*component': 

C 

* 

'PartList') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' GETATR 'PARTLIST' list 

* 


PartName 

Devuelve el nombre del componente. Es el nombre que se asignó al componente 

cuando 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 de 

resultado justificado por la izquierda. Si el campo de resultado tiene menos de 10 

caracteres, el valor del nombre se truncará. Si tiene más de 10 caracteres, el campo 

se rellena con espacios en blanco. 

Tipo Serie 




SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL ctlname = %getatr('win01': 'MLE1': 'PartName') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' GETATR 'PARTNAME' ctlname 10 

* 


PartType 

Devuelve el tipo del componente. El valor devuelto para un componente VARPG 

tiene como prefijo los caracteres FVDES. Por ejemplo, el valor devuelto para un 

componente campo de entrada es FVDESEntryField. 

Nota: Para un componente referencia a componente lógico, el valor devuelto tiene 

como prefijo los caracteres FVDESV. 

Tipo Serie 




SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL Type = %getatr('win01': 'MLE1': 'PartType') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' GETATR 'PARTTYPE' Type 50 

* 


Paste 

Pega el texto del portapapeles en la posición del cursor. Si hay un texto 

seleccionado, se sustituirá por el texto del portapapeles. 




líneas 


SETATR 


sí 

GETATR no 


El valor permitido es 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'MLE1': 'Paste') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' SETATR 1 'paste' 

* 


PBRange 

Determina 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, puede 

interesarle establecer el rango superior en 1.000 para este proceso. 



Barra de progreso Ventana 


SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

* Establecer el rango de una barra de progreso conectada a una ventana 

C EVAL %setatr('win01':'WIN1':'PBRange')=1000 

* Establecer el rango de un componente barra de progreso 

C EVAL %setatr('win01':'PBar1':'PBRange')=1000 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

* Establecer el rango de una barra de progreso conectada a una ventana 

C 'WIN1' SETATR 1000 'PBRANGE' 

* Establecer el rango de un componente barra de progreso 

C 'PBAR1' SETATR 1000 'PBRANGE' 


PBSetPos 

Mueve el indicador de barra de progreso a la posición absoluta especificada. Este 

valor depende de cómo se ha establecido el valor del atributo PBRange. 





SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'WIN1':'PBSetPos')=50 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'WIN1' SETATR 50 'PBSETPOS' 

* 


PBStep 

Establezca este atributo en 1 para mover el indicador de barra de progreso el 

número de unidades de pasos definido en el valor de PBStepSize. 





SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'WIN1':'PBStep')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'WIN1' SETATR 1 'PBSTEP' 

* 


PBStepSize 

Determina la posición máxima a la que se mueve el indicador de barra de progreso 

cuando el atributo PBStep está activado. El valor por omisión es 10. 





SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'WIN1':'PBStepSize')=10 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'WIN1' SETATR 10 'PBSTEPSIZE' 

* 


Platform 

Devuelve el nombre de la plataforma en la que se está ejecutando la aplicación. 

Tipo Serie 




SETATR 


no 

GETATR sí 



WINDOWS 

Windows 

JAVA Java 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL app1=%getatr('*Component':'*Component':'Platform') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*COMPONENT' GETATR 'PLATFORM' APP1 

* 


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. Los 

atributos PlugDLL y PlugID deben estar establecidos antes de utilizar PlugCmd. 

Tipo Serie 


*Component 


SETATR 


sí 

GETATR no 


El mandato de conector 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('*component': '*component': 'PlugCmd') 

C = cmdstring 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' SETATR cmdstring 'PLUGCMD' 

* 


PlugDLL 




Establece el nombre de la DLL del conector. Los atributos PlugDLL y PlugID 

deben estar establecidos antes de utilizar PlugCmd. 

Tipo Serie 


*Component 


SETATR 


sí 

GETATR no 


Nombre de la DLL del conector 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('*component': '*component': 'PlugDLL') 

C = PlugDLL 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' SETATR DLLname 'PLUGDLL' 

* 


PlugID 




Establece el ID del Diseñador GUI que se pasa al conector. Los atributos PlugDLL 

y PlugID deben estar establecidos antes de utilizar PlugCmd. 

Tipo Serie 


*Component 


SETATR 


sí 

GETATR no 


ID del Diseñador GUI 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('*component': '*component': 'PlugID') 

C = idname 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' SETATR idname 'PLUGID' 

* 


PlugRC 




Obtiene el código de retorno del último mandato del conector. 



*Component 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL code = %getatr('*component': '*component': 

C 

* 

'PlugRC') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' GETATR 'PLUGRC' code 2 0 

* 


PlugResult 




Obtiene la serie del resultado del último mandato del conector. 

Tipo Serie 


*Component 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL Result = %getatr('*component': '*component': 

C 

* 

'PlugResult') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' GETATR 'PLUGRESULT' Result 

* 


Poke 

Envía datos a la aplicación del servidor. Para transferir datos a una aplicación del 

servidor, debe haberse iniciado satisfactoriamente una conversación DDE para el 

componente DDE. Asimismo, debe haberse establecido el atributo DDEItem para 

indicar el elemento del servidor que recibirá los datos transferidos. 

Cuando la aplicación del servidor procese la solicitud Poke, responderá con un 

evento PokeAck. Debe comprobar el atributo %PokeAck en la subrutina de acción 

PokeAck para determinar si la operación Poke se ha completado de manera 

satisfactoria o no. 

Tipo Serie 


Cliente DDE 


SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'DDE1': 'DDEItem') = 'A1' 

C 

* 

EVAL %setatr('win01': 'DDE1': 'Poke') = '456.78' 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'DDE1' SETATR '123' 'POKE' 

* 


Position 

El valor devuelto para este atributo depende del tipo del componente. 

En el caso de un componente medios, devolverá la posición actual del archivo de 

audio. Este valor se proporciona en milisegundos. Si aún no se ha procesado el 

archivo de audio, se devolverá el valor cero. 

Para un componente panel de medios, devolverá la posición del graduador. Este 

valor se sitúa entre 0 y 100. 

Para un componente barra de desplazamiento horizontal o vertical, este atributo 

devolverá la posición del recuadro de desplazamiento en función del valor del 

atributo Range. 



Barra de 


horizontal 


Medios Panel de medios Barra de 


vertical 

SETATR 


sí 

GETATR sí 


Para un componente panel de medios, el valor de Position, entre 0 y 100, 

representa un porcentaje. Para un componente barra de desplazamiento 

horizontal o vertical, se trata de un valor absoluto basado en el valor de 

Range. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL oldpos = %getatr('win01': 'MMP1': 'Position') 

* 

C EVAL %setatr('win01': 'MMP1': 'Position') = 5 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'MMP1' GETATR 'POSITION' OldPos 3 0 

C 

* 

'MMP1' SETATR 5 'POSITION' 


PrevLine 


traslada a una posición que representa la línea anterior dentro de una lista de 
















Barra de 


horizontal 


Barra de 


vertical 

SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'VSC1':'PrevLine')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'VSC1' SETATR 1 'PREVLINE' 

* 


PrevPage 


traslada a una posición que representa la página anterior dentro de una lista de 
















Barra de 


horizontal 


Barra de 


vertical 

SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'VSC1':'PrevPage')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'VSC1' SETATR 1 'PREVPAGE' 

* 


Print 

Permite que se imprima la imagen o el área de cliente de la ventana. El valor de 

tipo 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 pueda 

elegir el tipo de impresora. 

Tipo Serie 


Imagen Ventana Ventana con lienzo 


SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'ima2':'Print')='Image2' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'WIN01' SETATR 'IMAGE2' 'PRINT' 

* 


Printer 


Devuelve el nombre de impresora seleccionado en el diálogo de impresora. El 

diálogo de impresora del sistema Windows se visualiza estableciendo el atributo 

SelPrinter. 

Tipo Serie 


*Component 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL prtname = %getatr('*component': '*component': 

C 

* 

'Printer') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' GETATR 'PRINTER' prtname 

* 


ProgresBar 

Añade o elimina una barra de progreso simple en una ventana como una 

extensión. Si hay una ventana de estado, la barra de progreso se colocará en la 

posición opuesta de la ventana. Utilice el componente barra de progreso si necesita 

una barra de progreso más variada. 



Ventana 


SETATR 


sí 

GETATR no 


El valor de ProgresBar puede ser uno de los siguientes: 

1 Crear una barra de progreso 

0 Eliminar una barra de progreso 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01':'WIN1':'ProgresBar')=1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'WIN1' SETATR 1 'PROGRESBAR' 

* 


Range 

Determina 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 una 

lista. Por ejemplo, si el programa visualiza una lista de 100 archivos, puede 

interesarle establecer el rango superior en 100. 


visualizados. 



Barra de 


horizontal 


Barra de 


vertical 

SETATR 


sí 

GETATR sí 


Range puede tener un valor entre 1 y 32.767. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'HScroll1':'Range')=100 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'HSCROLL1' SETATR 100 'RANGE' 

* 


ReadOnly 

Determina 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 de 

entrada. 

Cuando este atributo se aplica al componente lienzo, todos los campos de entrada 

del lienzo heredarán el valor del atributo ReadOnly. 



Lienzo Recuadro de 

combinación 

Edición de múltiples Selector cíclico 

líneas 



SETATR* 


sí 

GETATR sí 

*Nota: Se puede establecer utilizando el cuaderno de propiedades en el 

Diseñador GUI, excepto en el caso de un componente contenedor. 

En el caso de un componente recuadro de combinación, seleccione 

un tipo de Lista desplegable para el estilo del recuadro de 

combinación. Para otros componentes, seleccione el estilo Sólo 

lectura. 


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 



Conmutar el estado de sólo lectura de un campo de entrada: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL rc = %getatr('win01': 'EF1': 'ReadOnly') 

C rc IFEQ 1 

C EVAL %setatr('win01': 'EF1': 'ReadOnly') = 0 

C ELSE 


'EF1': 'ReadOnly') = 1 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'EF1' GETATR 'READONLY' rc 1 0 

C rc IFEQ 1 

C 'EF1' SETATR 0 'READONLY' 

C ELSE 

C 'EF1' SETATR 1 'READONLY' 

C 

* 

ENDIF 


RecordID 

Establece la identificación de un registro de contenedor al que otros atributos 

hacen referencia. Por ejemplo, antes de utilizar el atributo GetRcdFld, debe 

establecer primero el atributo RecordID. 



Contenedor 


SETATR 


sí 

GETATR sí 


El identificador del registro de contenedor 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CN1': 'RecordID') = id 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' SETATR id 'RECORDID' 

* 


RefAttr 

Es el atributo del componente al que se hace referencia en un componente 

referencia a componente lógico. 

Tipo Serie 


Referencia a 



SETATR* 


sí 

GETATR sí 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'COMP1': 'RefAttr') = 'Text' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'COMP1' SETATR 'Text' 'REFATTR' 

* 


RefParent 

Nombre de la ventana padre del componente destino. 

Tipo Serie 


Referencia a 



SETATR* 


sí 

GETATR sí 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'COMP1': 'RefParent') 

C = 'WIN01' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'COMP1' SETATR 'WIN01' 'REFPARENT' 

* 


RefPart 

Nombre del componente situado en el componente lógico destino al que se hace 

referencia. 

Tipo Serie 


Referencia a 



SETATR* 


sí 

GETATR sí 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('window': 'COMP1': 'RefPart') = 'EF01' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'COMP1' SETATR 'EF01' 'REFPART' 

* 


Refresh 

Hace que el componente se dibuje de nuevo. 




Recuadro de 

combinación 


Pulsador gráfico Recuadro de grupo Imagen Recuadro de lista 


líneas 

Cuaderno Interfaz ODBC/JDBC Recuadro de contorno 


Texto estático Ventana 


SETATR 


sí 

GETATR no 


El atributo Refresh sólo puede estar establecido en 1. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'LB1': 'Refresh') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'LB1' SETATR 1 'REFRESH' 

* 


RemoveItem 

Suprime un elemento de una lista. El parámetro index determina el elemento que 

se va a suprimir. Para eliminar todos los elementos de una lista, especifique 0 

como valor de índice. 

En un componente subarchivo, este atributo se aplica a un campo de entrada de 

subarchivo que tenga valores definidos como tipo de validación. Utilice este 

atributo para eliminar valores de la lista de validación del campo de entrada del 

subarchivo. Primero ha de establecer el atributo ColNumber a fin de identificar la 

columna con la que se debe trabajar. 

En el caso de un componente selector cíclico, sólo puede eliminar todos los 

elementos; es decir, el valor de índice debe establecerse en 0 (eliminar todos). No 

está permitido eliminar un elemento específico de un selector cíclico. 



Recuadro de 

combinación 


Recuadro de lista Selector cíclico Subarchivo 

SETATR 


sí 

GETATR no 


El valor de índice del elemento que se va a eliminar 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'LB1': 'RemoveItem') = 3 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'LB1' SETATR 3 'REMOVEITEM' 

* 


RemoveLink 


Elimina el enlace entre este componente y el componente indicado mediante el 

parámetro part. Si el componente no está enlazado actualmente, no se lleva a cabo 

ninguna acción. 

Tipo Serie 





SETATR 


sí 

GETATR no 


Nombre del componente que se va a suprimir 

Debe tener el formato: 


donde ventana es la ventana donde está ubicado el componente y 

componente es el nombre del componente. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'EF1':'RemoveLink')='WIN1|EF1' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'EF1' SETATR 'WIN1|EF1' 'REMOVELINK' 

* 


RemoveMsg 

Elimina un mensaje del componente subarchivo de mensajes. El mensaje a eliminar 

lo determina el parámetro index. Para eliminar todos los mensajes, especifique 0 

como valor de índice. 



Subarchivo de 

mensajes 


SETATR 


sí 

GETATR no 


El número de índice del mensaje que se va a eliminar 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'MSG1': 'RemoveMsg') = 3 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MSG1' SETATR 3 'REMOVEMSG' 

* 


RemoveRcd 

Elimina un registro de un contenedor. Para eliminar todos los registros, especifique 

el valor 0. 



Contenedor 


SETATR 


sí 

GETATR no 


Identificador del registro que se suprimirá 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CN1': 'RemoveRcd') = id 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' SETATR id 'REMOVERCD' 

* 


Request 

Solicita el valor actual de un elemento en una aplicación de servidor. Antes de 

efectuar la solicitud, deben haberse establecido los atributos AppName y Topic y 

debe haberse iniciado la conversación DDE satisfactoriamente. 

Tipo Serie 


Cliente DDE 


SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'DDE1': 'Request') = 'A1' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'DDE1' SETATR 'A1' 'REQUEST' 

* 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

RmvSrcEvt 

Elimina un evento de origen de la lista de eventos que supervisa el componente de 

referencia a componente lógico. Este atributo, junto con el atributo AddSrcEvt, 

permite a un componente de referencia a componente lógico supervisar varios 

eventos. Para añadir nuevos eventos de origen, utilice el atributo AddSrcEvt. 

Para identificar el evento de origen que se elimina, especifique juntos los nombres 

del componente lógico, la ventana, el componente y el evento. El formato de la 

serie 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 


Referencia a 



SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+. 


D Event 

* 

S 100 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 


C EVAL %setatr('win01': 'CRP1': 

C 

* 

'RmvSrcEvt')=Event 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+. 


D Event 

* 

S 100 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 


C 

* 

'CRP1' SETATR Event 'RMVSRCEVT' 


RmvEvent 

Elimina el nombre de evento de la lista de filtro de eventos. Puede utilizar el valor 

especial *ALL para que el componente ActiveX o bean Java pare de direccionar al 

programa VARPG todos los eventos almacenados en la lista. 

Tipo Serie 




SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'AX1':'RmvEvent')='EVT2' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'AX1' SETATR 'EVT2' 'RMVEVENT' 

* 


RowBGClr 

Valor numérico que determina el color de fondo de una fila de subarchivo. Debe 

utilizar 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 fondo 

devuelto es el que se parece más al color de mezcla. 



Subarchivo 


SETATR 


sí 

GETATR sí 




0 Blanco 

1 Negro 

2 Azul 

3 Rojo 

4 Rosa 

5 Verde 

6 Cian 

7 Amarillo 

8 Gris oscuro 

9 Azul oscuro 






14 Marrón 

15 Gris claro 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL RBcolor = %getatr('win01': 'SFL1': 'RowBGClr') 


C 

* 

EVAL %setatr('win01': 'SFL1': 'RowBGClr') = 5 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'SFL1' GETATR 'ROWBGCLR' 'RBcolor' 2 0 


C 

* 

'SFL1' SETATR 5 'ROWBGCLR' 


RowBGMix 

Consulta o establece la mezcla de colores de fondo de una fila de subarchivo. Debe 

utilizar el atributo Index para identificar la fila en la que se consultará o se 

establecerá la mezcla de colores. 

Tipo Serie 


Subarchivo 


SETATR 


sí 

GETATR sí 







*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL RBclrMx = %getatr('win01': 'SFL1': 'RowBGMix') 

C RBclrMx IFNE '10:23:200' 

C EVAL %setatr('win01': 'SFL1': 'RowBGMix') = '10:23:200' 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8 


* 

C 'SFL1' SETATR '10:23:200' 'ROWBGMIX' 

* 


RowFGClr 

Valor 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, el 




Subarchivo 


SETATR 


sí 

GETATR sí 




0 Blanco 

1 Negro 

2 Azul 

3 Rojo 

4 Rosa 

5 Verde 

6 Cian 

7 Amarillo 

8 Gris oscuro 

9 Azul oscuro 





14 Marrón 

15 Gris claro 



*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL RFcolor = %getatr('win01': 'SFL1': 'RowFGClr') 

* 


C EVAL %setatr('win01': 'SFL1': 'RowFGClr') = 5 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'SFL1' GETATR 'ROWFGCLR' 'RFcolor' 2 0 


C 

* 

'SFL1' SETATR 5 'ROWFGCLR' 


RowFGMix 

Consulta o establece la mezcla de colores de primer plano de una fila de 

subarchivo. Debe utilizar el atributo Index para identificar la fila en la que se 

consultará o se establecerá la mezcla de colores. 

Tipo Serie 


Subarchivo 


SETATR 


sí 

GETATR sí 







*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL RFclrMx = %getatr('win01': 'SFL1': 'RowFGMix') 

C RFclrMx IFNE '10:23:200' 

C EVAL %setatr('win01': 'SFL1': 'RowFGMix') = '10:23:200' 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+... .5....+....6....+....7....+....8 


* 

C 'SFL1' SETATR '10:23:200' 'ROWFGMIX' 

* 


Rows 


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. 





SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL Nrws=%getatr('win01':'ODBC1':'Rows') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' GETATR 'ROWS' NRWS 

* 


SBIndex 

Establece el valor de índice de un panel de barra de estado. Este valor determina 

cuál es el panel activo. Si hay una discrepancia entre el número de paneles y el 

valor de SBIndex, por omisión toma el valor 1. 





SETATR 


sí 

GETATR sí 


El valor de SBIndex puede estar entre 1y5.Elvalor por omisión es 1. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'WIN1':'SBIndex')=3 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'WIN1' SETATR 3 'SBINDEX' 

* 


SBLabel 

El texto que aparece en una barra de estado o en un panel de barra de estado. En 

el 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 del 

archivo de mensajes. 

Tipo Serie 


Barra de estado Ventana 


SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'WIN1':'SBLabel')='Wait...' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'WIN1' SETATR 'Wait...' 'SBLABEL' 

* 


SBPanes 

Recupera el número de paneles activos de un componente barra de estado. Utilice 

el atributo SBIndex para establecer cuál es el panel activo. 





SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL NPanes=%getatr('win01':'WIN1':'SBPanes') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'WIN1' GETATR 'SBPANES' NPANES 

* 


SBPosition 

Determina la posición de una barra de estado. La posición por omisión es la parte 

inferior de la ventana. Si hay una barra de progreso en la parte inferior, se mueve 

a la parte superior. 



Ventana 


SETATR 


sí 

GETATR sí 


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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01':'WIN1':'SBPosition')=1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'WIN1' SETATR 1 'SBPOSITION' 

* 


SBStyle 

Determina cómo se dibuja la barra de estado. Puede ser hundida (valor por 

omisión), en relieve o plana. 



Ventana 


SETATR 


sí 

GETATR no 


El valor de SBStyle puede ser uno de los siguientes: 

1 Hundida (valor por omisión) 

2 En relieve 

3 Plana 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01':'WIN1':'SBStyle')=2 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'WIN1' SETATR 2 'SBSTYLE' 

* 


Scale 

Permite que el programador ajuste el ancho de una columna según un porcentaje 

del ancho del carácter ″W″. 



Subarchivo 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'SFI1': 'Scale') = 8 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SFI1' SETATR 8 'SCALE' 

* 


Search 


Busca la serie especificada en la lista. La búsqueda empieza en el elemento 

especificado por el atributo Index. Se devuelve el valor de Index si se encuentra el 

elemento o0sinoseencuentra. 

La forma de ejecutar la búsqueda se puede controlar utilizando los atributos Case 

y SearchType. 

Tipo Serie 


Recuadro de 

combinación 



SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CB1': 'Search') = 'Str1' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CB1' SETATR 'STR1' 'SEARCH' 

* 


SearchType 


Determina cómo se realiza la comparación para la serie de búsqueda cuando se 

utiliza el atributo Search. 



Recuadro de 

combinación 



SETATR 


sí 

GETATR sí 


El 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) 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'CB1': 'SearchType') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CB1' SETATR 1 'SEARCHTYPE' 

* 


Selected 

Indica 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 en 

primer lugar el atributo Index o RecordID para el componente. 



Recuadro de 

combinación 

Subarchivo 



mensajes 

SETATR 


no 

GETATR sí 


El estado de Selected puede ser: 

0 El elemento no está seleccionado 

1 El elemento está seleccionado 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL Sel = %getatr('win01': 'LB1': 'Selected') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'LB1' GETATR 'SELECTED' Sel 1 0 

* 


SelectIdx 

Devuelve un valor de índice que indica la posición del botón de selección 

seleccionado en la ventana Tabuladores y grupos. Los botones de selección se crean 

en grupos lógicos, de modo que al seleccionar uno se deseleccionan los demás. Si 

no se ha seleccionado ningún botón de selección, se devuelve 0ounnúmero 

mayor 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 nombre 

del componente. 





SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL sel = %getatr('win01': 'RB1': 'SelectIdx') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'RB1' GETATR 'SELECTIDX' sel 4 0 

* 


SelectItem 

Selecciona un elemento de la parte de lista de un componente. El elemento a 

seleccionar está especificado por el parámetro index. Para seleccionar todos los 

elementos de la lista, establezca el atributo Index en cero. Sin embargo, en el caso 

de un componente recuadro de lista, SelectItem no tiene efecto alguno cuando el 

atributo 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. 



Recuadro de 

combinación 



SETATR 


sí 

GETATR no 


El valor de índice del elemento 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'LB1': 'SelectItem') = 3 

* 


Seleccionar todas las entradas de un recuadro de lista si se solicita: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CB01' GETATR 'SELECTED' IsChecked 1 0 

C IsChecked IFEQ 1 

C 'LB1' SETATR 0 'SELECTITEM' 

C 

* 

ENDIF 


SelectList 

Devuelve una lista de los índices de los registros seleccionados de un componente 

recuadro de lista o subarchivo. La lista se devuelve en forma de serie de caracteres 

formada por 6 valores de posición. Cada valor representa el índice del registro 

seleccionado. 

Tipo Serie 




SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL List=%getatr('Win01':'LB1':'SelectList') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'LB1' GETATR 'SELECTLIST' LIST 

* 

Ejemplo de SelectList 

En el fragmento de código siguiente se muestra una manera de procesar diversos 

registros seleccionados de un recuadro de lista mediante el atributo SelectList. En 

este ejemplo, se supone que se puede seleccionar 10 registros como máximo. 

* 

D DS 

D theList 60A 

D T 6 0 Dim(10) Overlay(theList) 

* 

C 'ListBox' Getatr 'NbrOfSel' N 2 0 

* 

C If N>0 

C 'ListBox' Getatr 'SelectList' theList 

* 

C Do N I 2 0 

C 'ListBox' Setatr T(I) 'Index' 

C 'ListBox' Getatr 'GetItem' theItem 60 

* .... 

* Se procesa el elemento 

* .... 

C EndDo 

* 

C EndIf 


SelectRcd 

Selecciona un registro de un contenedor. 

Tipo Serie 


Contenedor 


SETATR 


sí 

GETATR no 


El identificador del registro que se seleccionará 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CN1': 'SelectRcd') = id 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' SETATR id 'SELECTRCD' 

* 


SelPrinter 


Hace que aparezca el diálogo de selección de impresora del sistema Windows. 



*Component 


SETATR 


sí 

GETATR no 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('*component': '*component': 

C 'SelPrinter') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' SETATR 1 'SELPRINTER' 

* 


Sequence 


Determina el orden en el que se añaden los elementos a la parte de lista de un 

componente cuando se establece el atributo InsertItem o SetItem. 

Cambiar el atributo Sequence no afecta al orden actual de la lista. El orden cambia 

cuando se establece el siguiente atributo InsertItem o SetItem. 



Recuadro de 

combinación 



SETATR 


sí 

GETATR sí 


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 el 

atributo Index 

4 Los elementos se insertan al final de la lista 



*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'LB1': 'Sequence') = 1 

* 

C EVAL rc = %getatr('win01': 'LB1': 'Sequence') 

* 


Cambiar la secuencia de un recuadro de lista: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'LB1' GETATR 'SEQUENCE' sequence 1 0 

C sequence IFEQ 1 

C 

* 

'LB1' SETATR 2 'SEQUENCE' 

C ELSE 

C sequence IFEQ 2 

C 

* 

'LB1' SETATR 3 'SEQUENCE' 

C ELSE 

C 'LB1' SETATR 2 'SEQUENCE' 

C 

* 

ENDIF 

C 

* 

ENDIF 


SetItem 

Sustituye un elemento existente de la lista. El elemento que se va a sustituir se 

determina 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 o 

descendente), la posición del elemento una vez actualizado puede ser distinta de la 

indicada por el atributo Index. 

Tipo Serie 


Recuadro de 

combinación 



SETATR 


sí 

GETATR no 


El nuevo texto del elemento 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'LB1': 'Index') = 5 

C EVAL %setatr('win01': 'LB1': 'SetItem') = 'new' 

* 


Cambiar el valor actual de un elemento de recuadro de lista: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 


C 'LB1' SETATR 'New' 'SetItem' 

* 


SetRcdFld 

Establece los datos correspondientes a un campo de un registro de contenedor. 

Para poder utilizar este atributo, el atributo RecordID debe estar establecido para 

indicar el registro de contenedor y ColNumber también debe estar establecido para 

indicar qué número de campo debe actualizarse en ese registro. 

Tipo Serie 


Contenedor 


SETATR 


sí 

GETATR no 


Los datos que deben establecerse en el campo de contenedor 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CN1': 'SetRcdFld') = 'Test' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' SETATR 'Test' 'SetRcdFld' 

* 


SetRcdIcon 

Define el nombre de archivo del icono utilizado para representar este registro en la 

vista de árbol o en la vista de iconos. En las aplicaciones Java, este atributo es 

aplicable a todas las vistas. El atributo RecordID debe estar establecido para 

indicar qué registro se está utilizando. 

Tipo Serie 


Contenedor 


SETATR 


sí 

GETATR no 


El nombre de archivo del icono 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'CN1':'SetRcdIcon') 

C ='C:\TEST.ICO' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' SETATR 'C:\TEST.ICO' 'SetRcdIcon' 

* 


SetRcdText 

Define el texto que se mostrará con el icono cuando el contenedor se visualice en 

la vista de árbol. El atributo RecordID debe estar establecido para indicar qué 

registro se está utilizando. 

Tipo Serie 


Contenedor 


SETATR 


sí 

GETATR no 


El texto del registro 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CN1': 'SetRcdText') = text 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' SETATR text 'SETRCDTEXT' 

* 


SetTop 

Ordena la lista dentro del componente de modo que el elemento especificado 

aparece al principio de la misma. 

Si el recuadro de lista no tiene barras de desplazamiento (es decir, todos los 

elementos de la lista están visualizados) la lista no se desplaza. 



Recuadro de 

combinación* 

Contenedor Recuadro de lista Subarchivo 

*Restricción: Este atributo no está soportado en tiempo de ejecución en las 

aplicaciones Java para este componente. 


SETATR 


sí 

GETATR no 


El índice del elemento que se situará al principio de la lista 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'LB1': 'SetTop') = 5 

* 


Desplazar la primera entrada seleccionada al principio de la lista: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'LB1' GETATR 'FIRSTSEL' index 2 0 

C index IFGT *ZERO 

C 'LB1' SETATR index 'SETTOP' 

C 

* 

ENDIF 


SflNxtChg 

Indica si un registro de subarchivo ha cambiado o no. Debe establecer el atributo 

Index para indicar qué registro se está viendo afectado. 



Subarchivo 


SETATR 


sí 

GETATR sí 


Establézcalo en 1 para indicar que el registro ha cambiado. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('window': 'SFX': 'Index') = 12 

C EVAL %setatr('window': 'SFX': 'SflNxtChg') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SFX' SETATR 12 'INDEX' 

C 

* 

'SFX' SETATR 1 'SFLNXTCHG' 


ShData 

Especifica los datos de usuario que se deben leer o grabar en el espacio de datos 

compartidos establecido. 

Tipo Serie 


*Component 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('*component':'*component':'ShData')='DTA' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' SETATR 'DTA' 'SHDATA' 

* 


ShDataLen 

Especifica el tamaño de los datos que se van a utilizar de los datos compartidos. El 

valor por omisión es 1024 bytes. 



*Component 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('*component':'*component':'ShDataLen')=100 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' SETATR 100 'SHDATALEN' 

* 


ShDataName 

Especifica el nombre de los datos globales que se pueden compartir en 

aplicaciones. El tamaño de cada uno de los datos compartidos está determinado a 

1024 bytes. 

Al establecer ShDataName, el sistema comprueba si existe el espacio de datos 

compartidos 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 memoria 

compartida 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 


*Component 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('*component':'*component':'ShDataName')='DTAN' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' SETATR 'DTAN' 'SHDATANAME' 

* 


ShDataPos 

Especifica 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 no 

puede sobrepasar 1024. 



*Component 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('*component':'*component':'ShDataPos')=100 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' SETATR 100 'SHDATAPOS' 

* 


ShowMsgID 

Habilita 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. 



*Component 


SETATR 


sí 

GETATR no 


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. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('*component':'*component':'ShowMsgID')=1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*COMPONENT' SETATR 1 'SHOWMSGID' 

* 


ShowProp 

Establezca este atributo en 1 para que el componente muestre el diálogo de página 

de propiedades del objeto. 





SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'AX1':'ShowProp=') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'AX1' SETATR 1 'SHOWPROP' 

* 


ShowRects 

Indica si se mostrarán o no los rectángulos resaltados definidos por el usuario. 



Calendario 


SETATR 


sí 

GETATR sí 


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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL isshown = %getatr('win01': 'CAL1': 'ShowRects') 

C 

* 

EVAL %setatr('win01': 'CAL1': 'ShowRects') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' GETATR 'SHOWRECTS' isshown 1 0 

* 


ShowTabs 


Si se establece este atributo en 0, se ocultarán todas las pestañas de un componente 

cuaderno. 



Cuaderno 


SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'WIN1': 'ShowTabs') = 0 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'WIN1' SETATR 0 'SHOWTABS' 

* 


ShowText 

Indica si se mostrará o no el texto definido por el usuario. 



Calendario 


SETATR 


sí 

GETATR sí 


El valor de ShowText puede ser uno de los siguientes: 

0 No se mostrará el texto 

1 Sí se mostrará el texto 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL isshown = %getatr('win01': 'CAL1': 'ShowText') 

C 

* 

EVAL %setatr('win01': 'CAL1': 'ShowText') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' GETATR 'SHOWTEXT' shown 1 0 

* 


ShowTips 

Determina si debe visualizarse la ayuda flotante para un componente específico o 

para todos los componentes de la ventana. Si establece ShowTips para una 

ventana, este valor tiene prioridad sobre todos los demás valores establecidos para 

un componente específico de la ventana. Por ejemplo, si inhabilita que se muestre 

el texto de ayuda para la ventana, este valor se aplica también a todos los 

componentes de la ventana. 




combinación 


Pulsador gráfico Imagen Recuadro de lista Subarchivo de 

mensajes 


líneas 

Pulsador Botón de selección Graduador 

Selector cíclico Texto estático Subarchivo Ventana 


SETATR 


sí 

GETATR sí 


El valor de ShowTips puede ser uno de los siguientes: 

0 No se visualiza la ayuda flotante para un componente específico ni 

para todos los componentes de la ventana. 

1 Se visualizará ayuda flotante para aquellos componentes de la 

ventana que tengan definido TipText. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL isshown = %getatr('win01': 'Win01': 'ShowTips') 

C 

* 

EVAL %setatr('win01': 'Win01': 'ShowTips') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'Win01' GETATR 'SHOWTIPS' shown 1 0 

* 


SizeToFit 

Ajusta el tamaño del componente de forma automática de modo que el último 

elemento de la lista resulte completamente visible. 



Recuadro de 

combinación* 


*Restricción: Este atributo no está soportado en tiempo de ejecución en las 



SETATR 


sí 

GETATR no 


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. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'CB1': 'SizeToFit') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CB1' SETATR 1 'SIZETOFIT' 

* 


SortAsc 

Ordena los registros de una columna de contenedor en orden ascendente. Las 

columnas con datos de texto se ordenan alfabéticamente. 



Contenedor 


SETATR 


sí 

GETATR no 


El número de la columna que se debe ordenar. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CTR1': 'SortAsc') = 2 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CTR1' SETATR 2 'SORTASC' 

* 


SortDesc 

Ordena los registros de una columna de contenedor en orden descendente. Las 

columnas con datos de texto se ordenan alfabéticamente. 



Contenedor 


SETATR 


sí 

GETATR no 


El número de la columna que se debe ordenar. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CTR1': 'SortDesc') = 2 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CTR1' SETATR 2 'SORTDESC' 

* 


SQLError 

Indica si la operación anterior se ha realizado correctamente. Si se devuelve el 

valor 0, la operación anterior se ha ejecutado correctamente. Todos los demás 

valores devueltos indican que se ha producido un error. 





SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL Err=%getatr('win01':'ODBC1':'SQLError') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' GETATR 'SQLERROR' ERR 

* 


SQLMsgBox 

Suprime o visualiza el recuadro de mensajes ODBC si se producen errores al 

procesar una tabla. 

Si establece este atributo en 0 para suprimir el recuadro de mensajes, puede 

utilizar 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 obtener 

información adicional. 





SETATR 


sí 

GETATR no 


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. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01':'ODBC1':'SQLMsgBox')=0 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' SETATR 0 'SQLMSGBOX' 

* 


SQLQuery 

Define la sentencia SQL que se ejecuta si se establece el atributo ExecuteSQL en 1. 

Tipo Serie 




SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL Query = 'Select * From "Customers"' 

C EVAL %setatr('win01':'ODBC1':'SQLQuery')=Query 

C 

* 

EVAL %setatr('win01':'ODBC1':'ExecuteSQL')=1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 

DName+++++++++++ETDsFrom+++To/L+++IDc.Keywords+++++++++++++++++++++++++++++ 

* 

D Query 

* 

C 'Select * From "Customers"' 


* 

C 'ODBC' Setatr Query 'SQLQuery' 

C 

* 

'ODBC' Setatr 1 'ExecuteSQL' 


StartAt 

Fuerza que se inicie la operación READC en el registro especificado del 

subarchivo. Este atributo resulta de utilidad en los programas que utilizan READC 

de forma reiterativa para comprobar la existencia de registros modificados en un 

subarchivo y devolverlos. Consulte el apartado “Ejemplo de StartAt” en la 

página 408. 



Subarchivo 


SETATR 


sí 

GETATR no 


El registro en el que debe iniciarse 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 


'SFL1': 'StartAt')=4 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SFL1' SETATR 4 'STARTAT' 

* 


Ejemplo de StartAt 

El siguiente fragmento de código utiliza reiterativamente la operación READC para 

comprobar la existencia de todos los registros modificados en un subarchivo, 

devolverlos y procesarlos. Se supervisa el campo OPT para que tenga una entrada 

correcta. Si el valor de OPT no es correcto, el programa utiliza el atributo 

SflNxtChg para señalar el registro incorrecto como modificado. El atributo StartAt 

hace que la siguiente operación READC empiece en el registro situado a 

continuación del que tiene un error. 

Por omisión, READC empieza la búsqueda de registros modificados en el primer 

registro del subarchivo. Cuando se encuentra un registro modificado y se devuelve 

al programa, su estado se restablece en no modificado. En este ejemplo, el atributo 

StartAt también evita que la operación READC entre en un bucle en el registro 

señalado por SflNxtChg. 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* Suponer que el subarchivo tiene un campo llamado OPT cuyo valor 

debe ser 

* mayor que 0 

* 

C ReadC SFL1 

99 

C 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' X 

C '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+1 

C 'SFL1' Setatr X 'StartAt' 

C ReadC SFL1 

99 

C EndDo 

* 


StartNew 

Si este atributo está establecido en 1, los datos existentes se dejan aparte y se 

mantienen para seguir dibujando la gráfica. Los nuevos datos establecidos no se 

utilizarán en la gráfica hasta que no se establezca el atributo UseData. 



Gráfica 


SETATR 


sí 

GETATR no 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'GRA1': 'StartNew') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GRA' SETATR 1 'STARTNEW' 

* 


StatusBar 

Añ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 componente 

barra de estado si necesita una barra de estado compuesta, con varios paneles e 

información de acción. 



Ventana 


SETATR 


sí 

GETATR no 


El valor de StatusBar puede ser uno de los siguientes: 

1 Crear una barra de estado 

0 Eliminar una barra de estado 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01':'WIN1':'StatusBar')=1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'WIN1' SETATR 1 'STATUSBAR' 

* 


SwitchTo 


Si se establece este atributo, al iniciar una segunda instancia de un programa la 

instancia actual del programa será la que tendrá el foco. El atributo SwitchTo 

acepta como su propio valor el handle de la ventana del programa que va a 

obtener 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 D 

como tipo I (sin signo) con una longitud de 10 y 10 decimales. 



*Component 


SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL hWnd=%getatr('Win1':'Win1':'Handle') 

C 

* 

EVAL %setatr('*component':'*component':'SwitchTo')=hWnd 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'WIN1' GETATR 'HANDLE' HWND 

C 

* 

'*COMPONENT' SETATR HWND 'SWITCHTO' 


TabImage 

Especifica el nombre de archivo de la imagen que se visualizará en una pestaña 

Página de cuaderno, junto a la etiqueta. Consulte el atributo FileName para ver la 

lista de los tipos de imágenes soportados. Si se especifica *BLANK o no se 

especifica ningún nombre de archivo, la imagen se elimina. 

Tipo Serie 


Página de cuaderno Página de cuaderno 

con lienzo 


SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'NP1':'TabImage') = 'N1.ICO' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'NP1' SETATR 'N1.ICO' 'TABIMAGE' 

* 


TabLabel 

Define la etiqueta que aparece en una pestaña de página de cuaderno. El atributo 

PageNumber debe estar establecido para indicar a qué página afecta. 

Tipo Serie 




SETATR* 


sí 

GETATR Sí 


diseñador GUI. Para ello, especifique un valor en el campo Texto 

de tabulador. 


El texto que aparece en una pestaña de página de cuaderno 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'NBP1': 'TabLabel') 

C = 'Section A' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'NBP1' SETATR 'Section A' 'TABLABEL' 

* 


Text 

Establece o devuelve el valor de texto de la parte del campo de entrada de un 

componente. 

Tipo Serie 


Recuadro de 

combinación 



líneas 


SETATR* 


sí 

GETATR sí 

*Nota: Se puede establecer utilizando el cuaderno de propiedades en el 

Diseñador GUI, excepto en el caso de un componente edición de 

múltiples líneas o selector cíclico. Si se trata de un componente 

recuadro de combinación, utilice la página Datos y especifique 

valores. En el caso de un componente campo de entrada, utilice la 

página General e indique un valor en el campo Texto. 


El valor del campo de entrada 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL oldstring = %getatr('win01': 'EF1': 'Text') 

* 

C EVAL %setatr('win01': 'EF1': 'Text') = 'Newstring' 

* 


Guardar el valor de un campo de entrada y cambiarlo: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'EF1' GETATR 'TEXT' oldstring 64 

C 'EF1' SETATR 'Newstring' 'TEXT' 

* 


TextEnd 

Determina el desplazamiento de carácter del último carácter seleccionado. Si no se 

ha seleccionado ningún texto, se devuelve el valor 0. El texto se selecciona 

situando el puntero del ratón sobre el texto, pulsando el botón del ratón y 

moviendo el puntero a lo largo del texto. 

Este atributo se puede utilizar con TextStart para seleccionar una parte 

determinada de texto en el componente y para determinar la longitud del texto 

seleccionado. 




líneas 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'MLE1': 'TextEnd') = value 

C 

* 

EVAL value = %getatr('win01': 'MLE1': 'TextEnd') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' GETATR 'TEXTEND' endoffset 3 0 

* 


TextLength 

Devuelve la longitud del texto en un componente. 




líneas 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL length = %getatr('win01': 'EF1': 'TextLength') 

* 


Obtener la longitud del texto de un campo de entrada: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'EF1' GETATR 'TEXTLENGTH' length 3 0 

* 


TextSelect 

Devuelve el texto seleccionado del componente. Si no hay texto seleccionado, se 

devuelve una serie de caracteres nula. 

Para seleccionar texto en el campo, establezca los atributos TextStart y TextEnd. 

Tipo Serie 



líneas 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL value = %getatr('win01': 'MLE1': 'TextSelect') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' GETATR 'TEXTSELECT' seltext 100 

* 


TextStart 

Determina el primer carácter del campo de texto que se ha seleccionado. Si no se 

ha seleccionado ningún texto, se devuelve el valor 0. 

Este atributo puede utilizarse con TextEnd para seleccionar una cierta parte de 

texto en el componente. 




líneas 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'MLE1': 'TextStart') = value 

C 

* 

EVAL value = %getatr('win01': 'MLE1': 'TextStart') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' GETATR 'TEXTSTART' endoffset 3 0 

* 


TextString 

Devuelve todo el texto de un componente edición de múltiples líneas y convierte 

todos los caracteres de salto de línea o de retorno de carro en espacios en blanco. 

Tipo Serie 



líneas 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL ATxt=%getatr('Win01':'ML1':'TextString') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ML1' GETATR 'TEXTSTRING' ATXT 

* 


TickLabel 

Asigna una serie a una marca de escala de un componente graduador. El atributo 

TickNumber determina el TickLabel al que se hace referencia. 

Tipo Serie 


Graduador 


SETATR* 


sí 

GETATR sí 


diseñador GUI. Para ello, seleccione el pulsador Añadir y 

especifique los valores en el recuadro de diálogo Añadir texto de 

escala. 


La etiqueta asignada a la marca de escala del graduador 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

Z-ADD 0 percent 

C DO 5 ticknbr 

C EVAL %setatr('win01':'SLIDER1':'TickNumber')=ticknbr 

C EVAL %setatr('win01':'SLIDER1':'TickLabel')=percent 

C ADD 25 percent 

C 

* 

ENDDO 


Cambiar el texto para una escala de graduador: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C Z-ADD *ZERO value 2 0 

C 1 DO 11 tick 2 0 

C 'SLIDER1' SETATR tick 'TICKNUMBER' 

C 'SLIDER1' SETATR value 'TICKLABEL' 

C ADD 10 value 

C 

* 

ENDDO 


TickNumber 

Especifica en qué marca de escala del graduador se colocará el siguiente texto 

TickLabel. 

El número será un valor entre 1yelnúmero de marcas de escala especificado para 

el graduador en los valores del cuaderno. 



Graduador 


SETATR 


sí 

GETATR sí 


El número de marca de escala 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL x = %getatr('win01': 'SLIDER1': 'TickNumber') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'SLIDER1' GETATR 'TICKNUMBER' OldTick 3 0 

C 

* 

'SLIDER1' SETATR NewTick 'TICKNUMBER' 


Tile 

Cuando se establece en 1, la imagen del lienzo aparecerá en mosaico. 



Lienzo 


SETATR* 


sí 

GETATR sí 




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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CAN': 'Tile') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAN1' SETATR 1 'TILE' 

* 


TimeOut 

Este valor determina cuánto tendrá que esperar un componente cliente DDE para 

establecer una conversación DDE después de establecer DDEMode en Initiate. Este 

valor se expresa en segundos. 

Si la conversación DDE no se ha completado en este período de tiempo, se señala 

un evento Timeout para el programa. 



Cliente DDE 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'DDE1': 'TimeOut') = 5 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'DDE1' SETATR 5 'TIMEOUT' 

* 


TimerMode 

Determina la modalidad de operación actual para un componente temporizador. 

Cuando la modalidad está establecida en Start, el temporizador empezará a 

generar eventos Tick. Al establecer la modalidad en Stop se dejan de generar 

eventos Tick. Cuando TimerMode está establecido en Pause, el temporizador 

dejará de generar eventos Tick, pero seguirá actualizando el atributo TimerTicks. 



Temporizador 


SETATR 


sí 

GETATR no 


El valor de TimerMode puede ser uno de los siguientes: 

1 Start 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C PB1 BEGACT PRESS 

C EVAL %setatr('win01': 'TIMER01': 'TimerMode') = 1 

C ... 

C 

* 

ENDACT 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'TIMER1' SETATR 1 'TIMERMODE' 

* 


TimerTicks 

Determina el valor de escala actual de un temporizador. El valor de TimerTicks es 

el número de veces que el temporizador ha generado un evento Tick. 

Tenga en cuenta que los atributos Interval y Multiplier también determinan el 

número de eventos Tick. El atributo TimerTicks se determina de la manera 

siguiente: 

TimerTicks = (tiempo transcurrido en milisegundos) / (Interval * Multiplier) 



Temporizador 


SETATR 


sí 

GETATR sí 


La cuenta de escala actual del temporizador. 


Cambiar el valor de impulsos del temporizador: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL count=%getatr('win01':'TIMER01':'TimerTicks') 

C count IFGT 1000 

C EVAL %setatr('win01':'TIMER01':'TimerTicks')=0 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'TIMER01' GETATR 'TIMERTICKS' count 6 0 

C count IFGT 1000 

C 'TIMER01' SETATR 0 'TIMERTICKS' 

C 

* 

ENDIF 


TipText 

Especifica 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 que 

representa al punto de datos. 

Para un componente calendario, debe asociar el texto de ayuda al atributo 

DateIdx. La ayuda flotante se asociará con esa fecha. 

Tipo Serie 


Calendario Recuadro de selección Recuadro de 

combinación 

Contenedor 

Campo de entrada Gráfica Pulsador gráfico Imagen 

Recuadro de lista Subarchivo de Edición de múltiples Pulsador 

mensajes 

líneas 


Subarchivo 

Graduador Selector cíclico Texto estático 


SETATR* 


sí 

GETATR no 




Un máximo de 80 caracteres de texto o un identificador de mensaje 

(*MSGnnn) 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'MLE1': 'TipText')='*msg0002' 

*/xmp> 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' SETATR 'Hello' 'TipText' 

* 


Title 

Determina el texto del título de la gráfica. 

Tipo Serie 


Gráfica 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL value = %getatr('win01': 'GRA1': 'Title') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GRA1' GETATR 'TITLE' seltitle 1 0 

* 


TitlePlace 

Indica dónde debe estar situado el título dentro de la gráfica. 



Gráfica 


SETATR 


sí 

GETATR sí 


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 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'GRA1': 'TitlePlace') = 3 

C 

* 

EVAL where = %getatr('win01': 'GRA1': 'TitlePlace') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GRA1' GETATR 'TITLEPLACE' where 1 0 

* 


| 

| 

| 

| 

| 

| 

| 

Top 

Especifica 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. 



ActiveX Control de animación Calendario Lienzo* 


combinación 



Barra de 


horizontal 


Medios Panel de medios Edición de múltiples 

líneas 

Cuaderno 

Interfaz ODBC/JDBC Recuadro de contorno Barra de progreso Pulsador 

Botón de selección Graduador Selector cíclico Texto estático 



vertical 

Ventana 


para el componente lienzo. 


SETATR* 


sí 

GETATR sí 






*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL otop = %getatr('win01': 'Image1': 'Top') 

C otop SUB 200 newtop 

C EVAL %setatr('win01': 'Image1': 'Top') = newtop 

* 


Mover una imagen 200 pixels dentro de su ventana. 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'IMAGE1' GETATR 'TOP' OldTop 4 0 

C OldTop SUB 200 NewTop 4 0 

C 

* 

'IMAGE' SETATR NewTop 'TOP' 


Topic 

El atributo Topic se establece para informar a la aplicación del servidor en una 

conversación DDE acerca del tema de la conversación. Antes de que pueda 

comenzar la conversación, también debe establecerse el atributo AppName. 

Un tema DDE es un conjunto de datos que puede procesar la aplicación del 

servidor. En el caso de una aplicación de hoja de cálculo, sería un archivo de hoja 

de cálculo. 

Si el programa servidor es un componente lógico VisualAge RPG, la sintaxis de 

este atributo es: 

'nombreapl|nombreapl' 

siendo nombreapl el nombre del componente lógico VisualAge RPG. Por ejemplo, si 

el programa servidor es un componente lógico VisualAge RPG llamado server, este 

atributo se establecería de este modo: 

EVAL %setatr('WIN1':'DDE1':'Topic') = 'SERVER|SERVER' 

Tipo Serie 


Cliente DDE 


SETATR* 


sí 

GETATR sí 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'DDE1': 'AppName') = 'APP01' 

C EVAL %setatr('win01': 'DDE1': 'Topic') = 'APP01.WG1' 

C EVAL %setatr('win01': 'DDE1': 'DDEMode') = 1 

C 

* 

... 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'DDE1' SETATR 'APP01.WG1' 'TOPIC' 

* 


TopLine 

Indica 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 se 

visualizará en la última página. 




líneas 


SETATR 


sí 

GETATR sí 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'MLE1': 'TopLine') = 0 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' SETATR 0 'TOPLINE' 

* 


TopRecord 

Sitúa la lista dentro del componente subarchivo de modo que el elemento de índice 

especificado se sitúa al principio de la lista u obtiene (o devuelve) el índice de la 

fila visible superior. 



Subarchivo 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL itemtop = %setatr('win01': 'SFI1': 'TopRecord') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SFI1' SETATR 'TOPRECORD' itemtop 

* 


Treble 


El atributo Treble establece el nivel de agudos para el archivo de audio. El nivel 

puede establecerse entre 0 y 100. 



Medios 


SETATR 


sí 

GETATR sí 


El valor debe estar entre 0y100 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'AUD1': 'Treble') = 42 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'AUD1' SETATR 42 'TREBLE' 

* 


UnBind 


Establezca este atributo en 1 para desenlazar componentes previamente enlazados. 





SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'OD1':'UnBind')=1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'OD1' SETATR 1 'UNBIND' 

* 


UnderPoint 


Establezca este atributo en la representación en forma de serie de una posición 

relativa al ángulo superior izquierdo de la gráfica (por ejemplo, ″25 10″). A 

continuación, utilice los valores de los atributos HitItem, DataPoint y DataGroup 

para determinar qué parte de la gráfica está situada debajo del punto dado. 

Tipo Serie 


Gráfica 


SETATR 


no 

GETATR sí 


Serie con el formato ″x y″ 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL xystring = %getatr('win01': 'GPH1': 'UnderPoint') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GPH1' GETATR 'UNDERPOINT' xystring 

* 


Undo 

Establezca este atributo en 1 para deshacer el último cambio que se ha efectuado. 




líneas 


SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'ML1': 'Undo') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ML1' SETATR 1 'UNDO' 

* 


UpdateRow 

Determina el número de fila que se actualiza en el conjunto de resultados. No es 

necesario buscar antes una fila para actualizarla. Este atributo ocasionará que se 

actualice cualquier fila. 

Para actualizar una fila que se acaba de buscar, utilice el atributo CurrentRow para 

obtener su número de fila. 







SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'ODBC1':'UpdateRow')=4 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'ODBC1' SETATR 4 'UPDATEROW' 

* 


UseData 

Establezca este atributo en 1 para empezar a utilizar los datos establecidos para la 

gráfica desde la última vez que se estableció StartNew. 



Gráfica 


SETATR 


sí 

GETATR no 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'GRA1': 'UseData') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GRA1' SETATR 1 'USEDATA' 

* 


UseDelim 

Establezca este atributo en 1 para identificar los datos que tienen un carácter 

delimitador asociado. Utilice el atributo DelimChar para especificar el carácter 

delimitador, si lo hay. 



Recuadro de 

combinación 



SETATR* 


sí 

GETATR sí 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CB1': 'UseDelim') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CB1' SETATR 1 'USEDELIM' 

* 


UserData 

Permite que cualquier serie definida por el usuario pueda asociarse con un 

componente. La serie no tiene restricción de longitud. 

Tipo Serie 




SETATR 


sí 

GETATR sí 


Los datos que se van a asociar al componente 



*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL oldstring = %getatr('win01': 'EF1': 'UserData') 

* 

C EVAL %setatr('win01': 'EF1': 'UserData') = 'Newstring' 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'EF1' GETATR 'USERDATA' oldstring 64 

C 

* 

'EF1' SETATR 'Newstring' 'USERDATA' 


Validate 

Cuando este atributo está establecido, al pulsar el botón al que se aplica, se 

realizará la validación de campo para aquellos componentes que tengan valores de 

validación de campo y estén en la misma ventana que el botón. La validación de 

campo 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 un 

mensaje y no se señala el evento Press. 

Si no hay errores, o si no hay campos con validación de campo, se invoca la 

subrutina de acción del evento Press. 

Nota: Si ningún pulsador o pulsador gráfico de la ventana tiene establecido el 

atributo Validate. no se realizará la validación de campo. 



Pulsador gráfico Pulsador 


SETATR* 


sí 

GETATR sí 


diseñador GUI. Para ello, seleccione el estilo Ejecutar validación de 

campo. 


El valor de Validate puede ser uno de los siguientes: 

0 No efectuar validación de entrada 

1 Efectuar validación de entrada 



*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL validate = %getatr('win01': 'EF01': 'Validate') 

* 

C EVAL %setatr('win01': 'EF01': 'Validate') = 1 

* 



*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'EF1' GETATR 'VALIDATE' validate 1 0 

C 'EF1' SETATR 1 'VALIDATE' 

* 


Value 

Devuelve el valor de un componente graduador. El valor será mayor o igual que el 

valor 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. 





SETATR 


sí 

GETATR sí 


Valor del graduador o del campo de entrada. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL oldvalue = %getatr('win01': 'SLIDER1': 'Value') 

C 

* 

EVAL %setatr('win01': 'SLIDER1': 'Value') = 5 



*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'SLIDER1' GETATR 'VALUE' OldValue 3 0 

C 'SLIDER1' SETATR 5 'VALUE' 

* 


View 

Determina cómo se visualizan los registros de un contenedor. Un contenedor 

puede visualizar registros en una vista de iconos, de árbol, de detalles o de árbol 

de texto. 



Contenedor 

*Restricción: En las aplicaciones Java, este atributo sólo se puede obtener 

en tiempo de ejecución para este componente. 


SETATR 


sí 

GETATR sí 


La vista de contenedor puede ser: 

1 Vista de iconos 

2 De árbol 

3 Vista de detalles 

4 Vista de árbol de texto 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'CN1': 'View') = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' SETATR 1 'VIEW' 

* 


Visible 

Determina si el componente es visible o no. 



ActiveX Control de animación Calendario Recuadro de selección 

Recuadro de 

Referencia a 


combinación 



Barra de 


horizontal 


Medios Panel de medios Subarchivo de Edición de múltiples 

mensajes 

líneas 

Cuaderno Página de cuaderno Interfaz ODBC/JDBC Recuadro de contorno 

Menú emergente* Barra de progreso Pulsador Botón de selección 

Graduador Selector cíclico Texto estático Barra de estado 



vertical 

Ventana 

*Restricción: Para las aplicaciones Windows, una consulta (GETATR) 

devuelve un valor 0 para este atributo. En las aplicaciones 

Java, este atributo devuelve el estado del menú emergente. 


SETATR* 


sí 

GETATR sí 




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én 

debe establecer los atributos InvPname (nombre de padre 

del invocador) e InvName (nombre de invocador), y las 

coordenadas x-y del menú emergente del espacio de 

coordenadas del invocador. 



Conmutar el estado de Visible de un componente: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL isVisible = %getatr('win01': 'EF1': 'Visible') 

C isVisible IFEQ 1 

C 

* 

EVAL %setatr('win01': 'EF1': 'Visible') = 0 

C ELSE 

C EVAL %setatr('win01': 'EF1': 'Visible') = 1 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'EF1' GETATR 'VISIBLE' IsVisible 1 0 

C IsVisible IFEQ 1 

C 

* 

'EF1' SETATR 0 'VISIBLE' 

C ELSE 

C 'EF1' SETATR 1 'VISIBLE' 

C 

* 

ENDIF 


VisTitle 

Determina si el título del contenedor es visible o no. 



Contenedor 


SETATR 


sí 

GETATR sí 



0 El título no es visible 

1 El título es visible 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'CN1': 'VisTitle) = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' SETATR 1 'VisTitle' 

* 


VisTitlSep 

Determina si el separador del título del contenedor es visible o no. 



Contenedor 


SETATR 


sí 

GETATR no 



0 El separador del título no es visible 

1 El separador del título es visible 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'CN1': 'VisTitlSep) = 1 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CN1' SETATR 1 'VisTitlSep' 

* 


Volume 


Establece el volumen para el componente medios y la salida de ondas y el 

sintetizador del sistema. 

En el caso de un panel de medios, determina el valor del graduador de volumen. 

Este valor está entre 0 y 100. 



Medios Panel de medios 


SETATR 


sí 

GETATR sí 


El valor de volumen 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL curvol = %getatr('win01': 'MMP1': 'Volume') 

C 

* 

EVAL %setatr('win01': 'MMP1': 'Volume') = 5 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'MMP1' GETATR 'VOLUME' curvol 3 0 

C 

* 

'MMP1' SETATR 5 'VOLUME' 


VRule 

Añade una regla vertical entre cada columna de una fila de datos de subarchivo o 

de calendario. Debe haber por lo menos una fila de datos. 



Calendario Subarchivo 


SETATR 


sí 

GETATR sí 


El valor de VRule puede ser uno de los siguientes: 

0 Desactiva la regla 

1 Activa la regla 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL Vtrule = %getatr('win01': 'SF1': 'VRule') 

C Vtrule IFEQ 0 

C EVAL %setatr('win01': 'SF1': 'VRule') = 1 

C ELSE 

C EVAL %setatr('win01': 'SF1': 'VRule') = 0 

C 

* 

ENDIF 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

'SF1' GETATR 'VRULE' Vtrule 1 0 

C 

* 

'SF1' SETATR 1 'Vtrule' 


WeekDay 

Indica el día de la semana que está seleccionado. 



Calendario 


SETATR 


no 

GETATR sí 



0 Domingo 

1 Lunes 

2 Martes 

3 Miércoles 

4 Jueves 

5 Viernes 

6 Sábado 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL index = %getatr('win01': 'CAL1': 'WeekDay') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' GETATR 'WEEKDAY' 02 

* 


WeekDayIdx 

Devuelve el día de la semana que corresponde a los valores de YearIdx, MonthIdx 

y DayIdx. 



Calendario 


SETATR 


no 

GETATR sí 



0 Domingo 

1 Lunes 

2 Martes 

3 Miércoles 

4 Jueves 

5 Viernes 

6 Sábado 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL index = %getatr('win01': 'CAL1': 'WeekDayIdx') 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' GETATR 'WEEKDAYIDX' INDEX 

* 


| 

| 

| 

| 

| 

| 

| 

Width 

Especifica el ancho del componente en pixels. Al cambiar el ancho de una ventana 

se genera un evento ReSize. 

Nota: El atributo Width no puede sobrepasar el ancho máximo, que viene 

determinado por la resolución de pantalla utilizada. Por ejemplo, no se 

puede crear un componente que tenga 800 pixels de ancho si se trabaja con 

una pantalla de 640 pixels de ancho. 




Recuadro de 

combinación 


Pulsador gráfico Recuadro de grupo Barra de 


horizontal 

Imagen 

Bean Java Recuadro de lista Panel de medios Edición de múltiples 

líneas 

Cuaderno Interfaz ODBC/JDBC Recuadro de contorno Barra de progreso 


Texto estático Subarchivo Barra de 


vertical 

Ventana 


SETATR* 


sí 

GETATR sí 




El ancho del componente en pixels 


Aumentar el ancho de un componente: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL width = %getatr('win01': 'EF1': 'Width') 

* 

C EVAL %setatr('win01': 'EF1': 'Width') = 

width + 100 

* 


Ampliar un pulsador 200 pixels: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'EF1' GETATR 'WIDTH' OldWidth 2 0 

C OldTop ADD 200 NewWidth 2 0 

C 

* 

'EF1' SETATR NewWidth 'WIDTH' 


WindowMode 


Determina cómo se visualiza una ventana. 



Ventana 


SETATR 


sí 

GETATR sí 


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 la 

representa como un icono 

3 Restaurada - Devuelve la ventana al tamaño que tenía antes de ser 

minimizada o maximizada 

Nota: Cuando se restaura una ventana desde un estado maximizado, el 

atributo WindowMode puede indicar que la ventana sigue en estado 

maximizado aunque ya no lo esté. 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'win01': 'WindowMode') = 1 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'WIN01' SETATR 1 'WINDOWMODE' 

* 


WordWrap 

Determina si el texto entrado en un componente edición de múltiples líneas debe 

acomodarse al llegar al límite de palabras. Si WordWrap está inhabilitado, el texto 

continuará en la misma línea. 

Nota: Este atributo no funciona si se establece el estilo de desplazamiento 

horizontal. 




líneas 


SETATR* 


no 

GETATR sí 




El valor de WordWrap puede ser uno de los siguientes: 

0 Acomodar palabra inhabilitado 

1 Acomodar palabra habilitado 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL rc = %getatr('win01': 'MLE1': 'WordWrap') 

* 


Conmutar el estado de acomodación de palabra de un componente edición 

de múltiples líneas: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'MLE1' GETATR 'WORDWRAP' break 1 0 

* 


WrkStnName 


Devuelve el nombre de la estación de trabajo. 

Tipo Serie 


*Component 


SETATR 


no 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL WRKN=%getatr('*component':'*component':'WrkStnName') 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C '*component' GETATR 'WRKSTNNAME' WRKN 

* 


X 


Especifica la coordenada x, en pixels, del menú emergente del espacio de 

coordenadas del invocador. Este atributo se utiliza junto con los atributos 

InvName, InvPname e Y. 





SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'POP1':'X')=35 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'POP1' SETATR 35 'X' 

* 


XAxisLabel 

Es el texto que sirve de etiqueta del eje de la X. 

Tipo Serie 


Gráfica 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'GRA1': 'XAxisLabel') = label 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GRA' SETATR 'label' 'XAxisLabel' 

* 


Y 


Especifica la coordenada y, en pixels, del menú emergente del espacio de 

coordenadas del invocador. Este atributo se utiliza junto con los atributos 

InvName, InvPname y X. 





SETATR 


sí 

GETATR no 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01':'POP1':'Y')=45 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'POP1' SETATR 45 'Y' 

* 


YAxisLabel 

Es el texto que sirve de etiqueta del eje de la Y. 

Tipo Serie 


Gráfica 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'GRA1': 'YAxisLabel') = label 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GRA1' SETATR 'label' 'YAxisLable' 

* 


Year 

Indica el año del calendario que está seleccionado actualmente. Si se establece, se 

actualizará la fecha seleccionada del componente calendario para que los cambios 

queden reflejados. 



Calendario 


SETATR 


sí 

GETATR sí 


El año 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CAL1': 'Year') = 1998 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' SETATR 1998 'YEAR' 

* 


YearIdx 





Calendario 


SETATR 


sí 

GETATR sí 




*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'CAL1': 'YearIdx') = 1998 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' SETATR 1998 'YEARIDX' 

* 


YearLen 

Indica el formato de visualización del año. 



Calendario 


SETATR* 


sí 

GETATR sí 




YearLen puede tener uno de los valores siguientes: 

1 Año completo con cuatro dígitos 

2 Dos dígitos 

3 

Nota: Windows 95 visualiza ambos dígitos como la opción de 

relleno de dos dígitos. No hay distinción entre ambas. 

Dos dígitos, con un cero para los años que sólo tienen un dígito 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 

* 

EVAL %setatr('win01': 'CAL1': 'YearLen') = 3 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'CAL1' GETATR 'YEARLEN' YearLen 1 0 

* 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

Yinc 

Establece el número de marcas de escala que se utilizarán en el eje Y. El eje Y se 

dividirá en un número igual de incrementos, basándose en los valores mínimo y 

máximo permitidos. 



Gráfica 


SETATR 


sí 

GETATR sí 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C EVAL %setatr('win01': 'GRA1': 'YInc') = 20 

* 


*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8 


* 

C 'GRA1' SETATR 20 'YInc' 

* 


| 

Capítulo 3. Eventos de componentes 

Activate 

BeanEvent 

Cuando un componente reconoce un evento (por ejemplo, cuando el usuario 

selecciona un pulsador), invoca la subrutina de acción que haya definido entre los 

códigos de operación BEGACT y ENDACT específicos en el programa. Si no se ha 

definido ninguna subrutina de acción para un evento, éste se pasa por alto. La 

ventana Subrutinas de acción visualiza qué subrutinas de acción se invocan 

mediante qué eventos de componente. 

En ciertos casos, el evento también hará que se pueda disponer de atributos de 

evento, que contienen datos relevantes. Puede acceder a estos atributos de evento 

desde el programa haciendo referencia a los mismos. 

Este capítulo describe los eventos de componente. Cada una de las descripciones 


v Una lista de componentes a los que se aplica el evento 

v Una descripción general del evento 

v Una lista de los atributos de evento que se aplican al evento (si los hay) 

v Un ejemplo (si los hay) 

Este evento se produce cuando una ventana se convierte en la ventana activa. Ello 

ocurre cuando el usuario pulsa en ella con el puntero del ratón o selecciona un 

componente de la misma. 


Ventana 

Atributos de evento 

%EventName %Part %Window 

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

Este evento se produce siempre que se produce un evento de bean Java. 


Bean Java 




Change 

Click 

Este evento se produce al cambiar el contenido o el valor de un componente. Para 

cada tipo de componente, este evento se produce cuando se realiza el siguiente 

cambio: 

Recuadro de combinación 

El usuario escribe en el campo de entrada o selecciona un elemento de la 

lista desplegable. 


El usuario escribe en el campo de entrada. 

Edición de múltiples líneas 

El usuario escribe en el campo de edición de múltiples líneas. 


El usuario cambia la posición de un graduador del panel. 

Graduador 

El usuario cambia la posición del graduador. 


El usuario selecciona uno de los selectores cíclicos o escribe un valor en el 

campo de entrada. 

Subarchivo 

El usuario cambia los datos de una casilla de subarchivo y abandona la 

casilla. 

Tenga en cuenta que también puede modificarse el valor de un componente como 

resultado de establecer ciertos atributos, por ejemplo, el componente está definido 

como un componente destino y responde a un evento Link. 


Recuadro de 

Campo de entrada Panel de medios Edición de múltiples 

combinación 

líneas 

Graduador Selector cíclico Subarchivo 


%ColNumber %EventName %Index %Part 

%Window 

Este evento se produce cuando el usuario coloca el puntero del ratón encima del 

componente 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 vista 

de Detalles. 


Calendario Lienzo Contenedor Campo de entrada 

Gráfica Imagen Edición de múltiples 

líneas 



Close 

Collapsed 

ColSelect 

Complete 


%Button %EventName %MouseX %MouseY 

%Part %Window 

Este 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. 


Ventana 



Este 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 que 

muestre el estado. 


Contenedor 



Este evento se produce al seleccionar una cabecera de columna con el ratón. Debe 

haber un componente contenedor en la vista de detalles. El atributo de evento 

%ColNumber devuelve el número de la columna seleccionada. 


Contenedor Subarchivo 


%ColNumber %EventName %Part %Window 

Este evento se produce cuando el componente medios ha procesado un archivo de 

audio. El atributo de evento %Complete indica si la operación se ha realizado de 

manera correcta. 

Capítulo 3. Eventos de componentes 467

Create 

Data 


Medios 


%Complete %EventName %Part %Window 

Este evento se produce cuando se crea el componente. 

En el caso de un componente ventana, el evento Create sólo después de que se 

hayan creado todos los componentes de dicha ventana y se hayan producido sus 

eventos 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 de 

que el campo aparezca en la ventana. 




Referencia a 

Contenedor 

combinación 





horizontal 


Recuadro de lista Medios Panel de medios Barra de menús 

Opción de menú Subarchivo de Edición de múltiples Cuaderno 

mensajes 

líneas 

Página de cuaderno Interfaz ODBC/JDBC Recuadro de contorno Barra de progreso 


Texto estático Barra de estado Subarchivo Submenú 

Temporizador Barra de 


vertical 

Ventana 



Este evento se produce cuando los datos están disponibles de la aplicación 

servidor en una conversación DDE. Se genera como resultado de un mandato 

Request, o si los datos han cambiado o el componente Cliente DDE está definido en 

una conversación de enlace dinámico con otro componente mediante el atributo 

AllowLink. 


Cliente DDE 


DblClick 

DeActivate 

Destroy 


%Data %EventName %Item %Part 

%Window 

Este evento se produce cuando el usuario pulsa y suelta el botón del ratón dos 

veces de forma rápida y sucesiva. 



Gráfica Imagen Edición de múltiples 

líneas 




%Part %Window 

Este evento se produce cuando la ventana ya no está activa. Una ventana se 

desactiva cuando se activa otro componente. 

Este evento se produce al ejecutar un código de operación CLSWIN. 


Ventana 



Este 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ú del 

sistema en la ventana, o mediante el código de operación CLSWIN. 

Este evento también se producirá en todos los componentes del programa al 

terminar éste. 




Referencia a 

Contenedor 

combinación 





horizontal 


Recuadro de lista Medios Panel de medios Barra de menús 


Drop 

DropDown 

Opción de menú Subarchivo de Edición de múltiples Cuaderno 

mensajes 

líneas 

Página de cuaderno Interfaz ODBC/JDBC Recuadro de contorno Barra de progreso 


Texto estático Barra de estado Subarchivo Submenú 

Temporizador Barra de 


vertical 

Ventana 



Este evento se produce al arrastrar y soltar un objeto en este componente. El 

atributo DropEnable debe establecerse para este componente para que responda a 

este evento. Puede consultar el valor asociado con el componente soltado 

verificando el atributo de evento %Data. 


Recuadro de 

combinación* 


líneas 



Recuadro de lista* Subarchivo de 

mensajes 

* Restricción: Este evento no está soportado en tiempo de ejecución en las 



%Data %EventName %Part %Window 

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

Para un recuadro de combinación, este evento se produce cuando tiene lugar lo 

siguiente: 

v El usuario pulsa con el ratón en la flecha abajo que hay a la derecha del 

recuadro. 


Recuadro de 

combinación 




Enter 

ExecuteAck 

Expanded 

En un recuadro de combinación, contenedor, recuadro de lista, subarchivo de 

mensajes 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 una 

doble pulsación en el componente. 


Recuadro de 

Contenedor Recuadro de lista* Subarchivo de 

combinación 

mensajes 

Botón de selección Subarchivo 

* Restricción: Este evento no está soportado en tiempo de ejecución en las 




Este evento se produce cuando la aplicación servidor ha procesado un mandato 

Execute. El atributo de evento %Complete indica si la ejecución ha sido correcta. 


Cliente DDE 


%Complete %Data %EventName %Part 

%Window 

Este 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 que 

muestre el estado. 


Contenedor 




FirstRec 

GotFocus 

KeyPress 

Este evento se produce cuando se selecciona el botón de ″primer registro″ de la 

barra de navegación. 


Subarchivo 



Este evento se produce cuando el componente recibe el foco de entrada. Esto se 

produce cuando el usuario mueve el cursor a un componente habilitado o si se ha 

establecido el foco en este componente mediante el atributo Focus. El componente 

debe estar habilitado para recibir este evento. 


Recuadro de 

combinación 

Contenedor Campo de entrada Pulsador gráfico 


líneas 

Pulsador Graduador 

Selector cíclico Subarchivo 



Este evento se produce cuando se pulsa una tecla y el componente tiene foco de 

entrada. 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 eventos 

generados mediante teclas que no sean de caracteres, como RePág y AvPág, 

consulte el evento VKeyPress. 


Recuadro de 

combinación 


líneas 


Contenedor Campo de entrada Recuadro de lista 

Subarchivo 

%Alt %Character %Control %EventName 

%Part %Shift %Window 


LastRec 

LClickTray 

Link 

LostFocus 

Este evento se produce cuando se selecciona el botón de ″último registro″ de la 



Subarchivo 



Este evento se produce cuando un usuario pulsa el icono de bandeja del sistema 

de la aplicación con el botón izquierdo del ratón. La aplicación debe estar 

registrada como aplicación de bandeja del sistema mediante la API 

Shell_NotifyIconA de Windows. 






Este evento se produce cuando el componente está enlazado a un componente 

origen, utilizando el atributo AddLink, y el componente origen ha cambiado. El 

atributo AllowLink debe estar establecido para que el componente origen señale 

este evento. 


Campo de entrada Imagen Medios Panel de medios 

Graduador Selector cíclico Texto estático Temporizador 



Este evento se produce cuando el componente deja de tener el foco de entrada. 


Recuadro de 

combinación 

Contenedor Campo de entrada Pulsador gráfico 


MenuSelect 

MouseDown 

MouseEnter 


líneas 

Selector cíclico Subarchivo 



Pulsador Graduador 

Este evento se produce cuando el usuario selecciona una opción de menú con el 

ratón o con la tecla aceleradora. 

Este evento no significa que se haya marcado una opción de menú. Para 

determinar si se ha marcado o no un elemento de menú, consulte el atributo 

Checked del elemento. 


Opción de menú 



Este evento se produce al pulsar un botón del ratón. 



Gráfica Edición de múltiples 

líneas 




%Part %Window 

Este evento se produce al llevar por primera vez el puntero del ratón a un 

componente. 



combinación 

Contenedor 


Recuadro de lista Panel de medios Subarchivo de Edición de múltiples 

mensajes 

líneas 


Texto estático Subarchivo 


MouseExit 

MouseMove 



Este evento se produce al sacar por primera vez el puntero del ratón de un 

componente. 



combinación 

Contenedor 


Recuadro de lista Panel de medios Subarchivo de Edición de múltiples 

mensajes 

líneas 


Texto estático Subarchivo 



Este 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 al 

usuario sobre la función del componente. 



combinación 

Contenedor Campo de entrada Gráfica Pulsador gráfico 

Imagen Recuadro de lista Panel de medios Subarchivo de 

mensajes 


líneas 

Pulsador Botón de selección Graduador 



%EventName %MouseX %MouseY %Part 

%Window. 

Ejemplo 

Crear un área de información cambiando el atributo Label de un 

componente texto estático cuando el puntero del ratón se sitúa en un 

componente: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+. 

CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq 

* 

C PB1 BEGACT MOUSEMOVE 

* 


MouseUp 

Moved 

MthChange 

NextRec 

C ST1 SETATR 'Ends program'LABEL 

* 

C ENDACT 

* 

Este evento se produce al soltar un botón del ratón. 



Gráfica Edición de múltiples 

líneas 




%Part %Window 

Este evento se produce siempre que el usuario mueve una ventana. 


Ventana 



Este evento se produce al seleccionar otro mes pulsando con el ratón en una de las 

flechas de mes. 


Calendario 



Este evento se produce cuando se selecciona el botón de ″siguiente registro″ de la 



Subarchivo 


Notify 

OCXEvent 

PageDown 



En el cuaderno de propiedades del componente referencia a componente lógico, 

puede especificar un evento asociado con un componente determinado en una 

ventana especificada. Cuando se produce un evento, cuyo nombre coincide con el 

valor del atributo NotSrcEvt, en el componente especificado de la ventana 

especificada, se direcciona un evento Notify al componente referencia a 

componente lógico. 

Para que se señale un evento Notify, debe existir una subrutina de acción para el 

evento supervisado. No es necesario que la subrutina contenga código alguno. Si 

no hay ninguna subrutina de acción, el evento Notify no se producirá. 


Referencia a 



%EventName %Part %SrcCompName %SrcEvtName 

%SrcPartName %SrcWinName Ventana 


Este evento se produce siempre que se produce un evento de control de ActiveX. 


ActiveX 


%EventName %Part %RealName %Window 

Este evento se produce cuando se pulsa la tecla Av Pág o cuando se pulsa con 

ratón en el área vacía hacia la parte inferior de la barra de desplazamiento vertical 

o si selecciona la barra de navegación del botón Av Pág. 


Subarchivo 




PageEnd 

PageSelect 

PageTop 

PageUp 

Este 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 de 

desplazamiento vertical o cuando se arrastra el graduador por la barra de 

desplazamiento 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 evento 

PageEnd. 


Subarchivo 



Este evento se produce cuando el usuario selecciona una página de cuaderno en 

una sección nueva del cuaderno mediante la pestaña correspondiente. 

El atributo de evento %Page devolverá el número de la página seleccionada. 




%EventName %Page %Part %Window 

Este 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 de 

desplazamiento vertical o cuando se arrastra el graduador por la barra de 

desplazamiento hasta el principio de la lista de subarchivos. En este caso, no se 

envía el evento PageUp. 


Subarchivo 



Este evento se produce cuando se pulsa la tecla Re Pág, si el usuario pulsa el botón 

sobre el área vacía de la parte suyperior de la barra de desplazamiento vertical o 

bien si seleccione el botón de navegación Re Pág. 


PokeAck 

Popup 


Subarchivo 



Este 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 el 

mandato poke se ha realizado satisfactoriamente. 


Cliente DDE 


%Complete %Data %EventName %Item 

%Part %Window 

Ejemplo 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+. 


* 

C 

* 

DDE1 BEGACT POKEACK 

C %COMPLETE IFNE *ZERO 

C 

* 

'Poke failed' DSPLY style X 

C 

* 

ENDIF 

C 

* 

ENDACT 

Este evento se produce cuando el puntero del ratón se sitúa sobre un componente 

y se pulsa el botón derecho del ratón. 



combinación 

Contenedor 

Campo de entrada Pulsador gráfico Recuadro de lista Panel de medios 

Subarchivo de Edición de múltiples Pulsador Botón de selección 

mensajes 

líneas 



%ColNumber %EventName %Index %MouseX 

%MouseY %Part %Window 


Press 

PrevRec 

RClickTray 

ReSize 

Este evento se produce cuando el usuario pulsa el botón del ratón en el 

componente o cuando pulsa la tecla Intro cuando el componente tiene el foco de 

entrada. 


Pulsador gráfico Panel de medios Pulsador 



Este evento se produce cuando se selecciona el botón de ″registro anterior″ de la 



Subarchivo 



Este evento se produce cuando un usuario pulsa el icono de bandeja del sistema 

de la aplicación con el botón derecho del ratón. La aplicación debe estar registrada 

como aplicación de bandeja del sistema mediante la API Shell_NotifyIconA de 

Windows. 





Este evento se produce cuando se ha cambiado el tamaño del componente. Por 

ejemplo, puede producirse si el usuario cambia el tamaño de una ventana 

utilizando el borde para ajustar el tamaño, o si cambia el tamaño del componente 

estableciendo el atributo Height o Width. 

Puede utilizar este evento para reubicar o mover componentes de una ventana 

cuando el usuario cambie el tamaño de la ventana. 

Durante el evento ReSize, los atributos Height y Width contienen el tamaño actual 

de la ventana, mientras que los atributos de evento %NewHeight y %NewWidth 

contienen el tamaño de la ventana una vez completado el evento ReSize. 


Scroll 

Select 

ShutDown 


Ventana 


%EventName %NewHeight %NewMode* %NewWidth 

%Part %Window 



Este evento se produce al pulsar la flecha de desplazamiento de un componente 

barra de desplazamiento horizontal o vertical. El atributo de evento %Position 

contiene la posición del recuadro de desplazamiento cuando el usuario deja de 

desplazarse. 


Barra de 


horizontal 


Barra de 


vertical 

%EventName %Part %Position %Window 

Este evento se produce cuando el usuario selecciona un componente pulsando 

sobre el mismo con el ratón o utilizando las teclas de flechas. En un recuadro de 

combinación, contenedor, recuadro de lista, subarchivo de mensajes y subarchivo, 

este evento se produce cuando se selecciona un elemento de la lista. 



combinación 

Contenedor Recuadro de lista 

Subarchivo de 

mensajes 

Botón de selección Subarchivo 


%ColNumber %EventName %Index %Part 

%Window 

Este evento se produce cuando el constructor GUI finaliza y se ha especificado el 

handle de ventana en el mandato de conector NotifyOnClose. Este evento se puede 

utilizar para supervisar todos los conectores que se ejecutan desde el constructor 

GUI y además cerrarlos. 


SpinDown 

SpinEnd 

SpinUp 

Terminate 


Ventana 



Este evento se produce cuando el usuario selecciona el botón de flecha abajo de un 

componente selector cíclico. 





Este evento se produce cuando el usuario suelta el botón de flecha arriba o de 

flecha abajo de un componente selector cíclico. 





Este evento se produce cuando el usuario selecciona el botón de flecha arriba de 

un componente selector cíclico. 





Este evento se produce cuando el servidor, en una conversación DDE, ha solicitado 

que termine la conversación, o cuando el componente cliente DDE tiene su atributo 

DDEMode establecido en Terminate. 


Tick 

Timeout 


Cliente DDE 



Ejemplo 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+. 


* 

C PB1 BEGACT TERMINATE 

* 

C 'Terminating' DSPLY STYLE X 

* 

C ENDACT 

* 

Este evento se produce cada vez que transcurre el valor de intervalo del 

temporizador. El atributo Multiplier también determina cuándo se generará el 

evento Tick. 


Temporizador 



Ejemplo 

Actualizar un componente texto estático con el valor de impulso actual de 

un componente temporizador: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+. 


* 

C 

* 

TIMER1 BEGACT TICK 

C 'TIMER1' GETATR TIMERTICKS timerticks 6 0 

C 

* 

ST1 SETATR timerticks 'LABEL' 

C 

* 

ENDACT 

Este evento se produce cuando no se ha establecido la conversación DDE en el 

tiempo definido por el atributo TimeOut. 


Cliente DDE 



Ejemplo 


VKeyPress 

YearChange 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+. 


* 

C DDE1 BEGACT TIMEOUT 

* 

C 'DDE Failed!' DSPLY STYLE X 

C ENDACT 

* 

Este evento se produce cuando se pulsa una tecla de mandato. Como ejemplos de 

teclas de mandato se pueden citar AvPág, Pausa y Control. Para obtener una 

descripción del valor devuelto, consulte el atributo de evento %Character. 


Recuadro de 

combinación 


líneas 


Contenedor Campo de entrada Recuadro de lista 

Subarchivo 

%Alt %Character %Control %EventName 

%Part %Shift %Window 

Ejemplo 

Borrar un campo de entrada si se pulsa F5 cuando el campo tiene el foco 

de entrada: 

*...1....+....2....+....3....+....4....+....5....+....6....+....7....+. 


* 

C 

* 

EF1 BEGACT VKEYPRESS 

C %character IFEQ '29' 

C 'EF1' SETATR *BLANKS 'TEXT' 

C 

* 

ENDIF 

C 

* 

ENDACT 

Este evento se produce al seleccionar otro año pulsando con el ratón en una de las 

flechas de año o en una flecha de mes de modo que se cambie el año. 


Calendario 




| 

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 definidos 

en la especificación de Definición con el tipo y la longitud correctos. La tabla 

siguiente lista los atributos de evento con sus tipos de datos y longitudes 

correspondientes: 

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 


%Alt 

%Button 

%Character 

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 descripciones 


v El tipo de datos del atributo de evento 

v Una descripción general del atributo de evento 

v Una lista de los eventos a los que se aplica el atributo 

Indica 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 



KeyPress VKeyPress 

Indica 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 1y2 



Click DblClick MouseDown MouseUp 

Código de carácter generado por el evento. 

Durante el evento VKeyPress, el atributo de evento %Character se devolverá como 

un valor que representa la tecla no de carácter que se ha pulsado. Los valores son 

los siguientes: 

00 – Esc 13 – Fin 25 – Inter 37 – F14 

01 – Tabulador →| 14 – Retroceso de 

página 

26–F2 38–F15 

02 – Tabulador |← 15 – Avance de 

página 

27–F3 39–F16 

03 – Espacio 16 – ← (Izquierda) 28 – F4 40 – F17 

04 – ←Retroceso 17 – → (Derecha) 29 – F5 41 – F18 

05 – Intro (teclado 

numérico) 

18 – ↑ (Arriba) 30 – F6 42 – F19 


%ColNumber 

%Complete 

%Control 

06 – Intro 19 – ↓ (Abajo) 31 – F7 43 – F20 

07 – Mayús 20 – Bloqueo 

Mayúsculas 

32–F8 44–F21 

08 – Control 21 – Bloqueo 

Numérico 

33–F9 45–F22 

09 – Alt 22 – Bloqueo Mayús 34 – F11 46 – F23 

10 – Insertar 23 – Pausa 35 – F12 47 – F24 

11 – Suprimir 

12 – Inicio 

24 – PetSis 36 – F13 56 – Alt 

Tipo Serie 


Keypress VKeyPress 

Devuelve el número de columna para un componente subarchivo o contenedor. 



Change ColSelect Popup Select 

Indica si la operación anterior se ha realizado de manera satisfactoria o no: 

0 Operación no satisfactoria 

1 Operación satisfactoria. 



Complete ExecuteAck PokeAck 

Indica 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. 




Capítulo 4. Atributos de eventos 487

%Data 

%EventName 

%Index 

%Item 

%MouseX 

Contiene los datos enviados por una aplicación de servidor como respuesta a un 

mandato Request. El contenido y la estructura de estos datos los determina la 

aplicació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 


Data Drop ExecuteAck PokeAck 

Devuelve el nombre del evento. 

Tipo Serie 


A todos 

Devuelve el número de índice del registro en el que está situado el puntero del 

ratón cuando se produce un evento Popup o Select. No es preciso que el registro 

tenga el foco. 



Change Popup Select 

Contiene el nombre del elemento que participa actualmente en una conversación 

DDE. 

Tipo Serie 


Data PokeAck 

La coordenada X de la ubicación actual del puntero del ratón en el componente 

cuando se ha producido el evento. Se expresa en pixels. Es un valor comprendido 

entre cero y la anchura del componente. El valor cero representa el borde izquierdo 

del componente. 

Nota: En el caso del evento MouseMove, esta coordenada es relativa al escritorio. 



%MouseY 

%NewHeight 

%NewMode 

%NewWidth 


Click DblClick MouseDown MouseMove 

MouseUp Popup 

La coordenada Y de la ubicación actual del puntero del ratón en el componente 

cuando se ha producido el evento. Se expresa en pixels. Es un valor comprendido 

entre cero y la altura del componente. El valor cero representa el borde inferior del 

componente. 

Nota: En el caso del evento MouseMove, esta coordenada es relativa al escritorio. 



Click DblClick MouseDown MouseMove 

MouseUp Popup 

Es 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 de 

acción correspondiente al evento ReSize ha terminado. 



ReSize 


Indica en qué modalidad se establecerá la ventana: 

1 Maximizada 

2 Minimizada 

3 Restaurada 



ReSize 

Es la anchura del componente después de cambiar el tamaño del mismo. 


%Page 

%Part 

%Position 

%RealName 

%Shift 

Nota: El atributo Width del componente no cambia hasta que la subrutina de 

acción correspondiente al evento ReSize ha terminado. 



ReSize 

Devuelve el número de página de la página seleccionada cuando se produce el 

evento PageSelect. 



PageSelect 

Contiene el nombre del componente que genera el evento. 

Tipo Serie 


A todos 

Devuelve la posición actual del recuadro de desplazamiento cuando el usuario deja 

de desplazarse. 



Scroll 

Devuelve el nombre real del evento de ActiveX que se produce. 

Tipo Serie 


OCXEvent 

Indica 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 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

%SrcCompName 

%SrcEvtName 

%SrcPartName 

%SrcWinName 




Cuando 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 de 

notificación. Si se utiliza un componente referencia a componente lógico para 

supervisar varios eventos, este atributo de evento puede determinar el origen 

exacto del evento que desencadena el evento Notify utilizando el atributo 

%SrcCompName en combinación con los atributos %SrcWinName, %SrcPartName 

y %SrcEvtName. 

Tipo Serie 


Notify 


este atributo de evento devuelve el nombre del evento que se estableció en el 

atributo NotSrcEvt, junto con un componente y una ventana determinados, para 

desencadenar un evento Notify al componente referencia a componente lógico. 

Tipo Serie 


Notify 


este atributo de evento devuelve el nombre del componente que se estableció en el 

atributo NotSrcPart, junto con un componente y una ventana determinados, para 


Tipo Serie 


Notify 


este atributo de evento devuelve el nombre de la ventana que se estableció en el 

atributo NotSrcWin, junto con un componente y un evento determinados, para 


Tipo Serie 


%Window 


Notify 

Indica el nombre de la ventana que contiene el componente que ha generado el 

evento. 

Tipo Serie 


A todos 


Glosario 

A 

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 desea 

adquirir una copia de esta publicación debe dirigirse al American National 

Standards Institute, 1430 Broadway, New York, New York, 10018. Las 

definiciones 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 el 

International Electrotechnical Committee (ISO/IEC JTC1/SC1). Las definiciones 

de las partes publicadas de este vocabulario se identifican mediante el símbolo 

(|) después de las mismas; las definiciones tomadas de borradores de estándares 

internacionales, borradores del comité y documentos de trabajo desarrollados 

por ISO/IEC JTC1/SC1 se identifican mediante el símbolo (T) después de las 

mismas, lo cual indica que aún no se ha alcanzado un acuerdo definitivo entre 

los 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. 

acción. (1) Sinónimo de subrutina de acción. (2) Programa ejecutable o archivo de mandatos utilizado para manipular 

los 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 otros 

componentes. 

anotaciones de error. Realiza un seguimiento de los errores en las anotaciones de error. El editor le lleva al lugar 

del 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 un 

sistema. 

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 archivo 

puede incluir información que inicia un programa (objeto de archivo de programa), contiene texto o gráficos (objeto 

de 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 fuente 

de 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 de 

la aplicación. 

archivo MIDI. Archivo de la Interfaz Digital de Instrumentos Musicales. 


archivos JAR (.jar). En Java, abreviatura de Java ARchive. Es un formato de archivo que se utiliza para agregar 

varios 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 y 

selecciona opciones de campos de selección. En ventanas primarias, el área en la que un programador de aplicaciones 

presenta 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 en 

los que se encuentra el cursor. El área de información también puede incluir un mensaje sobre la conclusión normal 

de 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 cierra 

un área de trabajo, todas las ventanas abiertas a partir de objetos contenidos en el área de trabajo se eliminan del 

lugar de trabajo. 

Arquitectura Common User Access (arquitectura CUA). Directrices para el diálogo entre una persona y una 

estació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 una 

ventana 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 el 

ratón. 

ASCII (American National Standard Code for Information Interchange). Código estándar, que se compone de un 

juego de caracteres codificados de 7 bits (8 bits incluyendo comprobación de paridad), que se utiliza para el 

intercambio de información entre sistemas de proceso de datos, sistemas de comunicación de datos y equipo 

asociado. 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 ni 

manipular directamente ese componente. 

B 

barra de desplazamiento. Componente que muestra a un usuario que hay más información disponible en una 

dirección determinada y que puede moverse para visualizar dicha información utilizando el ratón o las teclas de 

página. 

barra de estado. Componente de una ventana que visualiza información que indica el estado de la vista o del objeto 

actuales. 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 usuario 

puede 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, previa 

petició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 a 

un programa durante el tiempo de carga o el de ejecución, en lugar de durante el enlace. Varias aplicaciones pueden 

compartir 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 se 

selecciona para cambiar el tamaño del componente (o del conjunto de componentes) utilizando el ratón o el teclado. 


orde de selección. Borde visual que aparece alrededor de un componente de VARPG o de un componente creado 

por 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 el 

botó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ón 

de 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 el 

tamañ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 una 

ventana del lugar de trabajo sin cerrarla. Cuando la ventana está oculta, el estado de la misma, indicado en la lista de 

ventanas, 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 el 

puntero. 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 haber 

maximizado una ventana. Cuando se selecciona el botón de restaurar, la ventana vuelve a tener el tamaño y la 

posició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. 

C 

campo. (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 entrada 

puede heredar. 

campo de subarchivo. Campo utilizado para definir campos en un componente subarchivo. Véase también campo 

subarchivo. 

Capa de Sockets Segura (SSL). Esquema de seguridad de gran aceptación desarrollado por Netscape 

Communications Corp. y RSA Data Security, Inc. SSL permite al cliente autenticarse en el servidor y cifrar todos los 

datos 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 interfaces 

gráficas de usuario para aplicaciones VARPG. 

cliente. (1) Sistema que depende de un servidor para obtener datos. (2) La PWS donde se ejecutan las aplicaciones 

VARPG. 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 componente 

cliente 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ón 

envía una petición a un programa en otra ubicación y espera una respuesta. El programa que efectúa la petición 

recibe el nombre de cliente; y el programa que responde, servidor. Véase también cliente, servidor, cliente DDE, servidor 

DDE. 

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 programas 

VARPG. 

componente barra de desplazamiento horizontal. Componente que añade una barra de desplazamiento horizontal 

a una ventana. Este componente permite desplazarse por un panel de información de izquierda a derecha o 

viceversa. 

componente barra de desplazamiento vertical. Componente que añade una barra de desplazamiento vertical a una 

ventana. 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 un 

proceso 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 y 

encima del resto de la ventana, que contiene opciones que proporcionan acceso a otros menús. En VisualAge RPG, se 

señala y pulsa un componente barra de menús de la paleta de componentes o del catálogo de componentes y se 

suelta 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 Sun 

Microsystem. 

componente botón de selección. Círculo con texto al lado. Los botones de selección se combinan para mostrar a un 

usuario 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 de 

componentes 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 incluir 

texto, color u otros atributos. 

componente campo de entrada. Área de una pantalla donde un usuario pueden entrar información, a menos que el 

campo sea de sólo lectura. Normalmente, los límites de un campo de entrada están indicados. En VisualAge RPG, se 

señala y pulsa un componente campo de entrada de la paleta de componentes o del catálogo de componentes y se 

suelta 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 cada 

componente 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, en 

Windows, 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 componente 

cuaderno y agrupar las páginas en secciones separadas por hojas separadoras con pestañas. En Windows, a veces se 

hace referencia al cuaderno como el control de pestaña de Windows. Véase también componente página de cuaderno y 

componente página de cuaderno con lienzo. 

componente de activeX. Componente que añade objetos de control ActiveX al proyecto. Las aplicaciones VARPG 

pueden 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 ha 

personalizado, 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 tal 

como se haría con otro componente de VARPG. 


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 varios 

campos. 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 al 

usuario entrar varias líneas de texto. 

componente elemento de menú. Componente que es un elemento gráfico o de texto en un menú. Cuando el 

usuario desea trabajar con un objeto, selecciona un elemento de menú. 

componente fuente. Componente que, siempre que cambia su estado, puede notificarlo a los componentes de 

destino. Un componente origen puede tener varios destinos. 

componente graduador. Componente visual de una interfaz de usuario que representa una cantidad y su relación 

con 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 y 

soltarlo 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áfico 

disponibles 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 organizarlos 

para producir una interfaz gráfica de usuario. El componente lienzo ocupa el área de cliente de un componente 

ventana o de un componente página de cuaderno. Véase también componente página de cuaderno con lienzo y 

componente ventana con lienzo. 

componente lógico. Agrupación funcional de archivos relacionados dentro de un proyecto. Un componente lógico 

se 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 objeto 

con el que está asociado cuando se solicita. Puede señalar y pulsar un componente menú emergente de la paleta de 

componentes 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 de 

datos 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éase 

también cuaderno. 

componente página de cuaderno con lienzo. Combinación del componente cuaderno y del componente página con 

lienzo. 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 usuario 

selecciona el pulsador. Puede señalar y pulsar un componente pulsador de la paleta de componentes o del catálogo 

de 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 cuando 

un usuario lo selecciona. Compárese con componente pulsador. 

componente recuadro de contorno. Componente que es un recuadro rectangular colocado alrededor de un grupo de 

componentes 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án 

relacionados y que proporciona una etiqueta opcional para el grupo. En VisualAge RPG, se señala y pulsa un 

componente recuadro de grupo de la paleta de componentes o del catálogo de componentes y se suelta en una 

ventana de diseño. 

componente recuadro de lista. Control que contiene opciones desplazables que un usuario puede seleccionar. En 

VisualAge RPG, se señala y pulsa un componente recuadro de lista de la paleta de componentes o del catálogo de 

componentes 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. Cuando 

un 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. En 

VisualAge RPG, se señala y pulsa un componente recuadro de selección de la paleta de componentes o del catálogo 

de 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 comunique 

con 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 se 

excluyen mutuamente, por el que un usuario puede desplazarse y seleccionar una opción. El usuario también puede 

teclear una opción válida en el campo de entrada. Puede señalar y pulsar un componente selector cíclico de la paleta 

de 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 texto 

suministrado en la lógica del programa. 

componente submenú. Componente utilizado para iniciar un submenú a partir de un elemento de menú o de un 

menú existente, o para iniciar un menú desplegable a partir de un elemento de menú en una barra de menú. Véase 

también submenú y componente elemento de menú. 

componente temporizador. Componente utilizado para hacer un seguimiento del intervalo de tiempo entre dos 

eventos y desencadenar el segundo evento cuando ha transcurrido el intervalo. 

componente texto estático. Componente utilizado como etiqueta para otros componentes, como solicitud para un 

componente campo de entrada. 

componente ventana. Área con límites visibles que representa una vista de un objeto o con la que un usuario 

mantiene un diálogo con un sistema. Puede señalar y pulsar un componente ventana de la paleta de componentes o 

del 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én 

componente 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. Con 

ello pueden evitarse errores de compilación. Esta opción puede activarse o desactivarse. Puede visualizarse sólo 

determinados 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 de 

datos entre Java y una amplia gama de bases de datos. JDBC proporciona una interfaz de programación de 

aplicaciones (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 sistemas 

operativos 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án 

organizados 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 una 

aplicació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 de 

enlace estático y conversación de enlace dinámico. 


conversación de enlace dinámico. En DDE, actualización automática de un programa cliente por un programa 

servidor 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 programa 

servidor. 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áginas 

separadas en secciones por páginas separadoras. Seleccione las pestañas de un cuaderno para ir de una sección a 

otra. 

cursor. Indicación visible de la posición en la que aparecerá la interacción de usuario con el teclado. 

D 

DBCS. 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 un 

procedimiento. Se utiliza para declarar los parámetros de entrada para el procedimiento y para garantizar que la 

definició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 de 

la 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. 

E 

EBCDIC. 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 con 

un 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 superior 

izquierda en una hoja de cálculo es fila 1, columna 1. Se puede hacer referencia a la posición de la casilla como el 

elemento R1C1. 

eliminar referencia. Acción de suprimir la asociación entre un componente y un campo de base de datos de 

AS/400. 

énfasis. Resaltado, cambio de color u otra indicación visible de condiciones relativas a un objeto o una opción que 

afecta a la capacidad del usuario de interactuar con ese objeto u opción. El énfasis también puede proporcionar a un 

usuario 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 trabajo 

programable. 

estación de trabajo programable (PWS). Estación de trabajo que tiene un cierto grado de capacidad de proceso y 

que 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, al 

accionar un pulsador se genera el evento Press. 

evento de enlace. Evento que un componente destino recibe siempre que cambia el estado de un componente 

fuente. 

excepción. (1) En lenguajes de programación, una situación anormal que se da durante la ejecución, que puede 

ocasionar una desviación de la secuencia normal de ejecución, para la que existen recursos en los lenguajes de 

programación a fin de definirla, activarla, reconocerla, ignorarla y manejarla. (I) (2) En VisualAge RPG, un evento o 

situación que impide, o puede impedir, que una acción solicitada por un usuario concluya tal como éste espera. Las 

excepciones 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 la 

aplicación. Compárese con importar. 

F 

foco. 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 o 

desde el ratón. 

I 

ICO. 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 recuadros 

de combinación. 

INI. Extensión de archivo para un archivo del sistema operativo OS/2 o Windows que contiene información 

especí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 de 

archivo de datos. Cualquier cambio efectuado en la información de un programa o una sesión se aplica a los datos 

idé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 un 

programa bajo licencia que se solicita por separado, que permite que un programa de aplicación escrito en un 

lenguaje 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 alta 

resolución. Una interfaz gráfica de usuario incluye una combinación de gráficos, el paradigma de acción de objeto, el 

uso 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 una 

Máquina Virtual Java (JVM) interoperar con las funciones escritas en otros lenguajes de programación. 

IPF. Recurso de Presentación de Información. 

J 

Java. Lenguaje de programación orientado a objeto para código interpretado portátil que soporta la interacción entre 

objetos remotos. Java y sus especificaciones han sido desarrolladas por Sun Microsystems, Incorporated. 


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 desarrolladores 

que deseen redistribuir el JRE. El JRE consiste en la Máquina Virtual Java, las Clases de Núcleo de Java y los archivos 

de soporte. 

Java 2 Software Development Kit (J2SDK). Software que distribuye Sun Microsystems a los desarrolladores de 

Java. Este software incluye el interpretador Java, clases Java y herramientas de desarrollo Java. Las herramientas de 

desarrollo incluyen un compilador, un depurador, un desensamblador, un AppletViewer, un generador de archivos de 

apé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 2 

bytes. Algunos idiomas como el japonés, el chino o el coreano, que contienen más símbolos de los que pueden 

representarse mediante los 256 elementos de código, necesitan el juego de caracteres de doble byte. Puesto que cada 

carácter necesita 2 bytes, la escritura, la visualización y la impresión de caracteres DBCS necesita hardware y 

programas que soporten DBCS. El sistema soporta cuatro juegos de caracteres de doble byte: japonés, coreano, chino 

simplificado 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 un 

byte. Compárese con juego de caracteres de doble byte (DBCS). 

L 

lí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 opciones 

permanecen ocultas hasta que el usuario realiza una acción específica para visualiza el recuadro de lista que las 

contiene. 

lugar de trabajo. Área que ocupa toda la pantalla y contiene todos los objetos que componen la interfaz del usuario. 

M 

Máquina Virtual Java (JVM). La parte del Java Runtime Environment (JRE) responsable de interpretar bytecodes de 

Java. 

marcador de grupo. Marcador que identifica un componente como el primero de un grupo. Cuando el usuario 

desplaza 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 un 

evento no esperado o cuando puede producir algo no deseado. (2) Comunicación enviada por una persona o un 

programa a otra persona u otro programa. 

menú. Lista de opciones que pueden aplicarse a un objeto. Un menú puede contener opciones que no estén 

disponibles 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 del 

menú 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 opciones 

adecuadas 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 palabra 

clave EXE está presente en la especificación de control. Todas las subrutinas (BEGSR) deben ser locales a un 

procedimiento. El EXE debe contener un procedimiento cuyo nombre coincida con el nombre del archivo fuente. Este 

será 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 de 

usuario autónoma. Un módulo NOMAIN se crea cuando la palabra clave NOMAIN se encuentra en la especificación 

de control. 

N 

nemotécnico. Un solo carácter, dentro del texto de una opción, identificado por un subrayado debajo de él. Véase 

también selección nemotécnica. 

nivel del graduador. Indicador visual en el graduador que un usuario puede mover para modificar el valor 

numérico. 

O 

objeto. (1) Espacio de almacenamiento con nombre que consiste en un conjunto de características que describen el 

espacio de almacenamiento en sí y, en algunos casos, datos. Un objeto es algo que existe en el almacenamiento y 

ocupa 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 puede 

efectuar 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. 

P 

paleta de colores. Conjunto de colores que pueden utilizarse para cambiar el color de cualquier componente en la 

GUI de la aplicación. 

paleta de componentes. El grupo de componentes más adecuado para construir la interfaz gráfica de usuario actual 

para una aplicación. Cuando finaliza la GUI, puede vaciar la paleta y añadir los componentes del catálogo de 

componentes 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 la 

aplicación. 

panel de navegación. Grupo de botones que se pueden utilizar para controlar la selección visible de registros en un 

subarchivo. 

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ón 

selecciona 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ón 

CALLP. 

procedimiento principal. Un procedimiento principal es un subprocedimiento que puede especificarse como 

procedimiento de entrada del programa y que recibe el control cuando se le llama por primera vez. El procedimiento 

principal 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árquicamente 

que 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) 


proyecto. Conjunto de datos y acciones completo necesarios para construir un destino único, como una biblioteca de 

enlace 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 doble 

pulsación. 

puntero del ratón. Sinónimo de cursor. 

PWS. Estación de trabajo programable. 

R 

ratón. Dispositivo con uno o más pulsadores que se utilizan para colocar un puntero en la pantalla sin usar el 

teclado. Se utiliza para seleccionar una opción o una función que se ha de efectuar o para llevar a cabo operaciones 

en 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 seleccionar 

para completar el campo de entrada. Si lo desea, el usuario también puede escribir texto directamente en el campo de 

entrada. En VisualAge RPG, se señala y pulsa un componente recuadro de combinación de la paleta de componentes 

o 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á oculto 

hasta 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 de 

trabajo programable. 

resaltado de símbolos. Mejora la legibilidad del código. Puede configurar el resaltado de diferentes elementos del 

lenguaje con diferentes colores o fonts para identificar las estructuras del programa. Puede activar o desactivar el 

resaltado de símbolos. 

S 

SBCS. 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 un 

mó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écnico 

de 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 de 

componentes en la ventana de diseño, la vista de iconos o la vista de árbol de la GUI. (2) Para colocar un 

componente en cualquiera de las vistas, señale y pulse el componente; después, mueva el cursor a la ventana elegida 

y señale y suelte el componente donde desea que aparezca. En las vistas de iconos y de árbol, el componente se 

colocará en el componente padre, y tendrá que moverlo al lugar donde le interese que aparezca en la ventana de 

diseñ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. El 

usuario 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 opciones 

relacionadas con dicho menú. Los submenús se utilizan para reducir la longitud de un menú desplegable o de un 

menú emergente. Véase también componente submenú. 

subprocedimiento. Procedimiento especificado después de la sección fuente principal. Debe tener un prototipo 

correspondiente 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. 

T 

tema. 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 los 

usuarios puedan colocar el foco en el mismo cuando utilicen la tecla tabuladora para moverse por la interfaz. 

V 

valor por omisión. Valor que el sistema o un programa proporciona o presupone automáticamente cuando el 

usuario no especifica ninguno. El valor por omisión puede asignarse a un pulsador oaunpulsador gráfico. 

ventana activa. Ventana con la que un usuario interactúa actualmente. Esta es la ventana que recibe la entrada del 

teclado. 

ventana de diseño. Ventana en el diseñador GUI en la que se colocan componentes para crear una interfaz de 

usuario. 

ventana emergente. Ventana movible, de tamaño fijo, en la que un usuario proporciona información necesaria para 

una 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 de 

ventana principal. 

ventana principal. Véase ventana primaria. 

ventana secundaria. Ventana que contiene información que depende de la información de una ventana primaria y 

se utiliza para complementar la interacción en dicha ventana. Véase también ventana primaria. Sinónimo de ventana 

emergente. 

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 proporcionar 

informació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 un 

icono. 

W 

WAV. Extensión de archivo de un archivo de ondas. 


Bibliografía 

Para obtener información adicional sobre temas relacionados con VisualAge RPG y 

CODE (Cooperative Development Environment) para AS/400, consulte las 

siguientes publicaciones de IBM: 

Manuales de WebSphere Development Tools para AS/400: 

*Nota: Se han actualizado todas las versiones en línea de las publicaciones de 

WebSphere Development Tools para AS/400. Las publicaciones cuyo 

número de pedido está marcado con un asterisco (*) no se han vuelto a 

imprimir 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, de 

cómo funcionan juntas y de las ventajas empresariales que se obtienen al 

utilizarlas. 

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 utiliza 


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 de 

VARPG. 

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 con 


v Programación con VisualAge para RPG, SC10-3067-02 (SC09-2449-02)*, contiene 

informació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 de 

programación para clarificar los conceptos y el proceso de desarrollo de 

aplicaciones 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 muy 

apropiado en el mundo de Java. También incluye una guía de aprendizaje 

interactiva 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 CD 

que enseña RPG IV e ILE, paso a paso y de un modo divertido. Se trata de un 

manual con preguntas y ejercicios que ayudan a adquirir experiencia práctica 

con esta nueva y apasionante versión de RPG. 

v Otra publicación que no es de IBM interesante para los usuarios de VisualAge 

RPG 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: 


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 la 

planificación necesaria para hacer un uso efectivo de la función Gestor para el 

Desarrollo 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 proyectos 

definidos 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ón 

de la función Gestor para el Desarrollo de Aplicaciones ADM del producto 

ADTS para OS/400. Esta guía muestra cómo utilizar la función Gestor para el 

Desarrollo de Aplicaciones ADM guiándole a través de una serie de ejercicios 

paso a paso. 

v ADTS/400: Application Development Manager API Reference, SC09-2180-00, describe 

cómo los programadores de aplicaciones pueden escribir su propia interfaz para 

la 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). IPF 

es una herramienta que soporta el diseño y el desarrollo de documentos en línea 

y 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 la 

información necesaria para utilizar y administrar el producto DB2. 

v DB2 Universal Database Embedded SQL Programming Guide S10J-8158, describe 

cómo diseñar y codificar programas de aplicación para acceder a los servidores 

de la familia DB2 Client/Server (como DB2 o DB2/400). Contiene información 

detallada sobre la utilización del SQL (Lenguaje de Consulta Estructurada) y 

llamadas de API en las aplicaciones. 


Avisos 

Esta información se ha elaborado para productos y servicios que se ofrecen en 

Estados Unidos. IBM puede no ofrecer los productos, servicios o características que 

se tratan en este documento en otros países. Consulte con el representante local de 

IBM para obtener información sobre los productos y servicios que están 

disponibles 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 puede 

utilizarse ese producto, programa o servicio de IBM. En su lugar puede utilizarse 

cualquier producto, programa o servicio funcionalmente equivalente que no 

infrinja ningún derecho de propiedad intelectual de IBM. Sin embargo, es 

responsabilidad del usuario evaluar y verificar el funcionamiento de todos los 

productos, programas o servicios que no sean de IBM. 

IBM puede tener patentes o aplicaciones pendientes de patente acerca del tema de 

este documento. La entrega de este documento no le otorga ninguna licencia sobre 

dichas patentes. Puede enviar consultas sobre licencias, por escrito, a: 

Director of Licensing 

Intellectual Property & Licensing 

International Business Machines Corporation 

North Castle Drive, MD - NC119 

Armonk, New York 10504-1785 

Estados Unidos 

El párrafo siguiente no procede en el Reino Unido ni en ningún otro país donde 

tales estipulaciones sean contradictorias con las leyes locales: INTERNATIONAL 

BUSINESS MACHINES CORPORATION PROPORCIONA ESTA PUBLICACIÓN “ 

TAL CUAL” SIN GARANTÍA DE NINGUNA CLASE, NI EXPRESA NI 

IMPLÍCITA, INCLUSIVE, PERO SIN LIMITARSE A, LAS GARANTÍAS 

IMPLÍCITAS DE NO VULNERACIÓN, COMERCIALIZACIÓN O ADECUACIÓN 

A UN FIN DETERMINADO. En determinados países no se permite la declaración 

de limitación de responsabilidad de las garantías expresas ni implícitas en 

determinadas transacciones, por lo tanto, esta declaración puede no ser procedente 

en su caso. 

Esta información puede contener inexactitudes técnicas o errores tipográficos. Se 

efectúan cambios periódicos en la información contenida en este documento; tales 

cambios se incorporarán en nuevas ediciones de la publicación. IBM puede hacer 

mejoras y/o modificaciones en los productos y/o programas descritos en esta 

publicación en cualquier momento sin previo aviso. 

Las referencias hechas en esta información a páginas Web de terceros se 

proporcionan sólo como gentileza para los usuarios y de ninguna manera pueden 

interpretarse como aprobación de esas páginas Web. Los materiales que figuran en 

esas páginas Web no forman parte de los materiales para este producto de IBM y 

la utilización de tales páginas Web es responsabilidad del usuario. 

Los licenciatarios de este programa que deseen obtener información acerca del 

mismo con el fin de: (i) intercambiar la información entre programas creados 

independientemente y otros programas (incluyendo éste) y (ii) utilizar mutuamente 

la información que se ha intercambiado, deben ponerse en contacto con: 

IBM Canada Ltd. 


Department 071 

1150 Eglinton Avenue East 

Toronto, Ontario M3C 1H7 

Canadá 

Dicha información estará disponible de acuerdo con las condiciones oportunas, que 

en algunos casos puede incluir el pago de una cantidad. 

IBM proporciona el programa bajo licencia descrito en esta información y todo el 

material bajo licencia disponible para él según los términos del Contrato de Cliente 

IBM, Contrato de Licencia de Programa Internacional IBM o cualquier contrato 

equivalente entre nosotros. 

Información de interfaz de programación 

Esta publicación pretende ayudarle a crear y gestionar aplicaciones e interfaces de 

usuario 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 la 

información de guía asociada que proporciona VisualAge RPG y CODE/400. 

Marcas registradas y marcas de servicio 

Los términos siguientes son marcas registradas de International Business Machines 

Corporation en Estados Unidos y/o en otros países: 

Application System/400 AS/400 AS/400e 

Common User Access CUA DATABASE 2 

DB2 DB2 Connect DB2 Universal Database 

IBM OS/400 SQL/DS 

VisualAge 400 

Java y todas las marcas registradas basadas en Java son marcas registradas o 

nombres comerciales de Sun Microsystems, Inc. en Estados Unidos y/u otros 

países. 

ActiveX, Microsoft, Windows y Windows NT son marcas registradas de Microsoft 

Corporation en Estados Unidos y/o en otros países. 

Otros nombres de empresas, productos y servicios pueden ser marcas registradas o 

marcas de servicio de otras firmas. 


Número de Programa: 5769-CL3 

Printed in Denmark by IBM Danmark A/S 

SC10-3065-04

VisualAge RPG Parts Reference - IBM

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?