X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/669b0c0a0b5a3d529104256f678d985105a8a276..134198f1b773199b5506c302bf9510831d0319f5:/docs/latex/wx/colour.tex diff --git a/docs/latex/wx/colour.tex b/docs/latex/wx/colour.tex index 2c433298eb..0109378a5b 100644 --- a/docs/latex/wx/colour.tex +++ b/docs/latex/wx/colour.tex @@ -28,6 +28,10 @@ You can retrieve the current system colour settings with \helpref{wxSystemSettin +\wxheading{Library} + +\helpref{wxCore}{librarieslist} + \wxheading{Predefined objects} Objects: @@ -58,13 +62,13 @@ wxLIGHT\_GREY} Default constructor. -\func{}{wxColour}{\param{unsigned char}{ red}, \param{unsigned char}{ green}, \param{unsigned char}{ blue}} +\func{}{wxColour}{\param{unsigned char}{ red}, \param{unsigned char}{ green}, \param{unsigned char}{ blue}, \param{unsigned char}{ alpha=wxALPHA\_OPAQUE}} -Constructs a colour from red, green and blue values. +Constructs a colour from red, green, blue and alpha values. \func{}{wxColour}{\param{const wxString\& }{colourNname}} -Constructs a colour using the given string. See \helpref{Set}{wxcolourset3} for more info. +Constructs a colour using the given string. See \helpref{Set}{wxcolourset} for more info. \func{}{wxColour}{\param{const wxColour\&}{ colour}} @@ -78,6 +82,8 @@ Copy constructor. \docparam{blue}{The blue value.} +\docparam{alpha}{The alpha value. Alpha values range from 0 (wxALPHA\_TRANSPARENT) to 255 (wxALPHA\_OPAQUE).} + \docparam{colourName}{The colour name.} \docparam{colour}{The colour to copy.} @@ -95,6 +101,13 @@ Copy constructor. +\membersection{wxColour::Alpha}\label{wxcolouralpha} + +\constfunc{unsigned char}{Alpha}{\void} + +Returns the alpha value, on platforms where alpha is not yet supported, this always returns wxALPHA\_OPAQUE. + + \membersection{wxColour::Blue}\label{wxcolourblue} \constfunc{unsigned char}{Blue}{\void} @@ -106,17 +119,22 @@ Returns the blue intensity. \constfunc{wxString}{GetAsString}{\param{long}{ flags}} -Converts this colour to a \helpref{wxString}{wxstring} +Converts this colour to a \helpref{wxString}{wxstring} using the given {\it flags}. -The supported flags are {\bf wxC2S\_NAME}, to obtain the colour -name (e.g. wxColour(255,0,0) -> \texttt{``red"}), {\bf wxC2S\_CSS\_SYNTAX}, to obtain -the colour in the \texttt{``rgb(r,g,b)"} syntax -(e.g. wxColour(255,0,0) -> \texttt{``rgb(255,0,0)"}), and {\bf wxC2S\_HTML\_SYNTAX}, to obtain -the colour as \texttt{``\#"} followed by 6 hexadecimal digits -(e.g. wxColour(255,0,0) -> \texttt{``\#FF0000"}). +The supported flags are \textbf{wxC2S\_NAME}, to obtain the colour name (e.g. +wxColour(255,0,0) -> \texttt{``red"}), \textbf{wxC2S\_CSS\_SYNTAX}, to obtain +the colour in the \texttt{``rgb(r,g,b)"} or \texttt{``rgba(r,g,b,a)"} syntax +(e.g. wxColour(255,0,0,85) -> \texttt{``rgba(255,0,0,0.333)"}), and +\textbf{wxC2S\_HTML\_SYNTAX}, to obtain the colour as \texttt{``\#"} followed +by 6 hexadecimal digits (e.g. wxColour(255,0,0) -> \texttt{``\#FF0000"}). + +This function never fails and always returns a non-empty string but asserts if +the colour has alpha channel (i.e. is non opaque) but +\textbf{wxC2S\_CSS\_SYNTAX} (which is the only one supporting alpha) is not +specified in flags. -This function never fails and always returns a non-empty string. +\newsince{2.7.0} \membersection{wxColour::GetPixel}\label{wxcolourgetpixel} @@ -136,9 +154,9 @@ On X, an allocated pixel value is returned. Returns the green intensity. -\membersection{wxColour::Ok}\label{wxcolourok} +\membersection{wxColour::IsOk}\label{wxcolourisok} -\constfunc{bool}{Ok}{\void} +\constfunc{bool}{IsOk}{\void} Returns \true if the colour object is valid (the colour has been initialised with RGB values). @@ -152,27 +170,24 @@ Returns the red intensity. \membersection{wxColour::Set}\label{wxcolourset} -\func{void}{Set}{\param{unsigned char}{ red}, \param{unsigned char}{ green}, \param{unsigned char}{ blue}} - -Sets the RGB intensity values. - - -\membersection{wxColour::Set}\label{wxcolourset2} +\func{void}{Set}{\param{unsigned char}{ red}, \param{unsigned char}{ green}, \param{unsigned char}{ blue}, \param{unsigned char}{ alpha=wxALPHA\_OPAQUE}} \func{void}{Set}{\param{unsigned long}{ RGB}} -Sets the RGB intensity values extracting them from the packed long. - - -\membersection{wxColour::Set}\label{wxcolourset3} - \func{bool}{Set}{\param{const wxString \&}{ str}} -Sets the colour using the given string. -Accepts colour names (those listed in \helpref{wxTheColourDatabase}{wxcolourdatabase}), the CSS-like \texttt{``RGB(r,g,b)"} syntax (case insensitive) and the HTML-like syntax (i.e. \texttt{``\#"} followed by 6 hexadecimal digits for red, green, blue components). +Sets the RGB intensity values using the given values (first overload), extracting them from the packed long (second overload), using the given string (third overloard). + +When using third form, Set() accepts: colour names (those listed in +\helpref{wxTheColourDatabase}{wxcolourdatabase}), the CSS-like +\texttt{``rgb(r,g,b)"} or \texttt{``rgba(r,g,b,a)"} syntax (case insensitive) +and the HTML-like syntax (i.e. \texttt{``\#"} followed by 6 hexadecimal digits +for red, green, blue components). Returns \true if the conversion was successful, \false otherwise. +\newsince{2.7.0} + \membersection{wxColour::operator $=$}\label{wxcolourassign} @@ -193,14 +208,14 @@ Assignment operator, using a colour name to be found in the colour database. \func{bool}{operator $==$}{\param{const wxColour\&}{ colour}} -Tests the equality of two colours by comparing individual red, green blue colours. +Tests the equality of two colours by comparing individual red, green, blue colours and alpha values. \membersection{wxColour::operator $!=$}\label{wxcolourinequality} \func{bool}{operator $!=$}{\param{const wxColour\&}{ colour}} -Tests the inequality of two colours by comparing individual red, green blue colours. +Tests the inequality of two colours by comparing individual red, green, blue colours and alpha values. \section{\class{wxColourData}}\label{wxcolourdata} @@ -214,6 +229,10 @@ This class holds a variety of information related to colour dialogs. +\wxheading{Library} + +\helpref{wxCore}{librarieslist} + \wxheading{See also} \helpref{wxColour}{wxcolour}, \helpref{wxColourDialog}{wxcolourdialog}, \helpref{wxColourDialog overview}{wxcolourdialogoverview} @@ -326,6 +345,10 @@ None +\wxheading{Library} + +\helpref{wxCore}{librarieslist} + \wxheading{Remarks} The standard database contains at least the following colours: @@ -375,7 +398,7 @@ removed in the next wxWidgets version, please don't use it. \func{wxColour}{Find}{\param{const wxString\& }{colourName}} Finds a colour given the name. Returns an invalid colour object (that is, such -that its \helpref{Ok()}{wxcolourok} method returns \false) if the colour wasn't +that its \helpref{Ok()}{wxcolourisok} method returns \false) if the colour wasn't found in the database. @@ -385,3 +408,4 @@ found in the database. Finds a colour name given the colour. Returns an empty string if the colour is not found in the database. +