---
title: "tokenField(_:displayStringForRepresentedObject:)"
framework: appkit
role: symbol
role_heading: Instance Method
path: "appkit/nstokenfielddelegate/tokenfield(_:displaystringforrepresentedobject:)"
---

# tokenField(_:displayStringForRepresentedObject:)

Allows the delegate to provide a string to be displayed as a proxy for the given represented object.

## Declaration

```swift
@MainActor optional func tokenField(_ tokenField: NSTokenField, displayStringForRepresentedObject representedObject: Any) -> String?
```

## Parameters

- `tokenField`: The token field that sent the message.
- `representedObject`: A represented object of the token field.

## Return Value

Return Value The string to be used as a proxy for representedObject. If you return nil or do not implement this method, then representedObject is displayed as the string.

## See Also

### Related Documentation

- [Token Field Programming Guide](apple-archive/documentation/Cocoa/Conceptual/TokenField_Guide/Introduction.md)

### Displaying Tokenized Strings

- [tokenField(_:styleForRepresentedObject:)](appkit/nstokenfielddelegate/tokenfield(_:styleforrepresentedobject:).md)