Progress
Language Reference
HANDLE Attribute
A handle to the object.
Data Type: WIDGET-HANDLEAccess: ReadableApplies To: Browse, Browse cell, Buffer Object Handle, Buffer-field Object Handle, Button, Combo-box, Dialog-box, Editor, Field-group, Fill-in, Frame, Image, Literal, Menu, Menu-item, Query Object Handle, Radio-set, Rectangle, Selection-list, Slider, Server-socket Object Handle, Socket Object Handle, Sub-menu, Text, Toggle-box, WindowYou can store this value in a WIDGET-HANDLE variable. You can also use it to associate one widget with another widget or with a system handle. For example, you can assign the HANDLE value of the menu bar to the MENU-BAR attribute of a window, or you can make the window the current window by assigning its HANDLE value to the CURRENT-WINDOW handle.
For query objects, the HANDLE attribute lets you acquire a query object for a static query, as the following fragment demonstrates:
The following code fragment uses the HANDLE attribute of a buffer-field to retrieve the buffer-field’s handle:
The preceding code fragment requires that you know the name of the field (in this case, “city”) at compile time. The following code fragment, which performs the same task, does not require this.
For more information on query, buffer, and buffer-field objects, see the Progress Programming Handbook .
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |