mirror of https://github.com/buggins/dlangui.git
Fix #638 TextWidget didn't track hover
This commit is contained in:
Grim Maple
parent
171df6864c
commit
7ef1b7e809
|
|
@ -1,3 +1,12 @@
|
||||||
|
Follow the D Style
|
||||||
|
===================
|
||||||
|
|
||||||
|
From now one, it is advised to follow the [D Style](https://dlang.org/dstyle.html) for ease of future possible integration with
|
||||||
|
the D community. While the coding style is changing, it is discouraged to submit styling only PRs. Those **will not be merged**.
|
||||||
|
It's OK to change styling in the code you're submitting.
|
||||||
|
|
||||||
|
The below codestyle is outdated, but is kept for historical purposes.
|
||||||
|
|
||||||
DlangUI Coding Style
|
DlangUI Coding Style
|
||||||
====================
|
====================
|
||||||
|
|
||||||
|
|
|
||||||
179
README.md
179
README.md
|
|
@ -41,60 +41,7 @@ Needs DMD frontend 2.100.2 or newer to build
|
||||||
Widgets
|
Widgets
|
||||||
-------
|
-------
|
||||||
|
|
||||||
* Widget - base class for all widgets and widget containers, similar to Android's View
|
List of widgets, layouts and other is available in the [Wiki](https://github.com/buggins/dlangui/wiki#widgets)
|
||||||
|
|
||||||
Currently implemented widgets:
|
|
||||||
|
|
||||||
* TextWidget - simple static text (TODO: implement multiline formatting)
|
|
||||||
* ImageWidget - static image
|
|
||||||
* Button - simple button with text label
|
|
||||||
* ImageButton - image only button
|
|
||||||
* TextImageButton - button with icon and label
|
|
||||||
* CheckBox - check button with label
|
|
||||||
* RadioButton - radio button with label
|
|
||||||
* SwitchButton - a toggle switch button
|
|
||||||
* GroupBox - frame and caption for grouping other controls
|
|
||||||
* EditLine - single line edit
|
|
||||||
* EditBox - multiline editor
|
|
||||||
* VSpacer - vertical spacer - just an empty widget with layoutHeight == FILL_PARENT, to fill vertical space in layouts
|
|
||||||
* HSpacer - horizontal spacer - just an empty widget with layoutWidth == FILL_PARENT, to fill horizontal space in layouts
|
|
||||||
* ScrollBar - scroll bar
|
|
||||||
* SliderWidget - slider
|
|
||||||
* ProgressBarWidget - progress bar
|
|
||||||
* TabControl - tabs widget, allows to select one of tabs
|
|
||||||
* TabHost - container for pages controlled by TabControl
|
|
||||||
* TabWidget - combination of TabControl and TabHost
|
|
||||||
* GridWidgetBase - abstract Grid widget
|
|
||||||
* StringGrid - grid view with strings content
|
|
||||||
* TreeWidget - tree view
|
|
||||||
* ComboBox - combo box with text items
|
|
||||||
* ToolBar - tool bar with buttons
|
|
||||||
* StatusLine - control to show misc application statuses
|
|
||||||
* AppFrame - base class for easy implementation of apps with main menu, toolbars, status bar
|
|
||||||
|
|
||||||
Layouts
|
|
||||||
-------
|
|
||||||
|
|
||||||
Similar to layouts in Android
|
|
||||||
|
|
||||||
* LinearLayout - layout children horizontally or vertically depending on orientation
|
|
||||||
* VerticalLayout - just a LinearLayout with vertical orientation
|
|
||||||
* HorizontalLayout - just a LinearLayout with horizontal orientation
|
|
||||||
* FrameLayout - all children occupy the same place; usually only one of them is visible
|
|
||||||
* TableLayout - children are aligned into rows and columns of table
|
|
||||||
* ResizerWidget - put into LinearLayout between two other widgets to resize them using mouse
|
|
||||||
* ScrollWidget - allow to scroll its child if its dimensions are bigger than possible
|
|
||||||
* DockHost - layout with main widget and additional dockable panels around it
|
|
||||||
* DockWindow - dockable window with caption, usually to be used with DockHost
|
|
||||||
|
|
||||||
List Views
|
|
||||||
----------
|
|
||||||
|
|
||||||
Lists are implemented similar to Android UI API.
|
|
||||||
|
|
||||||
* ListWidget - layout dynamic items horizontally or vertically (one in row/column) with automatic scrollbar; can reuse widgets for similar items
|
|
||||||
* ListAdapter - interface to provide data and widgets for ListWidget
|
|
||||||
* WidgetListAdapter - simple implementation of ListAdapter interface - just a list of widgets (one per list item) to show
|
|
||||||
|
|
||||||
Resources
|
Resources
|
||||||
---------
|
---------
|
||||||
|
|
@ -211,130 +158,8 @@ Third party components used
|
||||||
|
|
||||||
Hello World
|
Hello World
|
||||||
--------------------------------------------------------------
|
--------------------------------------------------------------
|
||||||
```D
|
|
||||||
// myproject.d
|
|
||||||
import dlangui;
|
|
||||||
mixin APP_ENTRY_POINT;
|
|
||||||
|
|
||||||
/// entry point for dlangui based application
|
|
||||||
extern (C) int UIAppMain(string[] args) {
|
|
||||||
// create window
|
|
||||||
Window window = Platform.instance.createWindow("My Window", null);
|
|
||||||
// create some widget to show in window
|
|
||||||
window.mainWidget = (new Button()).text("Hello world"d).textColor(0xFF0000); // red text
|
|
||||||
// show window
|
|
||||||
window.show();
|
|
||||||
// run message loop
|
|
||||||
return Platform.instance.enterMessageLoop();
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Sample dub.json:
|
|
||||||
--------------------------------
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"name": "myproject",
|
|
||||||
"description": "sample DLangUI project",
|
|
||||||
|
|
||||||
"targetPath": "bin",
|
|
||||||
"targetType": "executable",
|
|
||||||
|
|
||||||
"dependencies": {
|
|
||||||
"dlangui": "~master"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Hello World using DML
|
|
||||||
--------------------------------------------------------------
|
|
||||||
|
|
||||||
DlangUI supports creation of widgets from markup.
|
|
||||||
|
|
||||||
DML - DlangUI Markup Language - similar to QML.
|
|
||||||
|
|
||||||
Example of complex UI easy created from text:
|
|
||||||
```D
|
|
||||||
module app;
|
|
||||||
|
|
||||||
import dlangui;
|
|
||||||
|
|
||||||
mixin APP_ENTRY_POINT;
|
|
||||||
|
|
||||||
/// entry point for dlangui based application
|
|
||||||
extern (C) int UIAppMain(string[] args) {
|
|
||||||
// create window
|
|
||||||
Window window = Platform.instance.createWindow("DlangUI example - HelloWorld", null);
|
|
||||||
|
|
||||||
// create some widget to show in window
|
|
||||||
//window.mainWidget = (new Button()).text("Hello, world!"d).margins(Rect(20,20,20,20));
|
|
||||||
window.mainWidget = parseML(q{
|
|
||||||
VerticalLayout {
|
|
||||||
margins: 10
|
|
||||||
padding: 10
|
|
||||||
backgroundColor: "#C0E0E070" // semitransparent yellow background
|
|
||||||
// red bold text with size = 150% of base style size and font face Arial
|
|
||||||
TextWidget { text: "Hello World example for DlangUI"; textColor: "red"; fontSize: 150%; fontWeight: 800; fontFace: "Arial" }
|
|
||||||
// arrange controls as form - table with two columns
|
|
||||||
TableLayout {
|
|
||||||
colCount: 2
|
|
||||||
TextWidget { text: "param 1" }
|
|
||||||
EditLine { id: edit1; text: "some text" }
|
|
||||||
TextWidget { text: "param 2" }
|
|
||||||
EditLine { id: edit2; text: "some text for param2" }
|
|
||||||
TextWidget { text: "some radio buttons" }
|
|
||||||
// arrange some radio buttons vertically
|
|
||||||
VerticalLayout {
|
|
||||||
RadioButton { id: rb1; text: "Item 1" }
|
|
||||||
RadioButton { id: rb2; text: "Item 2" }
|
|
||||||
RadioButton { id: rb3; text: "Item 3" }
|
|
||||||
}
|
|
||||||
TextWidget { text: "and checkboxes" }
|
|
||||||
// arrange some checkboxes horizontally
|
|
||||||
HorizontalLayout {
|
|
||||||
CheckBox { id: cb1; text: "checkbox 1" }
|
|
||||||
CheckBox { id: cb2; text: "checkbox 2" }
|
|
||||||
}
|
|
||||||
}
|
|
||||||
HorizontalLayout {
|
|
||||||
Button { id: btnOk; text: "Ok" }
|
|
||||||
Button { id: btnCancel; text: "Cancel" }
|
|
||||||
}
|
|
||||||
}
|
|
||||||
});
|
|
||||||
// you can access loaded items by id - e.g. to assign signal listeners
|
|
||||||
auto edit1 = window.mainWidget.childById!EditLine("edit1");
|
|
||||||
auto edit2 = window.mainWidget.childById!EditLine("edit2");
|
|
||||||
// close window on Cancel button click
|
|
||||||
window.mainWidget.childById!Button("btnCancel").click = delegate(Widget w) {
|
|
||||||
window.close();
|
|
||||||
return true;
|
|
||||||
};
|
|
||||||
// show message box with content of editors
|
|
||||||
window.mainWidget.childById!Button("btnOk").click = delegate(Widget w) {
|
|
||||||
window.showMessageBox(UIString("Ok button pressed"d),
|
|
||||||
UIString("Editors content\nEdit1: "d ~ edit1.text ~ "\nEdit2: "d ~ edit2.text));
|
|
||||||
return true;
|
|
||||||
};
|
|
||||||
|
|
||||||
// show window
|
|
||||||
window.show();
|
|
||||||
|
|
||||||
// run message loop
|
|
||||||
return Platform.instance.enterMessageLoop();
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
There is DMLEdit sample app in DlangUI/examples directory.
|
|
||||||
|
|
||||||
You can run it with dub:
|
|
||||||
```sh
|
|
||||||
dub run dlangui:dmledit
|
|
||||||
```
|
|
||||||
It allows to edit DML text and see how it will look like when loaded into app (F5 refreshes view).
|
|
||||||
|
|
||||||
Syntax highlight, bracket matching, go to error and other useful features are implemented.
|
|
||||||
|
|
||||||
|
Please refer to the [Wiki](https://github.com/buggins/dlangui/wiki#hello-world) for a hello world example.
|
||||||
|
|
||||||
DlangIDE project
|
DlangIDE project
|
||||||
------------------------------------------------------------
|
------------------------------------------------------------
|
||||||
|
|
|
||||||
|
|
@ -72,20 +72,28 @@ class HSpacer : Widget {
|
||||||
|
|
||||||
/// static text widget
|
/// static text widget
|
||||||
class TextWidget : Widget {
|
class TextWidget : Widget {
|
||||||
this(string ID = null, string textResourceId = null) {
|
this(string ID = null, string textResourceId = null)
|
||||||
|
{
|
||||||
super(ID);
|
super(ID);
|
||||||
styleId = STYLE_TEXT;
|
styleId = STYLE_TEXT;
|
||||||
_text.id = textResourceId;
|
_text.id = textResourceId;
|
||||||
|
trackHover = true;
|
||||||
}
|
}
|
||||||
this(string ID, dstring rawText) {
|
|
||||||
|
this(string ID, dstring rawText)
|
||||||
|
{
|
||||||
super(ID);
|
super(ID);
|
||||||
styleId = STYLE_TEXT;
|
styleId = STYLE_TEXT;
|
||||||
_text.value = rawText;
|
_text.value = rawText;
|
||||||
|
trackHover = true;
|
||||||
}
|
}
|
||||||
this(string ID, UIString uitext) {
|
|
||||||
|
this(string ID, UIString uitext)
|
||||||
|
{
|
||||||
super(ID);
|
super(ID);
|
||||||
styleId = STYLE_TEXT;
|
styleId = STYLE_TEXT;
|
||||||
_text = uitext;
|
_text = uitext;
|
||||||
|
trackHover = true;
|
||||||
}
|
}
|
||||||
|
|
||||||
/// max lines to show
|
/// max lines to show
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue