<HTML>
<HEAD>
<link type="text/css" href="../css/main_styles.css" rel="stylesheet"></HEAD>
<BODY>
<TITLE>mqc_askAnnotationText</TITLE>
<H1>mqc_askAnnotationText</H1><H4>Synopsis</H4><PRE><FONT COLOR = blue>Defun: mqc_askAnnotationText(
       Integer, $annotation_tag,
       Boolean ( $multi_lines, false ) )
@{...} List;

</FONT></PRE><PRE STYLE=\"text-align : left;\" CLASS=\"Code\">

<B>Description:</B>
Ask text strings of the specified drafting annotation.

<B>Input:</B>
     ( Integer ) annotation_tag - A tag of note, label, ID symbol, dimension,
                                  tabular note or parts list.
     ( Boolean ) multi_lines    - Return the multiplie lines text or not.
                                  FALSE, the drafting annotation text is single line.
                                  TRUE, the drafting annotation text is multiple lines.

<B>Input Arguments:</B>
annotation_tag - A tag of note, label, ID symbol, dimension, tabular note or parts list
multi_lines - Return the multiplie lines text or not

<B>Returns:</B>
A list of text
      1) Input is the tag of note, label or ID symbol
                ( List ) - A list of text strings which are in the specified note, label or ID symbol.
                           If multi_lines mode is FALSE, the return list format is:
                                { (String)note_text };
                           If multi_lines mode is TRUE, the return list format is:
                                {
                                 (String)note_line_1_text,
                                 (String)note_line_2_text,
                                 ...,
                                 (String)note_line_n_text
                                }
                Example, if a note is:
                        This is an annota
                        tion text.
                If multi_lines mode is FALSE, the return list is:
                        { "This is an annotation text." }
                If multi_lines mode is TRUE, the return list is:
                        {
                         "This is an annota-",
                         "tion text."
                        }
        2) Input is the tag of dimension
                ( List ) - A list of text sub-lists.
                           Each sub-list contains one type text strings appended to the dimension.
                               {
                                {above_appended_text sub-list},
                                {below_appended_text sub-list},
                                {before_appended_text sub-list},
                                {after_appended_text sub-list}
                               }
                           If a dimension does not have one type apended text block, the
                           corresponding apended_text sub-list will be {} in the return list.
                If multi_lines mode is False, return format is:
                        {
                         {(String) above_appended_text},
                         {(String) below_appended_text},
                         {(String) before_appended_text},
                         {(String) after_appended_text}
                        }
                If multi_lines mode is True, return format is:
                        {
                         {(String) above_appended_text_1,
                                   above_appended_text_2,
                                   ...,
                                   above_appended_text_n
                         },
                         {(String) below_appended_text_1,
                                   below_appended_text_2,
                                   ...,
                                   below_appended_text_n
                         },
                         {(String) before_appended_text_1,
                                   before_appended_text_2,
                                   ...,
                                   before_appended_text_n
                         },
                         {(String) after_appended_text_1,
                                   after_appended_text_2,
                                   ...,
                                   after_appended_text_n
                         }
                        }
                Example, a dimension has two appended texts as following:
                        This is above-appended-text
                        block
                        63.7
                        This is below-appended-text
                        block
                If multi_lines mode is FALSE, the return list is:
                {
                 { "This is above-appended-text block" },
                 { "This is below-appended-text block" },
                 {},
                 {}
                }
                If multi_lines mode is TRUE, the return list is:
                {
                 { "This is above-appended-text",
                   "block"},
                 { "This is below-appended-text",
                   "block"},
                 {},
                 {}
                }
        3) Input is the tag of tabular note or parts list
                ( List ) -  A list of all the cell texts and their locations in the tabular note.
                Format:
                {
                 {(String)  cell_1_text,
                  (Integer) cell_1_row_number,
                  (Integer) cell_1_col_number
                 },
                 {(String)  cell_2_text,
                  (Integer) cell_2_row_number,
                  (Integer) cell_2_col_number
                 },
                 ...,
                 {(String)  cell_n_text,
                  (Integer) cell_n_row_number,
                  (Integer) cell_n_col_number
                 }
                }
                If the tabular note has no cell text, the return list is an empty list.
                Example, if a tabular note has only two cell texts, "Steel" in cell (1, 2),
                and "Aluminum" in cell (3, 4), then the return list is following:
                {
                 {"Stell", 1, 2},
                 {"Aluminum", 3, 4}
                }

<B>See Also:</B>
</PRE></FONT></PRE>
<p class=EndLine>&nbsp;</p>
<p class=blank>&nbsp;</p>
</BODY>
</HTML>
