X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/93255dade69278a97b83e36b0263146f3e1e30ad..4346581b7c6548fdef1486564787154d20a401df:/docs/latex/wx/display.tex diff --git a/docs/latex/wx/display.tex b/docs/latex/wx/display.tex index 628cee6b98..e1525547ca 100644 --- a/docs/latex/wx/display.tex +++ b/docs/latex/wx/display.tex @@ -10,6 +10,10 @@ None +\wxheading{Library} + +\helpref{wxCore}{librarieslist} + \wxheading{See also} \helpref{wxClientDisplayRect}{wxclientdisplayrect}, \helpref{wxDisplaySize}{wxdisplaysize}, \helpref{wxDisplaySizeMM}{wxdisplaysizemm} @@ -17,9 +21,9 @@ None \latexignore{\rtfignore{\wxheading{Members}}} -\membersection{wxDisplay::wxDisplay}\label{wxdisplayconstr} +\membersection{wxDisplay::wxDisplay}\label{wxdisplayctor} -\func{}{wxDisplay}{\param{size\_t }{index = 0}} +\func{}{wxDisplay}{\param{unsigned }{index = 0}} Constructor, setting up a wxDisplay instance with the specified display. @@ -29,20 +33,62 @@ Constructor, setting up a wxDisplay instance with the specified display. 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::GetClientArea}\label{wxdisplaygetclientarea} + +\constfunc{wxRect }{GetClientArea}{\void} + +Returns the client area of the display. The client area is the part of the +display available for the normal (non full screen) windows, usually it is the +same as \helpref{GetGeometry}{wxdisplaygetgeometry} but it could be less if +there is a taskbar (or equivalent) on this display. + +\wxheading{See also:} + +\helpref{wxClientDisplayRect}{wxclientdisplayrect} + + \membersection{wxDisplay::GetCount}\label{wxdisplaygetcount} -\func{static size\_t}{GetCount}{\void} +\func{static unsigned }{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} @@ -54,14 +100,29 @@ Returns the bit depth of the display whose index was passed to the constructor. \func{static int}{GetFromPoint}{\param{const wxPoint\& }{pt}} -Returns the index of the display on which the given point lies. Returns -1 if -the point is not on any connected display. +Returns the index of the display on which the given point lies. Returns +\texttt{wxNOT\_FOUND} if the point is not on any connected display. \wxheading{Parameters} \docparam{pt}{The point to locate.} +\membersection{wxDisplay::GetFromWindow}\label{wxdisplaygetfromwindow} + +\func{static int}{GetFromWindow}{\param{const wxWindow* }{win}} + +Returns the index of the display on which the given window lies. + +If the window is on more than one display it gets the display that overlaps the window the most. + +Returns \texttt{wxNOT\_FOUND} if the window is not on any connected display. + +\wxheading{Parameters} + +\docparam{win}{The window to locate.} + + \membersection{wxDisplay::GetGeometry}\label{wxdisplaygetgeometry} \constfunc{wxRect }{GetGeometry}{\void} @@ -69,26 +130,26 @@ the point is not on any connected display. Returns the bounding rectangle of the display whose index was passed to the constructor. +\wxheading{See also:} -\membersection{wxDisplay::GetName}\label{wxdisplaygetname} - -\constfunc{wxString }{GetName}{\void} - -Returns the display's name. A name is not available on all platforms. +\helpref{GetClientArea}{wxdisplaygetclientarea}, \helpref{wxDisplaySize}{wxdisplaysize} -\membersection{wxDisplay::IsColour}\label{wxdisplayiscolour} +\membersection{wxDisplay::GetModes}\label{wxdisplaygetmodes} -\constfunc{bool }{IsColour}{\void} +\constfunc{wxArrayVideoModes }{GetModes}{\param{const wxVideoMode\& }{mode = wxDefaultVideoMode}} -Returns true if the display is color (has a depth greater than 1). +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::IsColor}\label{wxdisplayiscolor} +\membersection{wxDisplay::GetName}\label{wxdisplaygetname} -\constfunc{bool }{IsColor}{\void} +\constfunc{wxString }{GetName}{\void} -Same as \helpref{IsColour()}{wxdisplayiscolour}. +Returns the display's name. A name is not available on all platforms. \membersection{wxDisplay::IsPrimary}\label{wxdisplayisprimary}