Een NSAppShellEventWindow biedt een plaatsaanduidingsvenster voor het Dock-pictogram dat is gekoppeld aan een app in de sandbox (vanaf OS X Yosemite). Zie Sandboxen in Cocoa voor meer informatie over sandboxen.

Vóór OS X Yosemite leek het Dock-pictogram van een app die op bestandssysteemniveau in een sandbox was geplaatst, ondoorzichtig, wat aangeeft dat de app geen toegang had tot specifieke bronnen. Met de introductie van App Transparency in OS X Yosemite tonen deze apps nu hun Dock-pictogram als actief.

Als een app een NSAppShellEventWindow in de bundel bevat, geeft het systeem het Dock-pictogram van de app weer als actief wanneer een van de volgende gebeurtenissen plaatsvindt:

* Het venster wordt sleutel als reactie op een muisklik of een andere activeringsgebeurtenis.

* Het venster geeft inhoud op het scherm weer door een Core Animation API aan te roepen, inclusief die van CALayer, CAMediaTimingFunction en UIViewPropertyAnimator.

* Het raam speelt een hoorbaar alarm of geluid af.

Zonder een NSAppShellEventWindow in de bundel zorgen deze zelfde gebeurtenissen er niet voor dat het Dock-pictogram van de app actief lijkt.

Discussie

De NSAppShellEventWindow is verborgen voor de gebruikersinterface en verschijnt nooit op het scherm. Het bestaat uitsluitend om de interactie tussen de sandboxcontainer van de app en het Dock te vergemakkelijken.

Een app kan meerdere NSAppShellEventWindows bevatten. Er kan er echter maar één tegelijk in een bepaalde sandboxcontainer voorkomen; een app kan pas een nieuw venster maken nadat een eerder gemaakt venster is gesloten.

U kunt NSAppShellEventWindows maken en beheren met behulp van de NSWorkspace API.