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_VIEWS_WINDOW_DIALOG_CLIENT_VIEW_H_ 6 #define UI_VIEWS_WINDOW_DIALOG_CLIENT_VIEW_H_ 7 8 #include "ui/base/ui_base_types.h" 9 #include "ui/views/controls/button/button.h" 10 #include "ui/views/focus/focus_manager.h" 11 #include "ui/views/window/client_view.h" 12 13 namespace views { 14 15 class DialogDelegate; 16 class LabelButton; 17 class Widget; 18 19 // DialogClientView provides adornments for a dialog's content view, including 20 // custom-labeled [OK] and [Cancel] buttons with [Enter] and [Esc] accelerators. 21 // The view also displays the delegate's extra view alongside the buttons and 22 // the delegate's footnote view below the buttons. The view appears like below. 23 // NOTE: The contents view is not inset on the top or side client view edges. 24 // +------------------------------+ 25 // | Contents View | 26 // +------------------------------+ 27 // | [Extra View] [OK] [Cancel] | 28 // | [ Footnote View ] | 29 // +------------------------------+ 30 class VIEWS_EXPORT DialogClientView : public ClientView, 31 public ButtonListener, 32 public FocusChangeListener { 33 public: 34 DialogClientView(Widget* widget, View* contents_view); 35 virtual ~DialogClientView(); 36 37 // Accept or Cancel the dialog. 38 void AcceptWindow(); 39 void CancelWindow(); 40 41 // Accessors in case the user wishes to adjust these buttons. ok_button()42 LabelButton* ok_button() const { return ok_button_; } cancel_button()43 LabelButton* cancel_button() const { return cancel_button_; } 44 45 // Update the dialog buttons to match the dialog's delegate. 46 void UpdateDialogButtons(); 47 48 // ClientView implementation: 49 virtual bool CanClose() OVERRIDE; 50 virtual DialogClientView* AsDialogClientView() OVERRIDE; 51 virtual const DialogClientView* AsDialogClientView() const OVERRIDE; 52 53 // FocusChangeListener implementation: 54 virtual void OnWillChangeFocus(View* focused_before, 55 View* focused_now) OVERRIDE; 56 virtual void OnDidChangeFocus(View* focused_before, 57 View* focused_now) OVERRIDE; 58 59 // View implementation: 60 virtual gfx::Size GetPreferredSize() const OVERRIDE; 61 virtual void Layout() OVERRIDE; 62 virtual bool AcceleratorPressed(const ui::Accelerator& accelerator) OVERRIDE; 63 virtual void ViewHierarchyChanged( 64 const ViewHierarchyChangedDetails& details) OVERRIDE; 65 virtual void NativeViewHierarchyChanged() OVERRIDE; 66 virtual void OnNativeThemeChanged(const ui::NativeTheme* theme) OVERRIDE; 67 68 // ButtonListener implementation: 69 virtual void ButtonPressed(Button* sender, const ui::Event& event) OVERRIDE; 70 71 protected: 72 // For testing. 73 DialogClientView(View* contents_view); 74 75 // Returns the DialogDelegate for the window. Virtual for testing. 76 virtual DialogDelegate* GetDialogDelegate() const; 77 78 // Create and add the extra view, if supplied by the delegate. 79 void CreateExtraView(); 80 81 // Creates and adds the footnote view, if supplied by the delegate. 82 void CreateFootnoteView(); 83 84 // View implementation. 85 virtual void ChildPreferredSizeChanged(View* child) OVERRIDE; 86 virtual void ChildVisibilityChanged(View* child) OVERRIDE; 87 88 private: 89 FRIEND_TEST_ALL_PREFIXES(DialogClientViewTest, FocusManager); 90 has_dialog_buttons()91 bool has_dialog_buttons() const { return ok_button_ || cancel_button_; } 92 93 // Create a dialog button of the appropriate type. 94 LabelButton* CreateDialogButton(ui::DialogButton type); 95 96 // Update |button|'s text and enabled state according to the delegate's state. 97 void UpdateButton(LabelButton* button, ui::DialogButton type); 98 99 // Returns the height of the row containing the buttons and the extra view. 100 int GetButtonsAndExtraViewRowHeight() const; 101 102 // Returns the insets for the buttons and extra view. 103 gfx::Insets GetButtonRowInsets() const; 104 105 // Closes the widget. 106 void Close(); 107 108 // The dialog buttons. 109 LabelButton* ok_button_; 110 LabelButton* cancel_button_; 111 112 // The button that is currently default; may be NULL. 113 LabelButton* default_button_; 114 115 // Observe |focus_manager_| to update the default button with focus changes. 116 FocusManager* focus_manager_; 117 118 // The extra view shown in the row of buttons; may be NULL. 119 View* extra_view_; 120 121 // The footnote view shown below the buttons; may be NULL. 122 View* footnote_view_; 123 124 // True if we've notified the delegate the window is closing and the delegate 125 // allosed the close. In some situations it's possible to get two closes (see 126 // http://crbug.com/71940). This is used to avoid notifying the delegate 127 // twice, which can have bad consequences. 128 bool notified_delegate_; 129 130 DISALLOW_COPY_AND_ASSIGN(DialogClientView); 131 }; 132 133 } // namespace views 134 135 #endif // UI_VIEWS_WINDOW_DIALOG_CLIENT_VIEW_H_ 136