TAdvListEditor is a visual UI component included in the commercial TMS VCL UI Pack bundle for Delphi and C++Builder development. It is designed to let users input and edit a list of items flexibly, mimicking the modern “tokenized” tag entry style seen in Microsoft Outlook’s recipient fields or iOS email address inputs.
Instead of typing plain text separated by punctuation, user entries are converted into distinct, interactive visual blocks (tags). Key Features
Tokenized Tag Input: When a user types text and presses the designated separator key (the default is a semi-colon ;), the text instantly transforms into an isolated tag or bubble.
Easy Item Management: Users can select individual tags using the keyboard or mouse and remove them simply by pressing the DEL key. Individual entries can also be double-clicked for instant editing.
Rich Metadata Binding: Beyond just capturing the display text, every entered item can hold hidden internal values or hyperlink URLs, making it easy to associate database IDs or email addresses with user-friendly names.
Visual Enhancements: It natively supports linking to a standard TImageList, allowing you to display icons or profile avatars right next to the text inside each tag.
Read-Only Interaction: If configured as Read-Only, the component locks text input but still allows the user to click the tags like independent buttons, which triggers custom events. Common Use Cases
Email Formats: Replicating “To”, “CC”, or “BCC” address lines where user names turn into independent contact tokens.
Social Media & Blogs: Tag editors for posts, keywords, or categorization systems where cross-platform UI uniformity is required.
Filter Criteria: Allowing users to quickly specify multiple independent filter options (e.g., selecting multiple statuses or departments) within a single compact box. Important Methods & Events
If you are developing with TAdvListEditor, these are the core hooks and properties you will interact with:
Values Property: This provides programmatic access to the collection of items. You can check the count using AdvListEditor1.Values.Count.
ValueEditDone Event: The recommended event to hook into when checking or validating user input right after they finalize a token.
OnValueClick Event: Fires when a user clicks a tag, passing the specific ValueIndex so you can retrieve its display text, hidden value, or execute a hyperlink redirect. AI responses may include mistakes. Learn more TAdvListEditor and TAB key – TMS VCL UI Pack
Leave a Reply