From 9221703a40be2a4941ed48ed45db20a3b05344cd Mon Sep 17 00:00:00 2001 From: Markus Gans Date: Tue, 4 Feb 2020 00:09:06 +0100 Subject: [PATCH] Add screenshorts to the first steps document --- ChangeLog | 3 + doc/first-steps.md | 68 +++++++++++++++++++--- doc/first-steps_callback-function.cpp.png | Bin 0 -> 873 bytes doc/first-steps_callback-lambda.cpp.png | Bin 0 -> 633 bytes doc/first-steps_callback-method.cpp.png | Bin 0 -> 469 bytes doc/first-steps_dialog.cpp.png | Bin 0 -> 390 bytes doc/first-steps_emit-signal.cpp.png | Bin 0 -> 491 bytes doc/first-steps_memory.cpp.png | Bin 0 -> 863 bytes doc/first-steps_scrollview.cpp.png | Bin 0 -> 908 bytes doc/first-steps_size-adjustment.cpp.png | Bin 0 -> 723 bytes doc/first-steps_timer.cpp.png | Bin 0 -> 405 bytes 11 files changed, 64 insertions(+), 7 deletions(-) create mode 100644 doc/first-steps_callback-function.cpp.png create mode 100644 doc/first-steps_callback-lambda.cpp.png create mode 100644 doc/first-steps_callback-method.cpp.png create mode 100644 doc/first-steps_dialog.cpp.png create mode 100644 doc/first-steps_emit-signal.cpp.png create mode 100644 doc/first-steps_memory.cpp.png create mode 100644 doc/first-steps_scrollview.cpp.png create mode 100644 doc/first-steps_size-adjustment.cpp.png create mode 100644 doc/first-steps_timer.cpp.png diff --git a/ChangeLog b/ChangeLog index c46c02c6..1e87e489 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,6 @@ +2020-02-04 Markus Gans + * Add screenshorts to the first steps document + 2020-02-02 Markus Gans * The methods clear() and remove() were added to FListView * Add some const type qualifiers diff --git a/doc/first-steps.md b/doc/first-steps.md index b900b3e5..a654f770 100644 --- a/doc/first-steps.md +++ b/doc/first-steps.md @@ -50,6 +50,12 @@ int main (int argc, char* argv[]) return app.exec(); } ``` +
+ dialog.cpp +
Figure 1. A blank dialog
+
+
+ *(Note: You can close the dialog with the mouse, Shift+F10 or Ctrl+^)* @@ -191,6 +197,12 @@ int main (int argc, char* argv[]) return app.exec(); } ``` +
+ memory.cpp +
Figure 2. FObject manages its child objects
+
+
+ *(Note: You can close the window with the mouse, Shift+F10 or Ctrl+^)* @@ -319,6 +331,12 @@ int main (int argc, char* argv[]) return app.exec(); } ``` +
+ timer.cpp +
Figure 3. FObject::onTimer event handler
+
+
+ *(Note: You can close the window with the mouse, Shift+F10 or Ctrl+^)* @@ -477,6 +495,12 @@ int main (int argc, char* argv[]) return app.exec(); } ``` +
+ callback-function.cpp +
Figure 4. Button with a callback function
+
+
+ *(Note: You can close the dialog with the mouse, Shift+F10 or Ctrl+^)* @@ -535,6 +559,12 @@ int main (int argc, char* argv[]) return app.exec(); } ``` +
+ callback-lambda.cpp +
Figure 5. Button with lambda expression callback.
+
+
+ *(Note: You can close the dialog with the mouse, Shift+F10 or Ctrl+^)* @@ -587,6 +617,12 @@ int main (int argc, char* argv[]) return app.exec(); } ``` +
+ callback-method.cpp +
Figure 6. Button with a callback method
+
+
+ *(Note: You can close the window with the mouse, Shift+F10 or Ctrl+^)* @@ -619,7 +655,7 @@ class dialogWidget : public FDialog { setGeometry (FPoint(25, 5), FSize(22, 7)); setText ("Emit signal"); - FSize size(5, 1); + const FSize size(5, 1); label.setGeometry (FPoint(8, 1), size); label.setAlignment (fc::alignRight); label.setForegroundColor (fc::Black); @@ -725,6 +761,12 @@ int main (int argc, char* argv[]) return app.exec(); } ``` +
+ emit-signal.cpp +
Figure 7. Callbacks with custom signals
+
+
+ *(Note: You can close the window with the mouse, Shift+F10 or Ctrl+^)* @@ -762,7 +804,7 @@ If you want to ignore padding spaces, you must force this with the
widget-coordinates -
Figure 1. Widget coordinates
+
Figure 8. Widget coordinates


@@ -812,7 +854,7 @@ methods.
widget-lengths -
Figure 2. Width and height of a widget
+
Figure 9. Width and height of a widget


@@ -865,7 +907,7 @@ absolute geometry values as a `FRect` object, you can call the method
widget-geometry -
Figure 3. Geometry of widgets
+
Figure 10. Geometry of widgets


@@ -946,11 +988,11 @@ class dialogWidget : public FDialog void adjustWidgets() { - auto bx = int(getWidth() - button.getWidth() - 3); - auto by = int(getHeight() - 4); + const auto bx = int(getWidth() - button.getWidth() - 3); + const auto by = int(getHeight() - 4); button.setPos (FPoint(bx, by), false); input.setWidth (getWidth() - 4); - auto ly = int(getHeight() / 2) - 1; + const auto ly = int(getHeight() / 2) - 1; input.setY (ly, false); } @@ -996,6 +1038,12 @@ int main (int argc, char* argv[]) return app.exec(); } ``` +
+ size-adjustment.cpp +
Figure 11. Dynamic layout
+
+
+ *(Note: You can close the window with the mouse, Shift+F10 or Ctrl+^)* @@ -1118,6 +1166,12 @@ int main (int argc, char* argv[]) return app.exec(); } ``` +
+ scrollview.cpp +
Figure 12. Dialog with a scrolling viewport
+
+
+ *(Note: You can close the window with the mouse, Shift+F10 or Ctrl+^)* diff --git a/doc/first-steps_callback-function.cpp.png b/doc/first-steps_callback-function.cpp.png new file mode 100644 index 0000000000000000000000000000000000000000..67c6f312f51cb2d5ddbf442aa1b9daa2d0d8eb75 GIT binary patch literal 873 zcmeAS@N?(olHy`uVBq!ia0y~yV5|VL7qBn`$uBFjl7SRwfk$L90|U1(2s1Lwnj--e zWH0gbb!C6T#4O6k8<*Y8e=q&U(5yhE&{odndQASwVp9!QLkO9SjqN-^@Gkm1)A6 zzw0+0FzD)7Yqo9bTkotVyZzmdoK<^!eTM2?k6)9%?EmO8srZ&h?9%xU53f1)Ik9Wq z%8OT@S@7mF?K(1>`G?oui_)KMMAzp(`082lm&fL(w@;?z%o4SIZ}j#!ZC!7?>CBGW zW8RiuJd0;dnQmtH+Ol5k-kHua7GFy1`uDo(_+y{CrFTrGM_zk-=zm@P|C~p` zCCg7b?>sVFtL~Nc)!# zZpHM1j|(S%J^#z(DN+Z7*MckF%bd}UAF<0V=3Pu_kyd#`W1 z`!wIr75~I_#Q)w5Us>Vz)ht`tE+mfc@8g?#uTO8>7<;Td(r&)@xl85lPo~aQK2RB* zudEk*uiPqRZ{4ck;MqR$wfFbD-}&PWTl~Y9eDnAoyyS?}yDz&(XW~kkV?U#!>sACj z+of6;r?(}GKX==U-Nv7`NXIuQ+3mi5>czCuDZ2YN?d`C!mCwIg{c+2kKoNVLA42P| z)ojaow406k2aJXGfZKZ-JGnmz486y>=(grYSSk0U*fta z?|k^jmLR1%8S#pLUhiDXXL~&<_5M+GHeUKX|4K#K&w0Whp5_(X{%I_+{48<*YJu##o-U3d6}R5r$?ZF&AkdJw{(`o^bC!3UG5QZw_Wlo@ z*1vGdE;kcj-CurU%v&y`tEc=4<)0q8!|&0A$B#c2-M+qTxyNDKe!kd$@IA}?xRb2>`&OC#dn_~ieR*?!Z|tM!|B6Qcul^8N z|NjdU*z)&``zsp|PT6l(_d@5#%wUka{!7*L-P^b70Fq1X|1fS@BY%8%Nz7$X%J6jc Kb6Mw<&;$VShcajY literal 0 HcmV?d00001 diff --git a/doc/first-steps_callback-method.cpp.png b/doc/first-steps_callback-method.cpp.png new file mode 100644 index 0000000000000000000000000000000000000000..47669cefd2804c708b1fc95ef74365945ffa3e89 GIT binary patch literal 469 zcmeAS@N?(olHy`uVBq!ia0vp^H-NZ-g&9cBzP!r?NO2Z;L>4nJa0`PlBg3pY5H=O_9sltqM{sJ-x=6}LZSgaA+A6g2>7k$`uqFu-o5+ZzkmP#|GzoA5~PQ*B*-tA z!Qt7BG!Q4r+uemNF>OaJkZtMd;uw-~@9nKd-X;S9hrsZJ)?5YM3PqQ{-!o3@Qul}#-keVRsZ@%A0fLwcCR> z?$KRoEwoiv^Dp;Cn->9*aw!L?P z<66$$CdUj9^_=ExzO?`V literal 0 HcmV?d00001 diff --git a/doc/first-steps_dialog.cpp.png b/doc/first-steps_dialog.cpp.png new file mode 100644 index 0000000000000000000000000000000000000000..c9b0af933ba6af0027fe6ef29e3cc2a2176606c8 GIT binary patch literal 390 zcmeAS@N?(olHy`uVBq!ia0y~yU<5K5Hn1=QNuh^prvNF=0*}aI1_o|n5N2eUHAey{ z$X?><>&pIwiCIKP*Ke!wS)h<;fKP}kkOl&NtGWLE{=0YY{`c?S|NsAQ&aMRMVJr#q z3ubV5b|VeMN%D4gVM|QgQ48d}@^o0c)pDRyc1iqhdB?zcTOJ$`KmjtrzE}U5J%MJ_@F%SE2Zb*XD99GD&2x~B2!G9L P2jY9W`njxgN@xNA2f=X@ literal 0 HcmV?d00001 diff --git a/doc/first-steps_emit-signal.cpp.png b/doc/first-steps_emit-signal.cpp.png new file mode 100644 index 0000000000000000000000000000000000000000..3bd6a1523b188eb0c1542d8dd0575b2971f4e891 GIT binary patch literal 491 zcmeAS@N?(olHy`uVBq!ia0vp^2Y|SNg&9b$UsW9eq&N#aB8wRqxP?KOkzv*x37{Z* ziKnkC`x7Q+QE}6Rm3mWvLZSgaA+A6g2>7k$`uqFu-o5+ZzkmP#|GzoA5~PQ*B*-tA z!Qt7BG!Q4r+uemNF>OaJknQj3;uw-~@9oXlyk-LdmIpD7?RyV+RWscZ-XeZu?X!R3 zFPnLrL_E0fsZC2;!XPwl|BvvA#lK@*q@S5RUD?1GDEBJ8t}t96z47T`!G!R}xn8pv z7(y0it@z8(vgi(P0IMDY2k+&GvWZu_SGKKe%c`wssp)xqJC0k9$sy*|qUwZKlQ=ir z-}1oUVeJNCh7JQ>*A>&eXZm&+buTkq@p|LeFu|MEfkq5_PULkh;W1_5*uqfbae~X^ z$1lGIhQ`kg-a-M_>=feOt!2~?MkW>xfgkY+zY|`kAL|u(!MoueV|0Z30qYN?J6WGrye#An zdpeI_gOLg7v(C4_W|aOx^$TXMv&r6R6pmu$(l>hVRh%m8KF)icqRCEA|#WLJ~ XQjyd!`AOv*P+WMr`njxgN@xNA4vn|$ literal 0 HcmV?d00001 diff --git a/doc/first-steps_memory.cpp.png b/doc/first-steps_memory.cpp.png new file mode 100644 index 0000000000000000000000000000000000000000..33a1b494a075c2a2f4bb47c599491b92b945f1af GIT binary patch literal 863 zcmeAS@N?(olHy`uVBq!ia0y~yU*?YcQgQ3;o!Gp`3IgmO;u_WOeSX9o za!Xj@C(Bj2gr&9WrKaI8Hl9A-aIo{O)bX}u{{uPsIKPA^-0ASD{W<^0(t{P8AGH^R z|Gv7^|G0wE|5>_M3`~@qSMu%EanRRwJiDpPrEKk4)82}>qVKbIFFSSNoaMTODHoQM zT$a>t{8wH3H<;z^JBQuO3y&J_V$Is_X1b!2*ElM_|I*Umk^%F-hVTDx@p|`!yLy+` z|2ufibo0L+29ba)8y5Bj4NSj&FNiXck=*j|<&_2|E)Adv67fQA#VP@RrrO`t#&3-; zG`35J)GxQqecj(scfl;9o;g!um6qdHfqep=(d-%dtM-|D=gyzBzPfzvj%Q`2cIL+x z>fd?vI)MAhq;o5NFJrzQbLdifu2#Nvp4;>VS<+XwhBVK5`c(Do!aH&c-+f&u@v6Vz z``L^=^Ukc8b!Npa9AP>Fx>`)lQ1oqpDp86UP>s(+N{^qufpWFBmk^JJa(|(2% Wq9NzHelSFV(!ZyxpUXO@geCwt;)FE- literal 0 HcmV?d00001 diff --git a/doc/first-steps_scrollview.cpp.png b/doc/first-steps_scrollview.cpp.png new file mode 100644 index 0000000000000000000000000000000000000000..e7ec1583709e9fe37a929b379b53a549d96dc48b GIT binary patch literal 908 zcmeAS@N?(olHy`uVBq!ia0vp^7Z?~A6IhsmEDQ5jZ9s~%z$3Dlfq`2Xgc%uT&5-~K zvX^-Jy0SlEVir}?IQq%;KTt?Iz$e5NNCN@C)m(pn|B%dc^^0Hc-o5+ZzkmP#{|~%b zdIc!QSQ6wH%;50sMjD8di@D^C~4kcwMx??&f6RuE};nAbS{*Ixa| z2Gy{JC!!^cqCxkBBa^r{zhR8G@|5z}*r@o#e$wj%^?yYS@h8^iAMgHgLLfgogkAQ` z&3}94=Q>|5CV5=SgeKR7qp!yu34({3hu|aakX0rasMAxcmLn^$Dkwv_&Rg zO!Rk~>iGHEXXkazzLWnNpa1;D%6|)+Wbng_w^R5wvIt!G-{7Z|9OEc?*^&_iwld89 zG^hKWL**t$CZ=2Bc?s+xmS3*QsN9oo-q(`Bv*~tSKKCPmDeOUiSKu;hC!pU2(CkgO9k0&hkie(>zr)T;((ukOFiCsporIH)U47Bsw)=t+OZPdCpNi8j%@C2QoiH=1NZI83uGH|Ts<}a*H?6!L zo3^AZJALpfe+e>f#b_;F3U-ejE zicFDqm4A)fu`UMHb{8#=7R8BtLW&+sT3YyLadRr3e{Vd4M^aLL%C6o&0gvLu8!o+b zcR0_T%BcVX3wSTQ<$V9iaQ3xO#*_Q5-}2kn>v`U4dyLS^ladNBSiDgf9+7&gmC+`K-6DnpbLj*E+2|_kF~5u_G&G zIDnwzW1yc#$xhLxMf%&#oR1oLap{Wh`>D8+Id_Tj!V4RoZaY|>s$!ld!pnNh-Sf7F ziQTHj)y8&7HE``0onKV&#OLYGm-xByoZk9xe;5B_yi&bjpI=72^wHk_ru^4m{;4la z*8g?YzBcBPZtFJUvE>)z_^!bOWO$<2QX;-!R?l6Tz%t!ULq*7 Nc)I$ztaD0e0syNXg?|75 literal 0 HcmV?d00001 diff --git a/doc/first-steps_size-adjustment.cpp.png b/doc/first-steps_size-adjustment.cpp.png new file mode 100644 index 0000000000000000000000000000000000000000..a3dfead2e3ad225ed3ff1074b40e1a920eeec85c GIT binary patch literal 723 zcmeAS@N?(olHy`uVBq!ia0y~yUmPL4a@#T( z7BdR*IXq+1yK{KP7p~$rmFso+dSinE*K zV)gwCAL%%UR_^iDaXwvV8bmIt1snlg+08w zeBrI5;ZDJ&UuJArd})ubbF-f6mag{XU;H)pPc(Dp$9>gr{5SdD9rn6=0pEXk+P`0| zo^JD7Vu3?r9{;Vkyy;A)ch2!?1T1j4&b+sWse~`&RnnfrvR`tRF1}mBzQA)q(N3k= zi!PrQ6Mw$ZZu--wO3vH!+pCuJJluNQrYuB`T~=+uyfnF0+WWO*_+(2fOH3Y}ac&RQ zcP)(m%KRlrE@#cJnaeK}>pibpFnjlz$6WFtn;Mx|xkPX=eEHY*rpjJeZ8ytmn$euV z6{}}!ZrOM%(DTlDi!Gh`+l#~PrQ)Sqxz>Grnx9){_>}Xi^8?0;9{7W=biDpRhyXUJx7S58KlJC`kZgG9EF3$zk3;l^zU59nHtlHP0*4|dV z`S-%o9fI2qCWlDfM;-t8W&yUbSj{nh$juXG_RSIA0TZ9(yak`mK^ zv!9}UnZbVAr^yKOTCK9l^#AEbav=Y1<&)iH4rW1ozPjZfLtm@K{W`lBdq8Q<)78&q Iol`;+09}hElmGw# literal 0 HcmV?d00001 diff --git a/doc/first-steps_timer.cpp.png b/doc/first-steps_timer.cpp.png new file mode 100644 index 0000000000000000000000000000000000000000..4ae8a3f40673fe8c66b7e31f8150705812d543c7 GIT binary patch literal 405 zcmeAS@N?(olHy`uVBq!ia0vp^CxAGBg&9b$b5?H#Qk(@Ik;M!Q+`=Ht$S`Y;1W=H@ z#M9T6{RtDZD3`d`Qsx|>kZ6EUh%1l=0)DHx{{H^Eckll9@8AFb|8LH&1nFTc3GxeO zaCmkj4a7aSVw#{PubxSF-^RYr^^o@_QW?s27;u(3@~*_y5pu z%A(J&Sk9Gnz1OVN`Y7E;_l9lUBK76cmqaE7h7`|L;JRp|WXW^!lU1klf>jO54O#)` z-1jsE-H(|Wvc2`r?|3 zRGQe~8KCA7AnDe^F|kc>;>|^^hhLZO17~