added wxWindow::AlwaysShowScrollbars() and its wxMac implementation

[wxWidgets.git] / docs / latex / wx / dataviewcolumn.tex

\section{\class{wxDataViewColumn}}\label{wxdataviewcolumn}


This class represents a column in a \helpref{wxDataViewCtrl}{wxdataviewctrl}.
One wxDataViewColumn is bound to one column in the data model,
to which the wxDataViewCtrl has been associated. 

An instance of \helpref{wxDataViewRenderer}{wxdataviewrenderer} is used by
this class to render its data.

\wxheading{Constants}

These flags define behaviour of the column:

{\small
\begin{verbatim}
enum wxDataViewColumnFlags
{
    wxDATAVIEW_COL_RESIZABLE  = 1,    // the user can resize the column
    wxDATAVIEW_COL_SORTABLE   = 2,    // same as SetSortable()
    wxDATAVIEW_COL_HIDDEN     = 4     // column is hidden
};
\end{verbatim}
}

\wxheading{Derived from}

\helpref{wxObject}{wxobject}

\wxheading{Include files}

<wx/dataview.h>

\wxheading{Library}

\helpref{wxAdv}{librarieslist}


\latexignore{\rtfignore{\wxheading{Members}}}

\membersection{wxDataViewColumn::wxDataViewColumn}\label{wxdataviewcolumnwxdataviewcolumn}

\func{}{wxDataViewColumn}{\param{const wxString\& }{title}, \param{wxDataViewRenderer* }{renderer}, \param{unsigned int }{model\_column}, \param{int }{width = wxDVC\_DEFAULT\_WIDTH}, \param{wxAlignment }{align = wxALIGN\_CENTRE}, \param{int }{flags = wxDATAVIEW\_COL\_RESIZABLE}}

\func{}{wxDataViewColumn}{\param{const wxBitmap\& }{bitmap}, \param{wxDataViewRenderer* }{renderer}, \param{unsigned int }{model\_column}, \param{int }{width = wxDVC\_DEFAULT\_WIDTH}, \param{wxAlignment }{align = wxALIGN\_CENTRE}, \param{int }{flags = wxDATAVIEW\_COL\_RESIZABLE}}

Constructors.


\membersection{wxDataViewColumn::\destruct{wxDataViewColumn}}\label{wxdataviewcolumndtor}

\func{}{\destruct{wxDataViewColumn}}{\void}

Destructor.

\membersection{wxDataViewColumn::GetBitmap}\label{wxdataviewcolumngetbitmap}

\func{const wxBitmap\&}{GetBitmap}{\void}

Returns the bitmap in the header of the column, if any.

\membersection{wxDataViewColumn::GetModelColumn}\label{wxdataviewcolumngetmodelcolumn}

\func{unsigned int}{GetModelColumn}{\void}

Returns the index of the column of the model, which this
wxDataViewColumn is displaying.

\membersection{wxDataViewColumn::GetOwner}\label{wxdataviewcolumngetowner}

\func{wxDataViewCtrl*}{GetOwner}{\void}

Returns the owning \helpref{wxDataViewCtrl}{wxdataviewctrl}.

\membersection{wxDataViewColumn::GetRenderer}\label{wxdataviewcolumngetrenderer}

\func{wxDataViewRenderer*}{GetRenderer}{\void}

Returns the renderer of this wxDataViewColumn.

See also \helpref{wxDataViewRenderer}{wxdataviewrenderer}.

\membersection{wxDataViewColumn::GetSortable}\label{wxdataviewcolumngetsortable}

\func{bool}{GetSortable}{\void}

Returns true if the column is sortable.

See \helpref{SetSortable}{wxdataviewcolumnsetsortable}

\membersection{wxDataViewColumn::GetWidth}\label{wxdataviewcolumngetwidth}

\func{int}{GetWidth}{\void}

Returns the width of the column.

\membersection{wxDataViewColumn::IsSortOrderAscending}\label{wxdataviewcolumnissortorderascending}

\func{bool}{IsSortOrderAscending}{\void}

Returns true, if the sort order is ascending.

See also \helpref{SetSortOrder}{wxdataviewcolumnsetsortorder}

\membersection{wxDataViewColumn::SetAlignment}\label{wxdataviewcolumnsetalignment}

\func{void}{SetAlignment}{\param{wxAlignment }{align}}

Set the alignment of the column header.

\membersection{wxDataViewColumn::SetBitmap}\label{wxdataviewcolumnsetbitmap}

\func{void}{SetBitmap}{\param{const wxBitmap\& }{bitmap}}

Set the bitmap of the column header.

\membersection{wxDataViewColumn::SetSortOrder}\label{wxdataviewcolumnsetsortorder}

\func{void}{SetSortOrder}{\param{bool }{ascending}}

Indicate the sort order if the implementation of the
wxDataViewCtrl supports it, most commonly by showing
a little arrow. 

\membersection{wxDataViewColumn::SetSortable}\label{wxdataviewcolumnsetsortable}

\func{void}{SetSortable}{\param{bool }{sortable}}

Indicate that the column is sortable. This does
not show any sorting indicate yet, but it does
make the column header clickable. Call 
\helpref{SetSortOrder}{wxdataviewcolumnsetsortorder}
afterwards to actually make the sort indicator appear.
If {\it sortable} is false, the column header is
no longer clickable and the sort indicator (little
arrow) will disappear.

\membersection{wxDataViewColumn::SetTitle}\label{wxdataviewcolumnsettitle}

\func{void}{SetTitle}{\param{const wxString\& }{title}}

Set the title of the column header to {\it title}.