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

\section{\class{wxWeakRefDynamic<T>}}\label{wxweakrefdynamic}

wxWeakRefDynamic<T> is a template class for weak references that is used in 
the same way as wxWeakRef<T>. The only difference is that wxWeakRefDynamic 
defaults to using \texttt{dynamic\_cast<>} for establishing the object 
reference (while wxWeakRef defaults to \texttt{static\_cast<>}). 

So, wxWeakRef will detect a type mismatch during compile time and will
have a little better run-time performance. The role of wxWeakRefDynamic
is to handle objects which derived type one does not know. 

\textbf{Note:} wxWeakRef<T> selects an implementation based on the static type 
of T. If T does not have wxTrackable statically, it defaults to to a mixed-
mode operation, where it uses \texttt{dynamic\_cast<>} as the last measure (if 
available from the compiler and enabled when building wxWidgets). 

For general cases, wxWeakRef<T> is the better choice. 

For API documentation, see: \helpref{wxWeakRef}{wxweakref}


\wxheading{Derived from}

No base class

\wxheading{Include files}

<wx/weakref.h>

\wxheading{Library}

\helpref{wxCore}{librarieslist}


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


\membersection{wxWeakRefDynamic::wxWeakRefDynamic}\label{wxweakrefdynamicwxweakrefdynamic}

\func{}{wxWeakRefDynamic}{\void}

TOWRITE.
Commit	Line	Data
cc6ceca7 VZ	1	\section{\class{wxWeakRefDynamic<T>}}\label{wxweakrefdynamic}
	2
	3	wxWeakRefDynamic<T> is a template class for weak references that is used in
	4	the same way as wxWeakRef<T>. The only difference is that wxWeakRefDynamic
	5	defaults to using \texttt{dynamic\_cast<>} for establishing the object
	6	reference (while wxWeakRef defaults to \texttt{static\_cast<>}).
	7
	8	So, wxWeakRef will detect a type mismatch during compile time and will
	9	have a little better run-time performance. The role of wxWeakRefDynamic
	10	is to handle objects which derived type one does not know.
	11
	12	\textbf{Note:} wxWeakRef<T> selects an implementation based on the static type
	13	of T. If T does not have wxTrackable statically, it defaults to to a mixed-
	14	mode operation, where it uses \texttt{dynamic\_cast<>} as the last measure (if
	15	available from the compiler and enabled when building wxWidgets).
	16
	17	For general cases, wxWeakRef<T> is the better choice.
	18
	19	For API documentation, see: \helpref{wxWeakRef}{wxweakref}
	20
6d1f75ad FM	21
	22	\wxheading{Derived from}
	23
	24	No base class
	25
	26	\wxheading{Include files}
	27
	28	<wx/weakref.h>
	29
	30	\wxheading{Library}
	31
	32	\helpref{wxCore}{librarieslist}
	33
	34
	35	\latexignore{\rtfignore{\wxheading{Members}}}
	36
	37
	38	\membersection{wxWeakRefDynamic::wxWeakRefDynamic}\label{wxweakrefdynamicwxweakrefdynamic}
	39
	40	\func{}{wxWeakRefDynamic}{\void}
	41
	42	TOWRITE.