The [popover] command.

Introduction

The popover command lets you create and manipulate popover windows. They are transient windows used to display additional content related to existing content on the screen. A popover is positioned relative to the existing content.
The system automatically positions each popover relative to a positioning view or to some rectangle area within the positioning view.
Popover windows are closed in response to most user interactions. They can optionally be detached to become a separate window when they are dragged from their current position.

Synopsis

The formal syntax of the [popover] command is:
popover subcommand ?options?
The possible subcommands are described below. Depending on the subcommand, some options may be specified.

Popover subcommands

The [close] subcommand

This subcommand lets you close a popover. The complete syntax is:
    popover close token
Most user interactions automatically close the popover. However this subcommand provides a means to do so programmatically.

The [configure] subcommand

This subcommand lets you get or set some properties of a popover. The syntax can take two forms:
    popover configure token option
    popover configure token option value ?option value...?
In the first form the command returns the current value of the specified option. In the second form, it lets you set the value of one or several options.
The available options are described in the
Popover options section below.

The [create] subcommand

This subcommand creates a new popover. The complete syntax is:
    popover create ?option value? ?option value...?
It returns a token which can be used in the other popover subcommands. The possible options are described in the
Popover options section below.

The [delete] subcommand

This subcommand lets you delete a popover. The complete syntax is:
    popover delete token
After deletion, the token is no longer valid.

The [list] subcommand

This subcommand returns the list of the currently existing popover tokens. The syntax is:
    popover list

The [show] subcommand

This subcommand lets you display a popover. The complete syntax is:
    popover show token ?-rect {l b w h}? ?-parent viewToken? ?-edge num?
The popover to display is specified by its token. The options have the following meaning:
The possible values for the -edge option are:
NameValueDescription
Min X Edge0left edge
Min Y Edge1bottom edge
Max X Edge2right edge
Max Y Edge3top edge

Popover options

Here is the description of the various options which can be passed to the [popover create] or the [popover configure] commands: The possible values for the -appearance option are:
Standard appearance0
HUD appearance1

Examples



Last updated 2017-01-08 21:44:09