Görselleştirmede bir diyalog penceresini çağırmaPermalink

Bir görselleştirme için, başvurulan görselleştirmenin bir iletişim kutusu olarak açılmasına neden olan bir kullanıcı girişi yapılandırabilirsiniz. Örneğin, bir kullanıcı bir düğmeye tıklar ve bunun üzerine değerlerin girilmesini isteyen bir iletişim kutusu açılır. Bir diyalog penceresi kullanıcı girdilerini toplamak için kullanılır ve eğer modal ise, diyalog penceresi dışındaki girdilerin engellenmesine yol açabilir.

Yalnızca «Dialog» görselleştirme türüne sahip görselleştirmeler iletişim kutusu olarak açılabilir. Görselleştirme türü, bir görselleştirme nesnesinin «Özellikler» iletişim kutusunda yapılandırılır.

Temel prosedür:

Gereklilik: Proje bir ana görselleştirme ve bir iletişim kutusu içerir.

  1. İletişim kutusu için «OpenDialog» eylemi ile ana görselleştirme için bir kullanıcı girişi yapılandırın.

    Diyalog penceresinin açılması yapılandırılır.

  2. İletişim kutusunun bir öğesi için «CloseDialog» eylemiyle bir kullanıcı girişi yapılandırın.

    İpucu: Modal olmayan diyalog pencerelerinde, diyalog penceresinin dışında kapatma için kullanıcı girdisini de yapılandırabilirsiniz.

    Diyalog penceresinin kapanışı yapılandırılır.

Kendi oluşturduğunuz diyaloglar yerine kütüphanedeki diyalogları da kullanabilirsiniz. Örneğin, ‎VisuDialogs‎ kütüphanesi projeye entegre edilmişse, içinde bulunan ‎VisuDialogs.Login‎ veya ‎VisuDialogs.FileOpenSave‎ diyalog kutularını kullanabilirsiniz.

Ayrıca bakınız

Bir görselleştirme nesnesini iletişim kutusu olarak yapılandırma

  1. Nesneyi «Devices» görünümünde seçin, içerik menüsünü açın ve «Properties» komutunu seçin.

  2. «Visualization» sekmesini seçin.

  3. «Dialog» seçeneğini etkinleştirin ve «OK» ile iletişim kutusunu kapatın.

    Görselleştirme, «Dialog» görselleştirme türüne sahiptir ve bu şekilde çağrılabilir.

Diyalog çağrısını yapılandırma

Bir iletişim kutusu çağrılırken, kullanıcı normalde bir düğmeye tıklar ve bunun üzerine bir girdi talep eden bir iletişim kutusu açılır.

Aşağıdaki örnekte, bir takvimi temsil eden bir iletişim kutusu bir tarihin girilmesini sağlar.

Gereklilik: Proje ‎visMain‎ ve ‎dlgCalender‎ görselleştirmelerini içermektedir.

  1. ‎dlgCalender‎ adresinin görselleştirme türünü Dialog olarak ayarlayın.

  2. Görselleştirmeye bir dikdörtgen sürükleyin ‎visMain‎.

  3. «Texts  Text» özelliğini ‎Due Date: %t[yyyy-MM-dd]‎ metni ile yapılandırın.

    «özelliğini yapılandırın Metin değişkenleri  Metin değişkeni» ile ‎PLC_PRG.dateDue‎.

  4. Görselleştirmenin içine bir düğme sürükleyin.

  5. «Texts  Text» özelliğini ‎Open dialog‎ metni ile yapılandırın.

    «Giriş yapılandırması  OnMouseClick» eylemi için «Open Dialog» özelliğini ‎dlgCalender‎ ile yapılandırın.

    Diyaloğun açılması için kullanıcı girişi yapılandırılır.

  6. İletişim kutusuna çift tıklayın ‎dlgCalender‎.

  7. «Tarih seçici» öğesini görselleştirme düzenleyicisine sürükleyin.

  8. «Texts  Text» özelliğini ‎Due Date: %t[yyyy-MM-dd]‎ ile yapılandırın.

    «Değişken» özelliğini ‎PLC_PRG.dateCalender‎ ile yapılandırın.

    Eleman yapılandırılmıştır.

  9. Görselleştirme düzenleyicisine bir düğme sürükleyin.

  10. «Texts  Text» özelliğini ‎OK‎ ile yapılandırın:

  11. «Giriş yapılandırması  OnMouseClick»eylemi için «İletişim Kutusunu Kapat »özelliğini ‎dlgCalender, Result: OK‎ ile yapılandırın.

  12. Başka bir özelliği yapılandırın «Giriş yapılandırması  Eylem için OnMouseClick» « ST Kodunu Yürüt» ile ‎PLC_PRG.dateDue := PLC_PRG.dateCalendar;‎.

    Diyaloğun kapatılması için kullanıcı girişi yapılandırılır.

  13. Görselleştirme düzenleyicisine başka bir düğme sürükleyin.

  14. «Texts  Text» özelliğini ‎Cancel‎ ile yapılandırın:

  15. «Giriş yapılandırması  OnMouseClick» eylemi için «İletişim Kutusunu Kapat »özelliğini ‎dlgCalender, Result: Cancel‎ ile yapılandırın.

  16. Diyaloğun iptali için kullanıcı girişi yapılandırılır.

  17. Uygulamayı derleyin, yükleyin ve başlatın.

    _visu_img_dlg_calendar

Değişken bildirimi:

                PROGRAM PLC_PRG
                VAR
                dateDue : DATE := DATE#2000-01-01;
                dateCalendar : DATE;
                END_VAR
              

Bir iletişim kutusuna uygulama erişimi uygulama

Uygulama kodunda, iletişim kutusu yöneticisinde yönetilen bir iletişim kutusuna erişimi uygulayabilirsiniz. Diyalog yöneticisi, «Dialog» türündeki tüm görselleştirmeleri otomatik olarak örnekler ve yönetir. Erişim dahili görselleştirme yöneticisi aracılığıyla gerçekleşir.

Öncelikle, dahili görselleştirme yöneticisinin ‎GetDialogManager()‎ yöntemini çağırarak diyalog yöneticisine erişimi uygulayın. Daha sonra bir diyalog penceresinin program sırasını programlamak için diyalog yöneticisinin yöntemlerini kullanabilirsiniz.

Aşağıdaki örnekte bir düğme, üzerine tıklandığında önceden yapılandırılmış ‎Login‎ iletişim kutusunu açacak şekilde yapılandırılmıştır. Kullanıcı iletişim kutusuna bir ad ve parola girebilir. ‎Login‎ iletişim kutusu ‎VisuDialogs‎ kütüphanesinde bulunmaktadır. Kendi oluşturduğunuz bir diyaloğu da aynı şekilde çağırabilirsiniz.

‎Login‎ iletişim kutusuna ‎VisuDialogs‎ kütüphanesinden bir uygulama erişiminin uygulanması:

Gereklilik: ‎VisuDialogs‎ kütüphanesi projeye entegre edilmiştir.

  1. Uygulamanın altına yeni bir görselleştirme ‎visMain‎ ekleyin.

    Görselleştirme düzenleyicisi açılır.

  2. Görselleştirme düzenleyicisine bir düğme sürükleyin.

  3. Özelliğine girin «Metin»‎Login‎.

    Düğme etiketlenmiştir.

  4. «Configure »özelliğinde «Input configuration  OnMouseDown» üzerine tıklayın.

  5. «Execute ST-Code» giriş eylemini seçin ve _visu_icon_arrow_right üzerine tıklayın.

  6. ST editörüne aşağıdaki fonksiyon çağrısını girin: ‎OpenLoginDialog(pClientData);‎

    Ana görselleştirme bir düğme içerir. Kullanıcı düğmeye tıklarsa ‎Login‎ iletişim kutusu açılır ve ‎OpenLoginDialog()‎ işlevi çağrılır.

  7. «Configure »özelliğinde «Input configuration  OnDialogClosed» üzerine tıklayın.

  8. «Execute ST-Code» giriş eylemini seçin ve _visu_icon_arrow_right üzerine tıklayın.

  9. ST editörüne aşağıdaki fonksiyon çağrısını girin: ‎OnLoginDialogClosed(pClientData);‎

    Bir kullanıcı iletişim kutusunu kapatırsa, ‎OnLoginDialogClosed()‎ işlevi çağrılır.

    login_dialog.png

OpenLoginDialog() işlevinin uygulaması:

                FUNCTION OpenLoginDialog : BOOL
                VAR_INPUT
                pClientData : POINTER TO VisuStructClientData;
                END_VAR

                VAR
                dialogMan : IDialogManager;
                loginDialog : IVisualisationDialog;
                pLoginInfo : POINTER TO Login_VISU_STRUCT; // Login_VISU_STRUCT contains the parameters defined in the interface of visualization "Login".
                result : Visu_DialogResult;
                stTitle : STRING := 'Login ...';
                stPasswordLabelText: STRING;
                stUserLabelText: STRING;
                stUsername: STRING;
                END_VAR

                dialogMan := g_VisuManager.GetDialogManager(); // The DialogManager is provided via the implicitly available VisuManager
                IF dialogMan <> 0 AND pClientData <> 0 THEN
                loginDialog := dialogMan.GetDialog('VisuDialogs.Login'); // Dialog to be opened is specified
                IF loginDialog <> 0 THEN
                pLoginInfo := dialogMan.GetClientInterface(loginDialog, pClientData);
                IF pLoginInfo <> 0 THEN      // In the following the parameters of the login dialog in the Login_VISU_STRUCT will be read
                pLoginInfo^.stTitle := stTitle;
                pLoginInfo^.stPasswordLabelTxt := stPasswordLabelText;
                pLoginInfo^.stUserLabelTxt := stUserLabelText;
                dialogMan.OpenDialog(loginDialog, pClientData, TRUE, 0);
                END_IF
                END_IF
                END_IF
              

‎OnLoginDialogClosed()‎ bir iletişim kutusunun kapatılmasına verilen tepkiyi tanımlar.

Fonksiyonun uygulanması ‎OnLoginDialogClosed()‎:

                FUNCTION OnLoginDialogClosed : BOOL
                VAR_INPUT
                pClientData : POINTER TO VisuStructClientData;
                END_VAR

                VAR
                dialogMan : IDialogManager;
                loginDialog : IVisualisationDialog;
                pLoginInfo : POINTER TO Login_VISU_STRUCT;
                result : Visu_DialogResult;
                stPassword: STRING;
                stUsername: STRING;
                END_VAR

                dialogMan := g_VisuManager.GetDialogManager(); // The DialogManager is provided via the implicitly available VisuManager
                IF dialogMan <> 0 AND pVisuClient <> 0 THEN
                loginDialog := dialogMan.GetDialog('VisuDialogs.Login'); // Gets the login dialog
                IF loginDialog <> 0 THEN
                result := loginDialog.GetResult(); // Gets the result (OK, Cancel) of the dialog
                IF result = Visu_DialogResult.OK THEN
                loginDialog.SetResult(Visu_DialogResult.None); // Reset to default (none)
                pLoginInfo := dialogMan.GetClientInterface(loginDialog, pVisuClient); // Structure Login_VISU_STRUCT gets read;
                // In the following the structure parameters can be set
                IF pLoginInfo <> 0 THEN
                stPassword := pLoginInfo^.stPasswordpLoginInfo^.stPassword := ''; // Reset the passwword
                stUsername := pLoginInfo^.stUsername;
                END_IF
                ELSIF result = Visu_DialogResult.Cancel THEN
                loginDialog.SetResult(Visu_DialogResult.None); // React on 'Cancel'
                ELSE
                // nothing to do
                END_IF
                END_IF
                END_IF
              

Ayrıca bakınız