X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=otk%2Fproperty.hh;h=215f941f47b8d7021713e3f6003869a1665658f0;hb=c9f36d34a414123cec8ebc35c87b8b9d5673b155;hp=73a98e5dfa4b4d8b35952e5db388fa899f29b356;hpb=d2c380fb54a29a586b97ab6421370e7acdcf28e5;p=chaz%2Fopenbox diff --git a/otk/property.hh b/otk/property.hh index 73a98e5d..215f941f 100644 --- a/otk/property.hh +++ b/otk/property.hh @@ -141,15 +141,19 @@ public: kde_net_wm_system_tray_window_for, kde_net_wm_window_type_override, +#ifndef DOXYGEN_IGNORE // constant for how many atoms exist in the enumerator NUM_ATOMS +#endif }; //! The possible types/encodings of strings enum StringType { ascii, //!< Standard 8-bit ascii string utf8, //!< Utf8-encoded string +#ifndef DOXYGEN_IGNORE NUM_STRING_TYPE +#endif }; private: @@ -181,7 +185,7 @@ public: //! Destroys the OBAtom object virtual ~OBProperty(); - //! Sets a property on a window to a new value + //! Sets a single-value property on a window to a new value /*! @param win The window id of the window on which to set the property's value @param atom A member of the OBProperty::Atoms enum that specifies which @@ -191,7 +195,7 @@ public: @param value The value to set the property to */ void set(Window win, Atoms atom, Atoms type, unsigned long value) const; - //! Sets a property on a window to a new value + //! Sets an multiple-value property on a window to a new value /*! @param win The window id of the window on which to set the property's value @param atom A member of the OBProperty::Atoms enum that specifies which @@ -204,7 +208,7 @@ public: */ void set(Window win, Atoms atom, Atoms type, unsigned long value[], int elements) const; - //! Sets a property on a window to a new value + //! Sets a string property on a window to a new value /*! @param win The window id of the window on which to set the property's value @param atom A member of the OBProperty::Atoms enum that specifies which @@ -215,7 +219,7 @@ public: */ void set(Window win, Atoms atom, StringType type, const std::string &value) const; - //! Sets a property on a window to a new value + //! Sets a string-array property on a window to a new value /*! @param win The window id of the window on which to set the property's value @param atom A member of the OBProperty::Atoms enum that specifies which @@ -291,8 +295,8 @@ public: retrieve all possible strings, use "(unsigned) -1".
When the function returns, if it returns true, this will contain the actual number of strings retrieved.
- @param value If the function returns true, then this contains all of the - strings retrieved from the property's value. + @param strings If the function returns true, then this contains all of the + strings retrieved from the property's value. @return true if retrieval of the specified property with the specified type was successful; otherwise, false */ @@ -301,9 +305,9 @@ public: //! Removes a property from a window /*! - @param The window id of the window to remove the property from - @param A member of the OBProperty::Atoms enum that specifies which property - to remove from the window + @param win The window id of the window to remove the property from + @param atom A member of the OBProperty::Atoms enum that specifies which + property to remove from the window */ void erase(Window win, Atoms atom) const;