Grooper Help - Version 25.0
25.0.0017 2,127
  • Overview
  • Help Status

Principal List

Reflection List GrooperReview.Controls.PropertyGrid

Displays a list of security principals (i.e. users or groups) in a tabular, interactive format for selection and management.

Remarks

Overview

The Principal List control presents a collection of security principals—users or groups—in a table layout, supporting multi-selection, icons, and interactive features for efficient review and management. It is used within the ACL Editor to display both the current access list and search results.

UI Components

  • Table/Grid Layout:
    • Each principal is shown as a row, with columns for display name, description, and other relevant attributes.
    • Icons visually distinguish users (person) from groups (group).
    • Supports fixed-width columns for consistent layout.
  • Selection Controls:
    • Click to select a row; use Ctrl + click for multi-select, Shift + click for range selection.
    • Selected rows are visually highlighted.
  • Icons:
    • User entries display a person icon; group entries display a group icon.
    • Icons provide quick visual cues for principal type.

Interactive Features

  • Multi-Select:
    • Select multiple principals for batch actions, such as removal from the ACL.
  • Keyboard Navigation:
    • Up/Down: Move between rows.
    • Home/End: Jump to the first or last entry.
    • Shift + Up/Down: Multi-select.
    • Shift + Home/End: Multi-select to first or last entry.
  • Mouse Operations:
    • Double-click to add a principal from search results to the ACL.
    • Click to select or deselect entries.

Usage Guidance

Use Principal List to review, select, and manage users or groups in the ACL Editor. Icons and descriptions help identify principal types. Leverage multi-select and keyboard shortcuts for efficient batch operations.

  • For large lists, use search and filtering to quickly locate principals.
  • Use icons to distinguish between users and groups at a glance.
  • Integrate with batch actions for streamlined permission management.

Accessibility

  • Fully navigable by keyboard and mouse.
  • Screen reader support for row and column data, including icons.
  • Visual highlighting for selection and focus.

Example

| Display Name | Type | Description | |------------------|--------|--------------------| | John Doe | User | Accounting Manager | | Administrators | Group | Full Access |

Used By

Notification