File indexing completed on 2024-11-24 04:34:43
0001 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 0002 <html> 0003 <!-- This document is an unofficial reference manual for LaTeX, a 0004 document preparation system, version of November 2018. 0005 0006 This manual was originally translated from LATEX.HLP v1.0a in the 0007 VMS Help Library. The pre-translation version was written by 0008 George D. Greenwade of Sam Houston State University. The 0009 LaTeX 2.09 version was written by Stephen Gilmore. The 0010 LaTeX2e version was adapted from this by Torsten Martinsen. Karl 0011 Berry made further updates and additions, and gratefully acknowledges 0012 using Hypertext Help with LaTeX, by Sheldon Green, and 0013 LaTeX Command Summary (for LaTeX 2.09) by 0014 L. Botway and C. Biemesderfer (published by the TeX Users 0015 Group as TeXniques number 10), as reference material. We also 0016 gratefully acknowledge additional material appearing in 0017 latex2e-reference by Martin Herbert Dietze. (From these references no 0018 text was directly copied.) 0019 0020 Copyright 2007, 2008, 2009, 2010, 2011, 2012, 2013, 0021 2014, 2015, 2016, 2017, 2018 Karl Berry. 0022 0023 Copyright 1988, 1994, 2007 Stephen Gilmore. 0024 0025 Copyright 1994, 1995, 1996 Torsten Martinsen. 0026 0027 Permission is granted to make and distribute verbatim copies of 0028 this manual provided the copyright notice and this permission notice 0029 are preserved on all copies. 0030 0031 0032 Permission is granted to copy and distribute modified versions of this 0033 manual under the conditions for verbatim copying, provided that the entire 0034 resulting derived work is distributed under the terms of a permission 0035 notice identical to this one. 0036 0037 Permission is granted to copy and distribute translations of this manual 0038 into another language, under the above conditions for modified versions. --> 0039 <!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ --> 0040 <head> 0041 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 0042 <title>\multicolumn (LaTeX2e unofficial reference manual (November 2018))</title> 0043 0044 <meta name="description" content="\multicolumn (LaTeX2e unofficial reference manual (November 2018))"> 0045 <meta name="keywords" content="\multicolumn (LaTeX2e unofficial reference manual (November 2018))"> 0046 <meta name="resource-type" content="document"> 0047 <meta name="distribution" content="global"> 0048 <meta name="Generator" content="makeinfo"> 0049 <link href="index.html#Top" rel="start" title="Top"> 0050 <link href="IndexDocument.html#Index" rel="index" title="Index"> 0051 <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> 0052 <link href="tabular.html#tabular" rel="up" title="tabular"> 0053 <link href="_005cvline.html#g_t_005cvline" rel="next" title="\vline"> 0054 <link href="tabular.html#tabular" rel="prev" title="tabular"> 0055 <style type="text/css"> 0056 <!-- 0057 /* $Id: latex2e.css 690 2018-09-15 15:20:19Z jimhefferon $ 0058 Minor css for latexrefman. Public domain. 0059 Originally written by Jim Hefferon and Karl Berry, 2018. */ 0060 0061 /* So you can style for yourself */ 0062 @import url("/css/latexreflocal.css"); 0063 0064 0065 0066 a.summary-letter {text-decoration: none} 0067 blockquote.indentedblock {margin-right: 0em} 0068 blockquote.smallindentedblock {margin-right: 0em; font-size: smaller} 0069 blockquote.smallquotation {font-size: smaller} 0070 div.display {margin-left: 3.2em} 0071 div.example {margin-left: 3.2em} 0072 div.lisp {margin-left: 3.2em} 0073 div.smalldisplay {margin-left: 3.2em} 0074 div.smallexample {margin-left: 3.2em} 0075 div.smalllisp {margin-left: 3.2em} 0076 kbd {font-style: oblique} 0077 pre.display {font-family: inherit} 0078 pre.format {font-family: inherit} 0079 pre.menu-comment {font-family: serif} 0080 pre.menu-preformatted {font-family: serif} 0081 pre.smalldisplay {font-family: inherit; font-size: smaller} 0082 pre.smallexample {font-size: smaller} 0083 pre.smallformat {font-family: inherit; font-size: smaller} 0084 pre.smalllisp {font-size: smaller} 0085 span.nolinebreak {white-space: nowrap} 0086 span.roman {font-family: initial; font-weight: normal} 0087 span.sansserif {font-family: sans-serif; font-weight: normal} 0088 ul.no-bullet {list-style: none} 0089 BODY { 0090 margin-top: 1em; 0091 margin-left: 1em; /* auto results in two-digit <ol> lost off left */ 0092 margin-right: 1em; 0093 margin-bottom: 1em; 0094 /* the idea is to use the whole window, unless it is ridiculously 0095 wide, probably with too-small fonts, too. */ 0096 max-width: 64em; 0097 } 0098 0099 /* Because we want @math{... @code ...} to be upright, not slanted, 0100 and Texinfo won't fix it. */ 0101 code {font-style:normal; font-family:monospace; } 0102 0103 /* We put a link to our own home page at the bottom. */ 0104 div.referenceinfo {font-size:small;} 0105 0106 --> 0107 </style> 0108 0109 0110 </head> 0111 0112 <body lang="en"> 0113 <a name="g_t_005cmulticolumn"></a> 0114 <div class="header"> 0115 <p> 0116 Next: <a href="_005cvline.html#g_t_005cvline" accesskey="n" rel="next">\vline</a>, Up: <a href="tabular.html#tabular" accesskey="u" rel="up">tabular</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="IndexDocument.html#Index" title="Index" rel="index">Index</a>]</p> 0117 </div> 0118 <hr> 0119 <a name="g_t_005cmulticolumn-1"></a> 0120 <h4 class="subsection">8.23.1 <code>\multicolumn</code></h4> 0121 0122 <a name="index-_005cmulticolumn"></a> 0123 0124 <p>Synopsis: 0125 </p> 0126 <div class="example"> 0127 <pre class="example">\multicolumn{<var>numcols</var>}{<var>cols</var>}{<var>text</var>} 0128 </pre></div> 0129 0130 <p>Make an <code>array</code> or <code>tabular</code> entry that spans several columns. 0131 The first argument <var>numcols</var> gives the number of columns to span. 0132 The second argument <var>cols</var> specifies the formatting of the entry, 0133 with <code>c</code> for centered, <code>l</code> for flush left, or <code>r</code> for 0134 flush right. The third argument <var>text</var> gives the contents of that 0135 entry. 0136 </p> 0137 <p>In this example, in the first row, the second and third columns are 0138 spanned by the single heading ‘<samp>Name</samp>’. 0139 </p> 0140 <div class="example"> 0141 <pre class="example">\begin{tabular}{lccl} 0142 \textit{ID} &\multicolumn{2}{c}{\textit{Name}} &\textit{Age} \\ 0143 \hline 0144 978-0-393-03701-2 &O'Brian &Patrick &55 \\ 0145 ... 0146 \end{tabular} 0147 </pre></div> 0148 0149 <p>What counts as a column is: the column format specifier for the 0150 <code>array</code> or <code>tabular</code> environment is broken into parts, where 0151 each part (except the first) begins with <code>l</code>, <code>c</code>, <code>r</code>, 0152 or <code>p</code>. So from <code>\begin{tabular}{|r|ccp{1.5in}|}</code> 0153 the parts are <code>|r|</code>, <code>c</code>, <code>c</code>, 0154 and <code>p{1.5in}|</code>. 0155 </p> 0156 <p>The <var>cols</var> argument overrides the <code>array</code> or <code>tabular</code> 0157 environment’s intercolumn area default adjoining this multicolumn 0158 entry. To affect that area, this argument can contain vertical bars 0159 <code>|</code> indicating the placement of vertical rules, and <code>@{...}</code> 0160 expressions. Thus if <var>cols</var> is ‘<samp>|c|</samp>’ then this multicolumn 0161 entry will be centered and a vertical rule will come in the intercolumn 0162 area before it and after it. This table details the exact behavior. 0163 </p> 0164 <div class="example"> 0165 <pre class="example">\begin{tabular}{|cc|c|c|} 0166 \multicolumn{1}{r}{w} % entry one 0167 &\multicolumn{1}{|r|}{x} % entry two 0168 &\multicolumn{1}{|r}{y} % entry three 0169 &z % entry four 0170 \end{tabular} 0171 </pre></div> 0172 0173 <p>Before the first entry the output will not have a vertical rule because 0174 the <code>\multicolumn</code> has the <var>cols</var> specifier ‘<samp>r</samp>’ with no 0175 initial vertical bar. Between entry one and entry two there will be a 0176 vertical rule; although the first <var>cols</var> does not have an ending 0177 vertical bar, the second <var>cols</var> does have a starting one. Between 0178 entry two and entry three there is a single vertical rule; despite that 0179 the <var>cols</var> in both of the surrounding <code>multicolumn</code>’s call for 0180 a vertical rule, you only get one rule. Between entry three and entry 0181 four there is no vertical rule; the default calls for one but the 0182 <var>cols</var> in the entry three <code>\multicolumn</code> leaves it out, and 0183 that takes precedence. Finally, following entry four there is a 0184 vertical rule because of the default. 0185 </p> 0186 <p>The number of spanned columns <var>numcols</var> can be 1. Besides giving 0187 the ability to change the horizontal alignment, this also is useful to 0188 override for one row the <code>tabular</code> definition’s default intercolumn 0189 area specification, including the placement of vertical rules. 0190 </p> 0191 <p>In the example below, in the <code>tabular</code> definition the first column 0192 is specified to default to left justified but in the first row the entry 0193 is centered with <code>\multicolumn{1}{c}{\textsc{Period}}</code>. 0194 Also in the first row, the second and third columns are spanned by a 0195 single entry with <code>\multicolumn{2}{c}{\textsc{Span}}</code>, 0196 overriding the specification to center those two columns on the page 0197 range en-dash. 0198 </p> 0199 <div class="example"> 0200 <pre class="example">\begin{tabular}{l|r@{--}l} 0201 \multicolumn{1}{c}{\textsc{Period}} 0202 &multicolumn{2}{c}{\textsc{Span}} \\ \hline 0203 Baroque &1600 &1760 \\ 0204 Classical &1730 &1820 \\ 0205 Romantic &1780 &1910 \\ 0206 Impressionistic &1875 &1925 0207 \end{tabular} 0208 </pre></div> 0209 0210 <p>Although the <code>tabular</code> specification by default puts a vertical 0211 rule between the first and second columns, no such vertical rule appears 0212 in the first row here. That’s because there is no vertical bar in the 0213 <var>cols</var> part of the first row’s first <code>\multicolumn</code> command. 0214 </p> 0215 0216 0217 0218 <hr/><div class='referenceinfo'> <a href='https://latexref.xyz/'> <i>Unofficial LaTeX2e reference manual</i></a></div> 0219 </body> 0220 </html>