<--- Cannot embed stylesheet: [Errno 2] No such file or directory: '../../../../aros.css' --->

Poplist.mui

MUIA_Poplist_Array

Function

Supply the initial list entries.

Inputs

Initialize only, pointer to a NULL-terminated array of NUL-terminated
string pointers; default NULL for an empty list. No local setter or
getter.

Notes

The array is passed to List_SourceArray during construction. The array
itself is consumed then; without construct hooks the entry strings
remain borrowed for subsequent display, comparisons and accepted
selection. This is not an owned copy of each string. Matching is
case-insensitive and selects the first match; a missing match does not
prevent opening.

MUIC_Poplist

Superclass

Popobject.mui

Description

Provide a Listview popup backed by a List and synchronize its active
entry with a caller-supplied string. Construction creates the popup,
installs internal StrObjHook and ObjStrHook after superclass
construction, and registers double-click acceptance. It returns NULL on
superclass failure. Supply the inherited Popstring button and a
compatible String object; no string or button is created here.

Methods

Before opening, compare String_Contents with entries using stricmp,
selecting the first case-insensitive match. If none matches, set
List_Active_Off and still allow opening. On accepted close, retrieve the
active entry through the Listview and set String_Contents only when an
entry exists. No String_Acknowledge is set here.
Double-click invokes Close(TRUE), whose actual copy occurs later through
Popstring's queued hook. Cancellation leaves the string unchanged. The
popup window and contents follow Popobject ownership and lifecycle
rules.

Notes

The built-in List has no string construct/destruct hooks, so source
entry pointers remain borrowed rather than copied. Keep entry strings
valid while the popup uses them. Preserve the built-in popup/child
arrangement: supplying an overriding Popobject_Object can leave internal
list references inconsistent. Caller conversion hooks supplied at
construction are replaced by Poplist's internal hooks.