1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
// Copyright 2017 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef UI_VIEWS_STYLE_TYPOGRAPHY_H_
#define UI_VIEWS_STYLE_TYPOGRAPHY_H_
#include "third_party/skia/include/core/SkColor.h"
#include "ui/views/views_export.h"
namespace gfx {
class FontList;
}
namespace views {
class View;
namespace style {
// Where a piece of text appears in the UI. This influences size and weight, but
// typically not style or color.
enum TextContext {
// Embedders can extend this enum with additional values that are understood
// by the TypographyProvider offered by their ViewsDelegate. Embedders define
// enum values from VIEWS_TEXT_CONTEXT_END. Values named beginning with
// "CONTEXT_" represent the actual TextContexts: the rest are markers.
VIEWS_TEXT_CONTEXT_START = 0,
// Text that appears on a button control. Usually 12pt. This includes controls
// with button-like behavior, such as Checkbox.
CONTEXT_BUTTON = VIEWS_TEXT_CONTEXT_START,
// Text that appears on an MD-styled dialog button control. Usually 12pt.
CONTEXT_BUTTON_MD,
// A title for a dialog window. Usually 15pt. Multi-line OK.
CONTEXT_DIALOG_TITLE,
// Text to label a control, usually next to it. "Body 2". Usually 12pt.
CONTEXT_LABEL,
// Text used for body text in dialogs.
CONTEXT_DIALOG_BODY_TEXT,
// Text in a table row.
CONTEXT_TABLE_ROW,
// An editable text field. Usually matches CONTROL_LABEL.
CONTEXT_TEXTFIELD,
// Text in a menu.
CONTEXT_MENU,
// Text for the menu items that appear in the touch-selection context menu.
CONTEXT_TOUCH_MENU,
// Embedders must start TextContext enum values from this value.
VIEWS_TEXT_CONTEXT_END,
// All TextContext enum values must be below this value.
TEXT_CONTEXT_MAX = 0x1000
};
// How a piece of text should be presented. This influences color and style, but
// typically not size.
enum TextStyle {
// TextStyle enum values must always be greater than any TextContext value.
// This allows the code to verify at runtime that arguments of the two types
// have not been swapped.
VIEWS_TEXT_STYLE_START = TEXT_CONTEXT_MAX,
// Primary text: solid black, normal weight. Converts to DISABLED in some
// contexts (e.g. BUTTON_TEXT, FIELD).
STYLE_PRIMARY = VIEWS_TEXT_STYLE_START,
// Secondary text: Appears near the primary text.
STYLE_SECONDARY,
// "Hint" text, usually a line that gives context to something more important.
STYLE_HINT,
// Style for text that is displayed in a selection.
STYLE_SELECTED,
// Style for text is part of a static highlight.
STYLE_HIGHLIGHTED,
// Style for the default button on a dialog.
STYLE_DIALOG_BUTTON_DEFAULT,
// Disabled "greyed out" text.
STYLE_DISABLED,
// The style used for links. Usually a solid shade of blue.
STYLE_LINK,
// Active tab in a tabbed pane.
STYLE_TAB_ACTIVE,
// Embedders must start TextStyle enum values from here.
VIEWS_TEXT_STYLE_END
};
// Helpers to obtain text properties from the TypographyProvider given by the
// current LayoutProvider. |view| is the View requesting the property. |context|
// can be an enum value from TextContext, or a value understood by the
// embedder's TypographyProvider. Similarly, |style| corresponds to TextStyle.
VIEWS_EXPORT const gfx::FontList& GetFont(int context, int style);
VIEWS_EXPORT SkColor GetColor(const views::View& view, int context, int style);
VIEWS_EXPORT int GetLineHeight(int context, int style);
} // namespace style
} // namespace views
#endif // UI_VIEWS_STYLE_TYPOGRAPHY_H_
|
