SYSTEM-GET-NATIVE-HANDLE Action

This document covers the following topics:

Description

Queries the native handle of a dialog element in terms of the windowing system. You can use this native handle for external function calls.

Parameters

Name/Data Type Explanation
HANDLE OF GUI Input

The handle of the dialog element in Natural terms.

Native handle (I4) Output

The window handle of the dialog element in terms of the windowing system. For font controls, the native font handle is returned. For menu bars, menu items and submenu controls, the native menu handle is returned. For bitmap controls, the native bitmap handle is returned. For all other dialogs and dialog elements, the native window handle is returned.

Response (I4) Output

Natural error (if applicable).

Example: 

 
   PROCESS GUI ACTION SYSTEM-GET-NATIVE-HANDLE WITH #PB-1 #NATIVEHANDLE GIVING  
   #RESPONSE 
   #IF-1.STRING := #NATIVEHANDLE  /* Display the handle value