Notes/Dominoの@関数を取り上げながら、調べたこと、経験したことを雑談してゆきます。 第29回も @DialogBox について。

1. @
@
-notes knows community- 2021/06/10
阿部 覚 (tw:) @abesat
@関数Talk
第29回 公開版

2. @
@
コロナ禍で、また少々長めに、熟成待ち…
要は間が空いちゃいましたので
私自身、「前回何やってたっけ？」なところがありますが
引き続き

3. @
@
@DialogBox
で放談

4. @
@
今回のネタも@DialogBox
値も返すけれども
主機能はこんなダイアログ画面を表示すること
（および必要に応じ、
この画面で得たフィールド値を
元の文書にセットすること）

5. @
@
今回のネタも@DialogBox
値も返すけれども
主機能はこんなダイアログ画面を表示すること
（および必要に応じ、
この画面で得たフィールド値を
元の文書にセットすること）
前回はダイアログ画面に使える設計の種類や
前回はダイアログ画面に使える設計の種類や
画面の表示
画面の表示範囲
範囲の話でしたが
の話でしたが

6. @
@
今回のネタも@DialogBox
値も返すけれども
主機能はこんなダイアログ画面を表示すること
（および必要に応じ、
この画面で得たフィールド値を
元の文書にセットすること）
☝
☝今回は
今回は
この部分のお話かなと
この部分のお話かなと

7. @
@
@DialogBoxでのフィールド値のセットとは
例えばこんなフォームがあって
例えばこんなフォームがあって
@DialogBox
@DialogBoxの
の
こんな式が入っていて
こんな式が入っていて
こんなボタンに
こんなボタンに

8. @
@
@DialogBoxでのフィールド値のセットとは
いっぽう、
いっぽう、
ダイアログ側のサブフォームは
ダイアログ側のサブフォームは
チェックボックスの
チェックボックスの
こんな
こんな
選択になっているとすると
選択になっているとすると
フォーム側の
フォーム側の
好きな食べ物と
好きな食べ物と
同じフィールド名が
同じフィールド名が

9. @
@
@DialogBoxでのフィールド値のセットとは
実際の文書画面では、ボタンを押すと、
実際の文書画面では、ボタンを押すと、
こんなダイアログが出て
こんなダイアログが出て

10. @
@
@DialogBoxでのフィールド値のセットとは
ダイアログで、選択チェックして
ダイアログで、選択チェックしてOK
OKすると、
すると、
元の文書の同じフィールドに反映される
元の文書の同じフィールドに反映される
とまあ、こんな感じです
とまあ、こんな感じです

11. @
@
@DialogBoxでのフィールド値のセットとは
元のフォームとダイアログとで
元のフォームとダイアログとで
同じフィールド名を使っているのがポイントになります
同じフィールド名を使っているのがポイントになります

12. @
@
どんな状態からアクセスすれば
@DialogBoxが文書更新してくれるかですが
こんな感じでした
@DialogBoxでのフィールド値のセットが有効なのは
編集モードの文書 更新される
読み込みモードの文書 更新されない
ビューで選択中の文書 更新される
特に要注意だと思ったのは、ビューからの@DialogBox
文書を開かず、保存せずに内容を変更できてしまいます

13. @
@
つぎに、@DialogBoxのキーワードのうち
フィールドの更新に絡んだ引数に着目したいと思います
@DialogBox( form ;
[AUTOHORZFIT] :[AUTOVERTFIT] :
[NOCANCEL] :[NONEWFIELDS] :
[NOFIELDUPDATE] :[READONLY] :
[SIZETOTABLE] :[NOOKCANCEL] :[OKCANCE
LATBOTTOM] :[NONOTE] ;
title )
@DialogBox の構文はこんなでしたね
フォームの名前
キーワード
タイトル

14. @
@
検証に使ったフォームとサブフォーム
文書用のフォームと
ダイアログ用のサブフォームは
FieldBだけが共通に存在します
文書側のFieldCと、ダイアログ側のFieldAは
フィールドとしては存在しませんが、
もし「内部的に作られたら」
計算結果テキストで表示します

15. @
@
引数なしで実施
ダイアログ内で手入力

16. @
@
[NONEWFIELDS]
ダイアログ内で手入力
文書と共通するフィールドしか
値を反映できません

17. @
@
[NOFIELDUPDATE]
ダイアログ内で
手入力
ダイアログで入力しても文書に反映されません

18. @
@
[READONLY]
手入力の
しようがないので
そのままOK
ダイアログが読み込みモードになるということですね
フィールドがあってもデータの引継ぎはなし

19. @
@
[NONOTE]
文書からダイアログに渡さず、ダイアログからも受け取らない
ダイアログ内で
手入力

20. @
@
更新に関わる引数のなんとなくまとめ
[NOFIELDUPDATE]と[NONOTE]は
用途が限定されてると思え、
あまり覚えなくてよいのではないかと思います
前回、@DialogBoxに「ページ」が利用できるお話をしましたが
ページを使えばデータ更新のないダイアログ表示で
これらの引数を気にしなくてよいと思います

21. @
@
おまけ
ダイアログに"自分のフォーム"を
指定したらどうなる？を
やってみました
表示されるダイアログ内でも
さらに@DialogBoxのボタンを押すのを
繰り返したら…
5回目で怒られました😅

22. @
@
おまけ
実はダイアログのサブフォームには
文書を保存するボタンを仕込んでいました
ダイアログ内でこれを押したらどうなったか？
については
いずれ、ブログにて補足いたします
( https://abesat.blog.jp/ )

23. @
@
今回もお付き合い
ありがとうございました 😀