/usr/share/doc/libstarlink-ast-doc/node125.html is in libstarlink-ast-doc 8.6.2+dfsg-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!--Converted with LaTeX2HTML 2008 (1.71)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>Referring to the Base and Current Frames</TITLE>
<META NAME="description" CONTENT="Referring to the Base and Current Frames">
<META NAME="keywords" CONTENT="sun211">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="sun211.css">
<LINK REL="next" HREF="node126.html">
<LINK REL="previous" HREF="node124.html">
<LINK REL="up" HREF="node120.html">
<LINK REL="next" HREF="node126.html">
</HEAD>
<BODY >
<DIV CLASS="navigation"><!--Navigation Panel-->
<A NAME="tex2html1732"
HREF="node126.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
SRC="/usr/share/latex2html/icons/next.png"></A>
<A NAME="tex2html1730"
HREF="node120.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
SRC="/usr/share/latex2html/icons/up.png"></A>
<A NAME="tex2html1724"
HREF="node124.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
SRC="/usr/share/latex2html/icons/prev.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html1733"
HREF="node126.html">Using a FrameSet as</A>
<B> Up:</B> <A NAME="tex2html1731"
HREF="node120.html">Coordinate System Networks (FrameSets)</A>
<B> Previous:</B> <A NAME="tex2html1725"
HREF="node124.html">The Base and Current</A>
<BR>
<BR></DIV>
<!--End of Navigation Panel-->
<H2><A NAME="SECTION000135000000000000000"></A><A NAME="ss:astbaseandastcurrent"></A>
<BR>
Referring to the Base and Current Frames
</H2>
<P>
It is often necessary to refer to the base and current Frames
(§<A HREF="node124.html#ss:baseandcurrent">13.4</A>) within a FrameSetFrameSet, but it can be
cumbersome having to obtain their indices from the BaseBase and CurrentCurrent
attributes on each occasion. To make this easier, two macros,
AST__BASE and AST__CURRENT, are defined in the ``ast.h'' header
file and may be used to represent the indices of the base and current
Frames respectively. They may be used whenever a FrameFrame index is
required.
<P>
For example, when adding a new Frame to a FrameSet
(§<A HREF="node123.html#ss:addingframes">13.3</A>), you could use the following to indicate
that the new Frame is related to the existing current Frame, whatever
its index happens to be:
<P>
<SMALL CLASS="SMALL">
<BR>
<IMG
WIDTH="448" HEIGHT="110" ALIGN="BOTTOM" BORDER="0"
SRC="img208.png"
ALT="\begin{terminalv}
AstFrame *frame;
AstMapping *mapping;
\par
...
\par
astAddFrame( frameset, AST__CURRENT, mapping, frame );
\end{terminalv}">
<BR>
</SMALL>
<P>
Of course, the Frame you added would then become the new current
Frame.
<P>
<BR><HR>
</BODY>
</HTML>
|