Added setFont overload to tkd.widget.common.font.

nomad-software · May 5, 2019 · 9ee5512 · 9ee5512
1 parent 2197847
commit 9ee5512
Show file tree

Hide file tree

Showing 3 changed files with 52 additions and 9 deletions.
diff --git a/docs/tkd/widget/common/font.html b/docs/tkd/widget/common/font.html
@@ -246,15 +246,28 @@
 		<h1>tkd.widget.common.font</h1>
 		<div class="sections"><p>Font module.
 </p><h3>License</h3><p>MIT. See LICENSE for full details.</p></div><div class="module-members"><div class="member"><h2><span class="ddoc_anchor" id="Font"></span>template <span class="symbol">Font</span>()</h2>
-<div class="declaration-description"><div class="sections"><p>These are common commands that apply to all widgets that have them injected.
-</p><p><h3>Example</h3><pre>widget.setFont(<span class="string">"PragmataPro"</span>, 10, FontStyle.bold, FontStyle.italic);
-</pre>
-</p></div><div class="template-members"><div class="member"><h2><span class="ddoc_anchor" id="Font.setFont"></span>auto <span class="symbol">setFont</span>(this T)(string font, int size, FontStyle[] styles...);
+<div class="declaration-description"><div class="sections"><p>These are common commands that apply to all widgets that have them injected.</p></div><div class="template-members"><div class="member"><h2><span class="ddoc_anchor" id="Font.setFont"></span>auto <span class="symbol">setFont</span>(this T)(string font, int size, FontStyle[] styles...);
 </h2>
 <div class="declaration-description"><div class="sections"><p>Set the font and style for the widget.
 </p><h3>Parameters</h3><table class="parameter-list"><tr><td>string font</td><td>The name of the font like 'Arial' or 'arial'.</td></tr><tr><td>int size</td><td>The size of the font like '12'.</td></tr><tr><td>FontStyle[] styles</td><td>The different font styles.</td></tr></table><h3>Return Value</h3><p>This widget to aid method chaining.
 
+</p><p><h3>Example</h3><pre>widget.<span class="symbol">setFont</span>(<span class="string">"PragmataPro"</span>, 10, FontStyle.bold, FontStyle.italic);
+</pre>
+
 </p><h3>See Also</h3><p><a href="../../element/fontstyle.html">tkd.element.fontstyle</a> for font styles.</p></div></div>
+</div><div class="member"><h2><span class="ddoc_anchor" id="Font.setFont.2"></span>auto <span class="symbol">setFont</span>(this T)(string fontInfo);
+</h2>
+<div class="declaration-description"><div class="sections"><p>Set the font and style for the widget via a simple string.
+ This method is exists to set the font using the output of the font dialog.
+</p><h3>Parameters</h3><table class="parameter-list"><tr><td>string fontInfo</td><td>The output of the file dialog.</td></tr></table><h3>Return Value</h3><p>This widget to aid method chaining.
+
+</p><p><h3>Example</h3><pre><span class="keyword">auto</span> dialog = <span class="keyword">new</span> FontDialog(<span class="string">"Choose a font"</span>)
+    .setCommand(<span class="keyword">delegate</span>(CommandArgs args){
+        widget.<span class="symbol">setFont</span>(args.dialog.font);
+    })
+    .show();
+</pre>
+</p><h3>See Also</h3><p><a href="../../window/dialog/fontdialog.html">tkd.window.dialog.fontdialog</a> for how to recieve output.</p></div></div>
 </div></div></div>
 </div></div>
 	</body>

diff --git a/source/example/example.d b/source/example/example.d
@@ -37,6 +37,7 @@ class Application : TkdApplication
 	{
 		auto dialog = new FontDialog("Choose a font")
 			.setCommand(delegate(CommandArgs args){
+				this._fontEntry.setFont(args.dialog.font);
 				this._fontEntry.setValue(args.dialog.font);
 			})
 			.show();
@@ -53,6 +54,7 @@ class Application : TkdApplication
 		auto dialog = new ColorDialog("Choose a color")
 			.setInitialColor(Color.beige)
 			.show();
+		this._colorEntry.setForegroundColor(dialog.getResult());
 		this._colorEntry.setValue(dialog.getResult());
 	}
 

diff --git a/source/tkd/widget/common/font.d b/source/tkd/widget/common/font.d
@@ -8,11 +8,6 @@ module tkd.widget.common.font;
 
 /**
 * These are common commands that apply to all widgets that have them injected.
-*
- * Example:
- * ---
- * widget.setFont("PragmataPro", 10, FontStyle.bold, FontStyle.italic);
- * ---
 */
 mixin template Font()
 {
@@ -31,6 +26,11 @@ mixin template Font()
 	 * Returns:
 	 *     This widget to aid method chaining.
 	 *
+	 * Example:
+	 * ---
+	 * widget.setFont("PragmataPro", 10, FontStyle.bold, FontStyle.italic);
+	 * ---
+	 *
 	 * See_Also:
 	 *     $(LINK2 ../../element/fontstyle.html, tkd.element.fontstyle) for font styles.
 	 */
@@ -40,4 +40,32 @@ mixin template Font()
 
 		return cast(T) this;
 	}
+
+	/**
+	 * Set the font and style for the widget via a simple string.
+	 * This method is exists to set the font using the output of the font dialog.
+	 *
+	 * Params:
+	 *     fontInfo = The output of the file dialog.
+	 *
+	 * Returns:
+	 *     This widget to aid method chaining.
+	 *
+	 * Example:
+	 * ---
+	 * auto dialog = new FontDialog("Choose a font")
+	 *     .setCommand(delegate(CommandArgs args){
+	 *         widget.setFont(args.dialog.font);
+	 *     })
+	 *     .show();
+	 * ---
+	 * See_Also:
+	 *     $(LINK2 ../../window/dialog/fontdialog.html, tkd.window.dialog.fontdialog) for how to recieve output.
+	 */
+	public auto setFont(this T)(string fontInfo)
+	{
+		this._tk.eval("%s configure -font {%s}", this.id, fontInfo);
+
+		return cast(T) this;
+	}
 }