| OLD | NEW |
| (Empty) |
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | |
| 2 // Use of this source code is governed by a BSD-style license that can be | |
| 3 // found in the LICENSE file. | |
| 4 | |
| 5 #ifndef UI_NATIVE_THEME_NATIVE_THEME_H_ | |
| 6 #define UI_NATIVE_THEME_NATIVE_THEME_H_ | |
| 7 | |
| 8 #include "base/observer_list.h" | |
| 9 #include "third_party/skia/include/core/SkColor.h" | |
| 10 #include "ui/gfx/native_widget_types.h" | |
| 11 #include "ui/native_theme/native_theme_export.h" | |
| 12 | |
| 13 class SkCanvas; | |
| 14 | |
| 15 namespace gfx { | |
| 16 class Rect; | |
| 17 class Size; | |
| 18 } | |
| 19 | |
| 20 namespace ui { | |
| 21 | |
| 22 class NativeThemeObserver; | |
| 23 | |
| 24 // This class supports drawing UI controls (like buttons, text fields, lists, | |
| 25 // comboboxes, etc) that look like the native UI controls of the underlying | |
| 26 // platform, such as Windows or Linux. It also supplies default colors for | |
| 27 // dialog box backgrounds, etc., which are obtained from the system theme where | |
| 28 // possible. | |
| 29 // | |
| 30 // The supported control types are listed in the Part enum. These parts can be | |
| 31 // in any state given by the State enum, where the actual definition of the | |
| 32 // state is part-specific. The supported colors are listed in the ColorId enum. | |
| 33 // | |
| 34 // Some parts require more information than simply the state in order to be | |
| 35 // drawn correctly, and this information is given to the Paint() method via the | |
| 36 // ExtraParams union. Each part that requires more information has its own | |
| 37 // field in the union. | |
| 38 // | |
| 39 // NativeTheme also supports getting the default size of a given part with | |
| 40 // the GetPartSize() method. | |
| 41 class NATIVE_THEME_EXPORT NativeTheme { | |
| 42 public: | |
| 43 // The part to be painted / sized. | |
| 44 enum Part { | |
| 45 kComboboxArrow, | |
| 46 kCheckbox, | |
| 47 kInnerSpinButton, | |
| 48 kMenuList, | |
| 49 kMenuCheck, | |
| 50 kMenuCheckBackground, | |
| 51 kMenuPopupArrow, | |
| 52 kMenuPopupBackground, | |
| 53 kMenuPopupGutter, | |
| 54 kMenuPopupSeparator, | |
| 55 kMenuItemBackground, | |
| 56 kProgressBar, | |
| 57 kPushButton, | |
| 58 kRadio, | |
| 59 | |
| 60 // The order of the arrow enums is important, do not change without also | |
| 61 // changing the code in platform implementations. | |
| 62 kScrollbarDownArrow, | |
| 63 kScrollbarLeftArrow, | |
| 64 kScrollbarRightArrow, | |
| 65 kScrollbarUpArrow, | |
| 66 | |
| 67 kScrollbarHorizontalThumb, | |
| 68 kScrollbarVerticalThumb, | |
| 69 kScrollbarHorizontalTrack, | |
| 70 kScrollbarVerticalTrack, | |
| 71 kScrollbarHorizontalGripper, | |
| 72 kScrollbarVerticalGripper, | |
| 73 // The corner is drawn when there is both a horizontal and vertical | |
| 74 // scrollbar. | |
| 75 kScrollbarCorner, | |
| 76 kSliderTrack, | |
| 77 kSliderThumb, | |
| 78 kTabPanelBackground, | |
| 79 kTextField, | |
| 80 kTrackbarThumb, | |
| 81 kTrackbarTrack, | |
| 82 kWindowResizeGripper, | |
| 83 kMaxPart, | |
| 84 }; | |
| 85 | |
| 86 // The state of the part. | |
| 87 enum State { | |
| 88 // IDs defined as specific values for use in arrays. | |
| 89 kDisabled = 0, | |
| 90 kHovered = 1, | |
| 91 kNormal = 2, | |
| 92 kPressed = 3, | |
| 93 kNumStates = kPressed + 1, | |
| 94 }; | |
| 95 | |
| 96 // Each structure below holds extra information needed when painting a given | |
| 97 // part. | |
| 98 | |
| 99 struct ButtonExtraParams { | |
| 100 bool checked; | |
| 101 bool indeterminate; // Whether the button state is indeterminate. | |
| 102 bool is_default; // Whether the button is default button. | |
| 103 bool is_focused; | |
| 104 bool has_border; | |
| 105 int classic_state; // Used on Windows when uxtheme is not available. | |
| 106 SkColor background_color; | |
| 107 }; | |
| 108 | |
| 109 struct InnerSpinButtonExtraParams { | |
| 110 bool spin_up; | |
| 111 bool read_only; | |
| 112 int classic_state; // Used on Windows when uxtheme is not available. | |
| 113 }; | |
| 114 | |
| 115 struct MenuArrowExtraParams { | |
| 116 bool pointing_right; | |
| 117 // Used for the disabled state to indicate if the item is both disabled and | |
| 118 // selected. | |
| 119 bool is_selected; | |
| 120 }; | |
| 121 | |
| 122 struct MenuCheckExtraParams { | |
| 123 bool is_radio; | |
| 124 // Used for the disabled state to indicate if the item is both disabled and | |
| 125 // selected. | |
| 126 bool is_selected; | |
| 127 }; | |
| 128 | |
| 129 struct MenuItemExtraParams { | |
| 130 bool is_selected; | |
| 131 }; | |
| 132 | |
| 133 struct MenuListExtraParams { | |
| 134 bool has_border; | |
| 135 bool has_border_radius; | |
| 136 int arrow_x; | |
| 137 int arrow_y; | |
| 138 SkColor background_color; | |
| 139 int classic_state; // Used on Windows when uxtheme is not available. | |
| 140 }; | |
| 141 | |
| 142 struct MenuSeparatorExtraParams { | |
| 143 bool has_gutter; | |
| 144 }; | |
| 145 | |
| 146 struct MenuBackgroundExtraParams { | |
| 147 int corner_radius; | |
| 148 }; | |
| 149 | |
| 150 struct ProgressBarExtraParams { | |
| 151 double animated_seconds; | |
| 152 bool determinate; | |
| 153 int value_rect_x; | |
| 154 int value_rect_y; | |
| 155 int value_rect_width; | |
| 156 int value_rect_height; | |
| 157 }; | |
| 158 | |
| 159 struct ScrollbarArrowExtraParams { | |
| 160 bool is_hovering; | |
| 161 }; | |
| 162 | |
| 163 struct ScrollbarTrackExtraParams { | |
| 164 bool is_upper; | |
| 165 int track_x; | |
| 166 int track_y; | |
| 167 int track_width; | |
| 168 int track_height; | |
| 169 int classic_state; // Used on Windows when uxtheme is not available. | |
| 170 }; | |
| 171 | |
| 172 struct ScrollbarThumbExtraParams { | |
| 173 bool is_hovering; | |
| 174 }; | |
| 175 | |
| 176 struct SliderExtraParams { | |
| 177 bool vertical; | |
| 178 bool in_drag; | |
| 179 }; | |
| 180 | |
| 181 struct TextFieldExtraParams { | |
| 182 bool is_text_area; | |
| 183 bool is_listbox; | |
| 184 SkColor background_color; | |
| 185 bool is_read_only; | |
| 186 bool is_focused; | |
| 187 bool fill_content_area; | |
| 188 bool draw_edges; | |
| 189 int classic_state; // Used on Windows when uxtheme is not available. | |
| 190 }; | |
| 191 | |
| 192 struct TrackbarExtraParams { | |
| 193 bool vertical; | |
| 194 int classic_state; // Used on Windows when uxtheme is not available. | |
| 195 }; | |
| 196 | |
| 197 union ExtraParams { | |
| 198 ButtonExtraParams button; | |
| 199 InnerSpinButtonExtraParams inner_spin; | |
| 200 MenuArrowExtraParams menu_arrow; | |
| 201 MenuCheckExtraParams menu_check; | |
| 202 MenuItemExtraParams menu_item; | |
| 203 MenuListExtraParams menu_list; | |
| 204 MenuSeparatorExtraParams menu_separator; | |
| 205 MenuBackgroundExtraParams menu_background; | |
| 206 ProgressBarExtraParams progress_bar; | |
| 207 ScrollbarArrowExtraParams scrollbar_arrow; | |
| 208 ScrollbarTrackExtraParams scrollbar_track; | |
| 209 ScrollbarThumbExtraParams scrollbar_thumb; | |
| 210 SliderExtraParams slider; | |
| 211 TextFieldExtraParams text_field; | |
| 212 TrackbarExtraParams trackbar; | |
| 213 }; | |
| 214 | |
| 215 // Return the size of the part. | |
| 216 virtual gfx::Size GetPartSize(Part part, | |
| 217 State state, | |
| 218 const ExtraParams& extra) const = 0; | |
| 219 | |
| 220 // Paint the part to the canvas. | |
| 221 virtual void Paint(SkCanvas* canvas, | |
| 222 Part part, | |
| 223 State state, | |
| 224 const gfx::Rect& rect, | |
| 225 const ExtraParams& extra) const = 0; | |
| 226 | |
| 227 // Paint part during state transition, used for overlay scrollbar state | |
| 228 // transition animation. | |
| 229 virtual void PaintStateTransition(SkCanvas* canvas, | |
| 230 Part part, | |
| 231 State startState, | |
| 232 State endState, | |
| 233 double progress, | |
| 234 const gfx::Rect& rect) const { } | |
| 235 | |
| 236 // Supports theme specific colors. | |
| 237 void SetScrollbarColors(unsigned inactive_color, | |
| 238 unsigned active_color, | |
| 239 unsigned track_color); | |
| 240 | |
| 241 // Colors for GetSystemColor(). | |
| 242 enum ColorId { | |
| 243 // Windows | |
| 244 kColorId_WindowBackground, | |
| 245 // Dialogs | |
| 246 kColorId_DialogBackground, | |
| 247 // FocusableBorder | |
| 248 kColorId_FocusedBorderColor, | |
| 249 kColorId_UnfocusedBorderColor, | |
| 250 // Button | |
| 251 kColorId_ButtonBackgroundColor, | |
| 252 kColorId_ButtonEnabledColor, | |
| 253 kColorId_ButtonDisabledColor, | |
| 254 kColorId_ButtonHighlightColor, | |
| 255 kColorId_ButtonHoverColor, | |
| 256 kColorId_ButtonHoverBackgroundColor, | |
| 257 kColorId_BlueButtonEnabledColor, | |
| 258 kColorId_BlueButtonDisabledColor, | |
| 259 kColorId_BlueButtonPressedColor, | |
| 260 kColorId_BlueButtonHoverColor, | |
| 261 kColorId_BlueButtonShadowColor, | |
| 262 // MenuItem | |
| 263 kColorId_EnabledMenuItemForegroundColor, | |
| 264 kColorId_DisabledMenuItemForegroundColor, | |
| 265 kColorId_DisabledEmphasizedMenuItemForegroundColor, | |
| 266 kColorId_SelectedMenuItemForegroundColor, | |
| 267 kColorId_FocusedMenuItemBackgroundColor, | |
| 268 kColorId_HoverMenuItemBackgroundColor, | |
| 269 kColorId_MenuSeparatorColor, | |
| 270 kColorId_MenuBackgroundColor, | |
| 271 kColorId_MenuBorderColor, | |
| 272 // MenuButton - buttons in wrench menu | |
| 273 kColorId_EnabledMenuButtonBorderColor, | |
| 274 kColorId_FocusedMenuButtonBorderColor, | |
| 275 kColorId_HoverMenuButtonBorderColor, | |
| 276 // Label | |
| 277 kColorId_LabelEnabledColor, | |
| 278 kColorId_LabelDisabledColor, | |
| 279 kColorId_LabelBackgroundColor, | |
| 280 // Textfield | |
| 281 kColorId_TextfieldDefaultColor, | |
| 282 kColorId_TextfieldDefaultBackground, | |
| 283 kColorId_TextfieldReadOnlyColor, | |
| 284 kColorId_TextfieldReadOnlyBackground, | |
| 285 kColorId_TextfieldSelectionColor, | |
| 286 kColorId_TextfieldSelectionBackgroundFocused, | |
| 287 // Tooltip | |
| 288 kColorId_TooltipBackground, | |
| 289 kColorId_TooltipText, | |
| 290 // Tree | |
| 291 kColorId_TreeBackground, | |
| 292 kColorId_TreeText, | |
| 293 kColorId_TreeSelectedText, | |
| 294 kColorId_TreeSelectedTextUnfocused, | |
| 295 kColorId_TreeSelectionBackgroundFocused, | |
| 296 kColorId_TreeSelectionBackgroundUnfocused, | |
| 297 kColorId_TreeArrow, | |
| 298 // Table | |
| 299 kColorId_TableBackground, | |
| 300 kColorId_TableText, | |
| 301 kColorId_TableSelectedText, | |
| 302 kColorId_TableSelectedTextUnfocused, | |
| 303 kColorId_TableSelectionBackgroundFocused, | |
| 304 kColorId_TableSelectionBackgroundUnfocused, | |
| 305 kColorId_TableGroupingIndicatorColor, | |
| 306 // Results Tables, such as the chrome omnibox. | |
| 307 kColorId_ResultsTableNormalBackground, | |
| 308 kColorId_ResultsTableHoveredBackground, | |
| 309 kColorId_ResultsTableSelectedBackground, | |
| 310 kColorId_ResultsTableNormalText, | |
| 311 kColorId_ResultsTableHoveredText, | |
| 312 kColorId_ResultsTableSelectedText, | |
| 313 kColorId_ResultsTableNormalDimmedText, | |
| 314 kColorId_ResultsTableHoveredDimmedText, | |
| 315 kColorId_ResultsTableSelectedDimmedText, | |
| 316 kColorId_ResultsTableNormalUrl, | |
| 317 kColorId_ResultsTableHoveredUrl, | |
| 318 kColorId_ResultsTableSelectedUrl, | |
| 319 kColorId_ResultsTableNormalDivider, | |
| 320 kColorId_ResultsTableHoveredDivider, | |
| 321 kColorId_ResultsTableSelectedDivider, | |
| 322 // TODO(benrg): move other hardcoded colors here. | |
| 323 | |
| 324 kColorId_NumColors, | |
| 325 }; | |
| 326 | |
| 327 // Return a color from the system theme. | |
| 328 virtual SkColor GetSystemColor(ColorId color_id) const = 0; | |
| 329 | |
| 330 // Returns a shared instance of the native theme. | |
| 331 // The returned object should not be deleted by the caller. This function | |
| 332 // is not thread safe and should only be called from the UI thread. | |
| 333 // Each port of NativeTheme should provide its own implementation of this | |
| 334 // function, returning the port's subclass. | |
| 335 static NativeTheme* instance(); | |
| 336 | |
| 337 // Add or remove observers to be notified when the native theme changes. | |
| 338 void AddObserver(NativeThemeObserver* observer); | |
| 339 void RemoveObserver(NativeThemeObserver* observer); | |
| 340 | |
| 341 // Notify observers of native theme changes. | |
| 342 void NotifyObservers(); | |
| 343 | |
| 344 protected: | |
| 345 NativeTheme(); | |
| 346 virtual ~NativeTheme(); | |
| 347 | |
| 348 unsigned int thumb_inactive_color_; | |
| 349 unsigned int thumb_active_color_; | |
| 350 unsigned int track_color_; | |
| 351 | |
| 352 private: | |
| 353 // Observers to notify when the native theme changes. | |
| 354 ObserverList<NativeThemeObserver> native_theme_observers_; | |
| 355 | |
| 356 DISALLOW_COPY_AND_ASSIGN(NativeTheme); | |
| 357 }; | |
| 358 | |
| 359 } // namespace ui | |
| 360 | |
| 361 #endif // UI_NATIVE_THEME_NATIVE_THEME_H_ | |
| OLD | NEW |