Whole bunch of minor doc updates from an external patch.

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

diff --git a/docs/latex/wx/display.tex b/docs/latex/wx/display.tex
index 760660da5d5cd05d2630e79b3debc05b09303e05..1a1963f80dc3d1a5871ce085a8440eda4b13ba80 100644 (file)
--- a/docs/latex/wx/display.tex
+++ b/docs/latex/wx/display.tex
@@ -16,7 +16,8 @@ None
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
-\membersection{wxDisplay::wxDisplay}\label{wxdisplayconstr}
+
+\membersection{wxDisplay::wxDisplay}\label{wxdisplayctor}
 
 \func{}{wxDisplay}{\param{size\_t }{index = 0}}
 
@@ -25,27 +26,58 @@ Constructor, setting up a wxDisplay instance with the specified display.
 \wxheading{Parameters}
 
 \docparam{index}{The index of the display to use.  This must be non-negative
-and lower than the value returned by \helpref{GetCount()}{wxdisplaygetcount},
-inclusive.}
+and lower than the value returned by \helpref{GetCount()}{wxdisplaygetcount}.}
+
 
-\membersection{wxDisplay::\destruct{wxDisplay}}
+\membersection{wxDisplay::\destruct{wxDisplay}}\label{wxdisplaydtor}
 
 \func{void}{\destruct{wxDisplay}}{\void}
 
 Destructor.
 
+
+\membersection{wxDisplay::ChangeMode}\label{wxdisplaychangemode}
+
+\func{bool }{ChangeMode}{\param{const wxVideoMode\& }{mode = wxDefaultVideoMode}}
+
+Changes the video mode of this display to the mode specified
+in the mode parameter.
+
+If wxDefaultVideoMode is passed in as the mode parameter,
+the defined behaviour is that wxDisplay will reset the video
+mode to the default mode used by the display.  On Windows, 
+the behavior is normal.  However, there are differences on other
+platforms. On Unix variations using X11 extensions it should
+behave as defined, but some irregularities may occur.  
+
+On wxMac passing in wxDefaultVideoMode as the mode
+parameter does nothing.  This happens because carbon 
+no longer has access to DMUseScreenPrefs, an undocumented
+function that changed the video mode to the system
+default by using the system's 'scrn' resource.
+
+
 \membersection{wxDisplay::GetCount}\label{wxdisplaygetcount}
 
 \func{static size\_t}{GetCount}{\void}
 
 Returns the number of connected displays.
 
+
+\membersection{wxDisplay::GetCurrentMode}\label{wxdisplaygetcurrentmode}
+
+\constfunc{wxVideoMode }{GetCurrentMode}{\void}
+
+Returns the current video mode that this display is in. 
+
+
 \membersection{wxDisplay::GetDepth}\label{wxdisplaygetdepth}
 
 \constfunc{int }{GetDepth}{\void}
 
 Returns the bit depth of the display whose index was passed to the constructor.
 
+
 \membersection{wxDisplay::GetFromPoint}\label{wxdisplaygetfrompoint}
 
 \func{static int}{GetFromPoint}{\param{const wxPoint\& }{pt}}
@@ -57,6 +89,7 @@ the point is not on any connected display.
 
 \docparam{pt}{The point to locate.}
 
+
 \membersection{wxDisplay::GetGeometry}\label{wxdisplaygetgeometry}
 
 \constfunc{wxRect }{GetGeometry}{\void}
@@ -64,24 +97,38 @@ the point is not on any connected display.
 Returns the bounding rectangle of the display whose index was passed to the
 constructor.
 
+
+\membersection{wxDisplay::GetModes}\label{wxdisplaygetmodes}
+
+\constfunc{wxArrayVideoModes }{GetModes}{\param{const wxVideoMode\& }{mode = wxDefaultVideoMode}}
+
+Fills and returns an array with all the video modes that
+are supported by this display, or video modes that are 
+supported by this display and match the mode parameter
+(if mode is not wxDefaultVideoMode).
+
+
 \membersection{wxDisplay::GetName}\label{wxdisplaygetname}
 
 \constfunc{wxString }{GetName}{\void}
 
 Returns the display's name.  A name is not available on all platforms.
 
+
 \membersection{wxDisplay::IsColour}\label{wxdisplayiscolour}
 
 \constfunc{bool }{IsColour}{\void}
 
 Returns true if the display is color (has a depth greater than 1).
 
+
 \membersection{wxDisplay::IsColor}\label{wxdisplayiscolor}
 
 \constfunc{bool }{IsColor}{\void}
 
 Same as \helpref{IsColour()}{wxdisplayiscolour}.
 
+
 \membersection{wxDisplay::IsPrimary}\label{wxdisplayisprimary}
 
 \func{bool }{IsPrimary}{\void}