# Center caption in listing

I want to put the caption of my listing in the center but I can't do that. Do you have any idea how I could achieve this? The code:

\documentclass{report}
\usepackage{color}
\usepackage{xcolor}
\usepackage{listings}
\usepackage{caption}
\DeclareCaptionFont{white}{\color{white}}
\DeclareCaptionFormat{listing}{\colorbox{gray}{\parbox{\textwidth}{#1#2#3}}}
\captionsetup[lstlisting]{format=listing,labelfont=white,textfont=white}

% This concludes the preamble

\begin{document}

\begin{lstlisting}[label=some-code,caption=Some Code]
function <lhs_arguments>=<function_name><rhs_arguments>
<statements>
endfunction
\end{lstlisting}

\end{document}

-
Welcome to TeX.sx! Your post was migrated here from Stack Overflow. Please register on this site, too, and make sure that both accounts are associated with each other (by using the same OpenID), otherwise you won't be able to comment on or accept answers or edit your question. –  Werner Dec 26 '12 at 4:15

## migrated from stackoverflow.comDec 26 '12 at 3:59

This question came from our site for professional and enthusiast programmers.

Use the following:

\DeclareCaptionFormat{listing}
{\colorbox{gray}
{\parbox{\dimexpr\textwidth-2\fboxsep}{\centering #1#2#3}}}


This not only centres the caption, but ensures that the width of the caption "box" fits exactly within the text block width.

\documentclass{report}
\usepackage{xcolor,listings,caption}% http://ctan.org/pkg/{xcolor,listings,caption}
\DeclareCaptionFont{white}{\color{white}}
\DeclareCaptionFormat{listing}
{\colorbox{gray}
{\parbox{\dimexpr\textwidth-2\fboxsep}{\centering #1#2#3}}}
\captionsetup[lstlisting]{format=listing,labelfont=white,textfont=white}

% This concludes the preamble

\begin{document}

\begin{lstlisting}[label=some-code,caption=Some Code]
function <lhs_arguments>=<function_name><rhs_arguments>
<statements>
endfunction
\end{lstlisting}

\end{document}

-
This solution will not only change "short" captions to be centered, but "long" captions (which does not fit into a single line), too. –  Axel Sommerfeldt Dec 26 '12 at 11:15

The caption format will be used internally after applying the justification & font setting, and therefore the \colorbox will be centered but not the text inside the \colorbox.

One can fix that by applying the justification setting inside the colorbox (again) using the internal command \caption@hj:

\documentclass{report}
\usepackage{xcolor}
\usepackage{listings}
\usepackage{caption}
\makeatletter
\DeclareCaptionFormat{listing}{%
\colorbox{gray}{%
\parbox{\dimexpr \captionwidth-2\fboxsep}{\caption@hj #1#2#3}}}
\makeatother
\captionsetup[lstlisting]{format=listing,font={color=white}}

% This concludes the preamble

\begin{document}

\begin{lstlisting}[label=some-code,caption=Some Code]
function <lhs_arguments>=<function_name><rhs_arguments>
<statements>
endfunction
\end{lstlisting}

\end{document}


(Please note that I replaced \textwidth with \captionwidth so the margin & width settings will be used here, too.)

But a more naturally way of fixing this is changing the internal code which actually draws the box around the caption, i.e. redefining \caption@parbox:

\documentclass{report}
\usepackage{xcolor}
\usepackage{listings}
\usepackage{caption}[2007/12/23] % needs v3.1f or newer

\makeatletter
\DeclareCaptionOption{boxcolor}{%
\renewcommand\caption@parbox[2]{%
\colorbox{#1}{\parbox[b]{\dimexpr ##1-2\fboxsep}{##2}}}}
\makeatother
\captionsetup[lstlisting]{boxcolor=gray,font={color=white}}

% This concludes the preamble

\begin{document}

\begin{lstlisting}[label=some-code,caption=Some Code]
function <lhs_arguments>=<function_name><rhs_arguments>
<statements>
endfunction
\end{lstlisting}

\end{document}


(Although both \caption@hj and \caption@parbox are not documented this will work with future versions of the caption package, too.)

When using version 3.3 of the caption package this can be realized without using internal commands at all:

\documentclass{report}
\usepackage{xcolor}
\usepackage{listings}
\usepackage{caption}[2013/01/01] % needs v3.3 or newer
\captionsetup[lstlisting]{box=colorbox,boxcolor=gray,font={color=white}}

% This concludes the preamble

\begin{document}

\begin{lstlisting}[label=some-code,caption=Some Code]
function <lhs_arguments>=<function_name><rhs_arguments>
<statements>
endfunction
\end{lstlisting}

\end{document}


Addendum 2013-01-09: Since the version 3.3 of the caption package is available now the last solution is preferable.

-