An object you use to customize the behavior of people-picker views in an app's user interface.
SDK
- macOS 10.3+
Framework
- Address
Book
Declaration
class ABPeoplePickerView : NSView
An object you use to customize the behavior of people-picker views in an app's user interface.
SDK
Framework
class ABPeoplePickerView : NSView
func add Property(String!)
Adds a property to the group of properties whose values are shown in the record list.
func column Title(for Property: String!) -> String!
Returns the title of a custom property.
var displayed Property: String!
The property currently displayed in the record list.
func properties() -> [Any]!
Returns an array of the properties whose values are shown in the record list.
func remove Property(String!)
Removes a property from the group of properties whose values are shown in the record list.
func set Column Title(String!, for Property: String!)
Sets the title displayed in the people picker for a property.
var value Selection Behavior: ABPeople Picker Selection Behavior
The current selection behavior.
struct ABPeople Picker Selection Behavior
Constants indicating the possible value selection behaviors.
var allows Group Selection: Bool
A Boolean value that specifies whether the user can select entire groups in the group column.
var allows Multiple Selection: Bool
A Boolean value that specifies whether multiple groups, records, or values of multivalue properties can be selected at a time.
func deselect All(Any!)
Deselects all selected groups, records, and values in multivalue properties.
func deselect(ABGroup!)
Deselects a group selected in the group list.
func deselect Identifier(String!, for: ABPerson!)
Deselects a value selected in a multivalue property.
func deselect(ABRecord!)
Deselects a record selected in the record list.
var selected Groups: [Any]!
The groups selected in the group list. (read-only)
func selected Identifiers(for: ABPerson!) -> [Any]!
Returns the identifiers of the selected values in a multivalue property.
var selected Records: [Any]!
The selection in the records list. (read-only)
func selected Values() -> [Any]!
Returns an array of all the values selected in the displayed multivalue property.
func select(ABGroup!, by Extending Selection: Bool)
Selects a group or a set of groups in the group list.
func select Identifier(String!, for: ABPerson!, by Extending Selection: Bool)
Selects a value or a set of values in a multivalue property.
func select(ABRecord!, by Extending Selection: Bool)
Selects a record or a set of records in the record list.
var accessory View: NSView!
The view that is placed to the left of the search field.
func clear Search Field(Any!)
Clears the search field and resets the list of displayed records.
func edit In Address Book(Any!)
Launches Address Book to edit the item selected in the people picker.
var group Double Action: Selector!
The action to be invoked when a group is double-clicked.
var name Double Action: Selector!
The action to be invoked when a name is double-clicked.
func select In Address Book(Any!)
Launches Address Book and selects the item selected in the people picker.
var target: Any Object!
The target for double-click actions.
var autosave Name: String!
The name under which the column positions and the filter selection are saved.
static let ABPeople Picker Group Selection Did Change: NSNotification .Name
Posted when the selection in the group list is changed.
static let ABPeople Picker Name Selection Did Change: NSNotification .Name
Posted when the selection in the name list is changed.
static let ABPeople Picker Value Selection Did Change: NSNotification .Name
Posted when the selection in a multivalue property is changed.
static let ABPeople Picker Displayed Property Did Change: NSNotification .Name
Posted when the displayed property in the record list is changed.
class ABPerson View
An object that provides a view for displaying and editing contacts.