OLD | NEW |
---|---|
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 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 | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef UI_VIEWS_LAYOUT_BOX_LAYOUT_H_ | 5 #ifndef UI_VIEWS_LAYOUT_BOX_LAYOUT_H_ |
6 #define UI_VIEWS_LAYOUT_BOX_LAYOUT_H_ | 6 #define UI_VIEWS_LAYOUT_BOX_LAYOUT_H_ |
7 | 7 |
8 #include <map> | 8 #include <map> |
9 | 9 |
10 #include "base/compiler_specific.h" | 10 #include "base/compiler_specific.h" |
(...skipping 40 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
51 // This causes the child view to stretch to fit the host in the cross axis. | 51 // This causes the child view to stretch to fit the host in the cross axis. |
52 CROSS_AXIS_ALIGNMENT_STRETCH, | 52 CROSS_AXIS_ALIGNMENT_STRETCH, |
53 CROSS_AXIS_ALIGNMENT_START, | 53 CROSS_AXIS_ALIGNMENT_START, |
54 CROSS_AXIS_ALIGNMENT_CENTER, | 54 CROSS_AXIS_ALIGNMENT_CENTER, |
55 CROSS_AXIS_ALIGNMENT_END, | 55 CROSS_AXIS_ALIGNMENT_END, |
56 }; | 56 }; |
57 | 57 |
58 // Use |inside_border_horizontal_spacing| and | 58 // Use |inside_border_horizontal_spacing| and |
59 // |inside_border_vertical_spacing| to add additional space between the child | 59 // |inside_border_vertical_spacing| to add additional space between the child |
60 // view area and the host view border. |between_child_spacing| controls the | 60 // view area and the host view border. |between_child_spacing| controls the |
61 // space in between child views. | 61 // space in between child views. Use view->SetProperty(kMarginsKey, |
62 // new gfx::Insets(xxx)) to add additional margins on a per-view basis. The | |
63 // |collapse_margins_spacing| parameter controls whether or not spacing | |
64 // adjacent to view margins are collapsed base on the max of the two values. | |
sky
2017/05/24 21:28:51
adjacent -> main axis?
kylix_rd
2017/05/25 14:32:17
Done.
| |
65 // | |
66 // Given the following views where V = view bounds, M = Margins property, | |
67 // B = between child spacing, S = inside border spacing and | |
68 // <space> = added margins for alignment | |
69 // | |
70 // MMMMM MMVVVVMM MMMM | |
71 // VVVVM MMMM | |
72 // VVVVM MMMM | |
73 // VVVVM VVVV | |
74 // MMMMM | |
75 // | |
76 // With collapse_margins_spacing = false, orientation = kHorizontal, | |
77 // inside_border_spacing_horizontal = 2, inside_border_spacing_vertical = 2 | |
78 // and between_child_spacing = 1: | |
79 // | |
80 // ----------------------- | |
81 // SSSSSSSSSSSSSSSSSSSSSSS | |
82 // SSSSSSSSSSSSSSSSSSSSSSS | |
83 // SS MBMM MMBMMMMSS | |
84 // SS MBMM MMBMMMMSS | |
85 // SSMMMMMBMM MMBMMMMSS | |
86 // SSVVVVMBMMVVVVMMBVVVVSS | |
87 // SSVVVVMBMMVVVVMMBVVVVSS | |
88 // SSVVVVMBMMVVVVMMBVVVVSS | |
89 // SSMMMMMBMMVVVVMMBVVVVSS | |
90 // SSSSSSSSSSSSSSSSSSSSSSS | |
91 // SSSSSSSSSSSSSSSSSSSSSSS | |
92 // ----------------------- | |
93 // | |
94 // Same as above except, collapse_margins_spacing = true. | |
95 // | |
96 // -------------------- | |
97 // SS MMMMMMSS | |
98 // SS MMMMMMSS | |
99 // SSMMMMMM MMMMMMSS | |
100 // SSVVVVMMVVVVMMVVVVSS | |
101 // SSVVVVMMVVVVMMVVVVSS | |
102 // SSVVVVMMVVVVMMVVVVSS | |
103 // SSSSSSSSSSSSSSSSSSSS | |
104 // SSSSSSSSSSSSSSSSSSSS | |
105 // -------------------- | |
106 // | |
62 BoxLayout(Orientation orientation, | 107 BoxLayout(Orientation orientation, |
63 int inside_border_horizontal_spacing, | 108 int inside_border_horizontal_spacing, |
64 int inside_border_vertical_spacing, | 109 int inside_border_vertical_spacing, |
65 int between_child_spacing); | 110 int between_child_spacing, |
111 bool collapse_margins_spacing = false); | |
66 ~BoxLayout() override; | 112 ~BoxLayout() override; |
67 | 113 |
68 void set_main_axis_alignment(MainAxisAlignment main_axis_alignment) { | 114 void set_main_axis_alignment(MainAxisAlignment main_axis_alignment) { |
69 main_axis_alignment_ = main_axis_alignment; | 115 main_axis_alignment_ = main_axis_alignment; |
70 } | 116 } |
71 | 117 |
72 void set_cross_axis_alignment(CrossAxisAlignment cross_axis_alignment) { | 118 void set_cross_axis_alignment(CrossAxisAlignment cross_axis_alignment) { |
73 cross_axis_alignment_ = cross_axis_alignment; | 119 cross_axis_alignment_ = cross_axis_alignment; |
74 } | 120 } |
75 | 121 |
(...skipping 22 matching lines...) Expand all Loading... | |
98 void SetDefaultFlex(int default_flex); | 144 void SetDefaultFlex(int default_flex); |
99 | 145 |
100 // Overridden from views::LayoutManager: | 146 // Overridden from views::LayoutManager: |
101 void Installed(View* host) override; | 147 void Installed(View* host) override; |
102 void ViewRemoved(View* host, View* view) override; | 148 void ViewRemoved(View* host, View* view) override; |
103 void Layout(View* host) override; | 149 void Layout(View* host) override; |
104 gfx::Size GetPreferredSize(const View* host) const override; | 150 gfx::Size GetPreferredSize(const View* host) const override; |
105 int GetPreferredHeightForWidth(const View* host, int width) const override; | 151 int GetPreferredHeightForWidth(const View* host, int width) const override; |
106 | 152 |
107 private: | 153 private: |
154 // This struct is used internally to "wrap" a child view in order to obviate | |
155 // the need for the main layout logic to be fully aware of the per-view | |
156 // margins when |collapse_margin_spacing_| is false. Since each view is a | |
157 // rectangle of a certain size, this wrapper, coupled with any margins set | |
158 // will increase the apparent size of the view along the main axis. All | |
159 // necessary view size/position methods required for the layout logic add or | |
160 // subtract the margins where appropriate to ensure the actual visible size of | |
161 // the view doesn't include the margins. For the cross axis, the margins are | |
162 // NOT included in the size/position calculations. BoxLayout will adjust the | |
163 // bounding rectangle of the space used for layout using the maximum margin | |
164 // for all views along the appropriate edge. | |
165 // When |collapse_margin_spacing_| is true, this wrapper provides quick access | |
166 // to the view's margins for use by the layout to collapse adjacent spacing | |
167 // to the largest of the several values. | |
168 class ViewWrapper { | |
169 public: | |
170 ViewWrapper(); | |
171 ViewWrapper(const BoxLayout* layout, View* view); | |
172 ~ViewWrapper(); | |
173 int GetHeightForWidth(int width) const; | |
174 const gfx::Insets& margins() const { return margins_; } | |
175 gfx::Size GetPreferredSize() const; | |
176 void SetBoundsRect(const gfx::Rect& bounds); | |
177 View* view() const { return view_; } | |
178 bool visible() const; | |
179 | |
180 private: | |
181 View* view_; | |
182 const BoxLayout* layout_; | |
183 const Orientation orientation_; | |
184 gfx::Insets margins_; | |
185 | |
186 DISALLOW_COPY_AND_ASSIGN(ViewWrapper); | |
187 }; | |
188 | |
189 using FlexMap = std::map<const View*, int>; | |
190 | |
108 // Returns the flex for the specified |view|. | 191 // Returns the flex for the specified |view|. |
109 int GetFlexForView(const View* view) const; | 192 int GetFlexForView(const View* view) const; |
110 | 193 |
111 // Returns the size and position along the main axis of |rect|. | 194 // Returns the size and position along the main axis of |rect|. |
112 int MainAxisSize(const gfx::Rect& rect) const; | 195 int MainAxisSize(const gfx::Rect& rect) const; |
113 int MainAxisPosition(const gfx::Rect& rect) const; | 196 int MainAxisPosition(const gfx::Rect& rect) const; |
114 | 197 |
115 // Sets the size and position along the main axis of |rect|. | 198 // Sets the size and position along the main axis of |rect|. |
116 void SetMainAxisSize(int size, gfx::Rect* rect) const; | 199 void SetMainAxisSize(int size, gfx::Rect* rect) const; |
117 void SetMainAxisPosition(int position, gfx::Rect* rect) const; | 200 void SetMainAxisPosition(int position, gfx::Rect* rect) const; |
118 | 201 |
119 // Returns the size and position along the cross axis of |rect|. | 202 // Returns the size and position along the cross axis of |rect|. |
120 int CrossAxisSize(const gfx::Rect& rect) const; | 203 int CrossAxisSize(const gfx::Rect& rect) const; |
121 int CrossAxisPosition(const gfx::Rect& rect) const; | 204 int CrossAxisPosition(const gfx::Rect& rect) const; |
122 | 205 |
123 // Sets the size and position along the cross axis of |rect|. | 206 // Sets the size and position along the cross axis of |rect|. |
124 void SetCrossAxisSize(int size, gfx::Rect* rect) const; | 207 void SetCrossAxisSize(int size, gfx::Rect* rect) const; |
125 void SetCrossAxisPosition(int size, gfx::Rect* rect) const; | 208 void SetCrossAxisPosition(int size, gfx::Rect* rect) const; |
126 | 209 |
127 // Returns the main axis size for the given view. |child_area_width| is needed | 210 // Returns the main axis size for the given view. |child_area_width| is needed |
128 // to calculate the height of the view when the orientation is vertical. | 211 // to calculate the height of the view when the orientation is vertical. |
129 int MainAxisSizeForView(const View* view, int child_area_width) const; | 212 int MainAxisSizeForView(const ViewWrapper& view, int child_area_width) const; |
213 | |
214 // Returns the main axis margin spacing between the two views which is the max | |
215 // of the right margin from the |left| view, the left margin of the |right| | |
216 // view and |between_child_spacing_|. | |
217 int MainAxisMarginBetweenViews(const ViewWrapper& left, | |
218 const ViewWrapper& right) const; | |
219 | |
220 // Return the outer margin along the main axis as insets. | |
sky
2017/05/24 21:28:51
Return -> Returns (same on 223, and 226).
kylix_rd
2017/05/25 14:32:17
Done.
| |
221 gfx::Insets MainAxisOuterMargin() const; | |
222 | |
223 // Return the maximum margin along the cross axis from all views as insets. | |
224 gfx::Insets CrossAxisMaxViewMargin() const; | |
225 | |
226 // Return the outer margin along the cross axis as insets. | |
227 gfx::Insets CrossAxisOuterMargin() const; | |
228 | |
229 // Adjusts the main axis for |rect| by collapsing the left or top margin of | |
230 // the first view with corresponding side of |inside_border_insets_| and the | |
231 // right or bottom margin of the last view with the corresponding side of | |
232 // |inside_border_insets_|. | |
233 void AdjustMainAxisForMargin(gfx::Rect* rect) const; | |
234 | |
235 // Adjust the cross axis for |rect| using the appropriate sides of | |
236 // |inside_border_insets_|. | |
237 void AdjustCrossAxisForInsets(gfx::Rect* rect) const; | |
130 | 238 |
131 // Returns the cross axis size for the given view. | 239 // Returns the cross axis size for the given view. |
132 int CrossAxisSizeForView(const View* view) const; | 240 int CrossAxisSizeForView(const ViewWrapper& view) const; |
241 | |
242 // Returns the total margin width for the given view or 0 when | |
243 // collapse_margins_spacing_ is true. | |
244 int CrossAxisMarginSizeForView(const ViewWrapper& view) const; | |
245 | |
246 // Returns the Top or Left size of the margin for the given view or 0 when | |
247 // collapse_margins_spacing_ is true. | |
248 int CrossAxisMarginTopLeftForView(const ViewWrapper& view) const; | |
133 | 249 |
134 // The preferred size for the dialog given the width of the child area. | 250 // The preferred size for the dialog given the width of the child area. |
135 gfx::Size GetPreferredSizeForChildWidth(const View* host, | 251 gfx::Size GetPreferredSizeForChildWidth(const View* host, |
136 int child_area_width) const; | 252 int child_area_width) const; |
137 | 253 |
138 // The amount of space the layout requires in addition to any space for the | 254 // The amount of space the layout requires in addition to any space for the |
139 // child views. | 255 // child views. |
140 gfx::Size NonChildSize(const View* host) const; | 256 gfx::Size NonChildSize(const View* host) const; |
141 | 257 |
258 // The next visible view at > index. If no other views are visible, return | |
259 // nullptr. | |
260 View* NextVisibleView(int index) const; | |
261 | |
262 // Return the first visible view in the host or nullptr if none are visible. | |
263 View* FirstVisibleView() const; | |
264 | |
265 // Return the last visible view in the host or nullptr if none are visible. | |
266 View* LastVisibleView() const; | |
267 | |
142 const Orientation orientation_; | 268 const Orientation orientation_; |
143 | 269 |
144 // Spacing between child views and host view border. | 270 // Spacing between child views and host view border. |
145 gfx::Insets inside_border_insets_; | 271 gfx::Insets inside_border_insets_; |
146 | 272 |
147 // Spacing to put in between child views. | 273 // Spacing to put in between child views. |
148 const int between_child_spacing_; | 274 const int between_child_spacing_; |
149 | 275 |
150 // The alignment of children in the main axis. This is | 276 // The alignment of children in the main axis. This is |
151 // MAIN_AXIS_ALIGNMENT_START by default. | 277 // MAIN_AXIS_ALIGNMENT_START by default. |
152 MainAxisAlignment main_axis_alignment_; | 278 MainAxisAlignment main_axis_alignment_; |
153 | 279 |
154 // The alignment of children in the cross axis. This is | 280 // The alignment of children in the cross axis. This is |
155 // CROSS_AXIS_ALIGNMENT_STRETCH by default. | 281 // CROSS_AXIS_ALIGNMENT_STRETCH by default. |
156 CrossAxisAlignment cross_axis_alignment_; | 282 CrossAxisAlignment cross_axis_alignment_; |
157 | 283 |
158 // A map of views to their flex weights. | 284 // A map of views to their flex weights. |
159 std::map<const View*, int> flex_map_; | 285 FlexMap flex_map_; |
160 | 286 |
161 // The flex weight for views if none is set. Defaults to 0. | 287 // The flex weight for views if none is set. Defaults to 0. |
162 int default_flex_; | 288 int default_flex_; |
163 | 289 |
164 // The minimum cross axis size for the layout. | 290 // The minimum cross axis size for the layout. |
165 int minimum_cross_axis_size_; | 291 int minimum_cross_axis_size_; |
166 | 292 |
293 // Adjacent view margins and spacing should be collapsed. | |
294 const bool collapse_margins_spacing_; | |
295 | |
167 // The view that this BoxLayout is managing the layout for. | 296 // The view that this BoxLayout is managing the layout for. |
168 views::View* host_; | 297 views::View* host_; |
169 | 298 |
170 DISALLOW_IMPLICIT_CONSTRUCTORS(BoxLayout); | 299 DISALLOW_IMPLICIT_CONSTRUCTORS(BoxLayout); |
171 }; | 300 }; |
172 | 301 |
173 } // namespace views | 302 } // namespace views |
174 | 303 |
175 #endif // UI_VIEWS_LAYOUT_BOX_LAYOUT_H_ | 304 #endif // UI_VIEWS_LAYOUT_BOX_LAYOUT_H_ |
OLD | NEW |