AT Syntax

The AT syntax is used to define the position of a gadget’s origin within a form. The position may be specified absolutely (in form layout grid units) or relative to the extremities of existing gadgets, or relative to the size of the form and the gadget.

The rest of the Forms and Menus syntax is described in the Software Customization Reference documentation, in particular about conventions used in the syntax graphs. The AT syntax graph is the easiest way of illustrating all the possible options, and so it is included here:

>-- AT --+- val -- val ----------------------------.

+- X val ---------------------------------|

+- XMIN -. |

+- XCEN -| |

+- XMAX -+- <fgrel> -. |

'--------'-----------+- Y val ------------|

+- YMIN -. |

+- YCEN -| |

+- YMAX -+- <fgrel> -|

'--------'-----------'--->

Here, <FGREL> (shown below) sets the gadget position relative to another gadget or the form’s extent. For example, it can be used to position a gadget half-way across the width of a form:

>----+- <gname> -.

+-- FORM ---|

'-----------+- * val --.

+- + val --|

+- - val --+- + val * SIZE -.

| +- - val * SIZE -|

'----------+- + SIZE -------|

+- - SIZE -------|

'----------------'--->