TouchBar.GetPrincipalItemIdentifier
-----------------------------------

Queries the principal item identifier.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [TouchBar](component_TouchBar.md) | [6.5](newinversion65.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No |

MBS( "TouchBar.GetPrincipalItemIdentifier"; TouchBarRef ) 

**MBS**( **"TouchBar.GetPrincipalItemIdentifier";** /\* Queries the principal item identifier. \*/  
**$TouchBarRef**) /\* The reference number for the touch bar.e.g. $TouchBar \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| TouchBarRef | The reference number for the touch bar. | $TouchBar |

### Result

Returns text or error.

### Description

Queries the principal item identifier.  
Specifying a principal item identifier communicates that the item with that identifier has special significance to this touch bar. Currently, that item will be placed in the center of the resolved touch row. Note that multiple visible bars may each specify a principal item identifier - but only one of them can have the request honored.  
### See also

- [TouchBar.GetDefaultItemIdentifiers](TouchBarGetDefaultItemIdentifiers.md)
- [TouchBar.SetPrincipalItemIdentifier](TouchBarSetPrincipalItemIdentifier.md)

This function checks for a license.

Created 1st November 2016 , last changed 1st November 2016

  
[TouchBar.GetItemIdentifiers](TouchBarGetItemIdentifiers.md) - [TouchBar.List](TouchBarList.md)

[HTML Version](TouchBarGetPrincipalItemIdentifier.shtml)