SapObject class

Wraps a COM object handle from the native SAP GUI Scripting bridge.

SapObject provides access to all SAP GUI Scripting properties and methods through typed Dart wrappers. Each instance holds a handle (integer pointer into the C++ g_objects map) and delegates calls to the native DLL via SapApi.

Memory management is automatic: when owned: true (default), a Finalizer calls Sap_Release when the object is garbage collected. Use owned: false when reusing a handle from another isolate (as in useSapSession).

Constructing

// Connect to SAP (returns a root SapObject)
final root = SapObject.connect(api);

// Wrap an existing handle (e.g. from another isolate)
final obj = SapObject(handle, api, owned: false);

Finding child objects

Properties like children, sessions, activeWindow return SapObject instances you can pass to typed wrappers:

final sessionObj = root.activeSession;
final session = GuiSession(sessionObj!);

See also:

• ISapObject — interface for mocking
• SapApi — the FFI bridge
• GuiComponent — typed wrapper base class