Dialog नियंत्रण (प्रयोगात्मक)

[यह आलेख रिलीज़-पूर्व दस्तावेज़ है और परिवर्तन के अधीन है.]

सामग्री को समूहीकृत करने के लिए उपयोग किया जाने वाला नियंत्रण.

महत्त्वपूर्ण

• यह एक प्रायोगिक सुविधा है.
• प्रायोगिक विशेषताएं उत्पादन उपयोग के लिए नहीं हैं और कार्यक्षमता प्रतिबंधित हो सकती हैं. यह सुविधाएँ आधिकारिक रिलीज़ से पहले उपलब्ध होती हैं ताकि ग्राहक शीघ्र पहुँच प्राप्त कर सकें और प्रतिक्रिया प्रदान कर सकें.

विवरण

एक डायलॉग बॉक्स (डायलॉग) एक अस्थायी पॉप-अप विंडो है जो पेज या ऐप से फोकस लेता है और लोगों को इसके साथ इंटरैक्ट करने की आवश्यकता होती है. इसका मुख्य रूप से कार्यों की पुष्टि करने के लिए उपयोग किया जाता है, जैसे फ़ाइल को हटाना, या लोगों को चुनाव करने के लिए कहना.

यह कैनवास घटक Fluent UI संवाद नियंत्रण की शैली और व्यवहार की नकल करता है. सर्वोत्तम प्रथाओं के लिए दस्तावेज़ीकरण देखें.

क्रिएटर किट GitHub रिपॉजिटरी में घटक देखें.

विशेषता

मुख्य गुण

गुण	विवरण
Buttons	एक डेटासेट जो बटनों को परिभाषित करता है (नीचे गुण देखें)
Title	शीर्षक अनुभाग में प्रदर्शित पाठ
OverlayColor	ओवरले क्षेत्र में प्रदर्शित रंग
DialogWidth	संवाद की चौड़ाई (नियंत्रण चौड़ाई के साथ भ्रमित नहीं होना चाहिए, जिसे ऐप की चौड़ाई तक फैलाना चाहिए)
DialogHeight	संवाद की ऊंचाई (नियंत्रण ऊंचाई के साथ भ्रमित नहीं होना चाहिए, जिसे ऐप की ऊंचाई तक फैलाना चाहिए).
SubTitle	शीर्षक के नीचे प्रदर्शित पाठ

Buttons गुण

गुण	विवरण
Label	बटन पर प्रदर्शित लेबल.
ButtonType	गणना जो बटन की स्टाइल को निर्धारित करती है. Standard और Primary के बीच चुनें.

Table(
    {
        Label: "Cancel", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Standard 
    },{
        Label: "Ok", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Primary
    }
)

स्टाइल के गुण

गुण	विवरण
Theme	थीम वस्तु. इसे कॉन्फ़िगर करने का तरीका देखने के लिए, थीमिंग देखें.

फ़ॉर्मैट करने के लिए, पैनल के फ़ॉर्मैट पैनल सामग्री अनुभाग में मार्गदर्शन देखें.

इवेंट गुण

गुण	विवरण
OnCloseSelect	एक बटन का चयन करने पर निष्पादित होने वाला क्रिया एक्सप्रेशन.
OnButtonSelect	कोई एक क्रिया बटन चयनित होने पर निष्पादित होने वाला क्रिया एक्सप्रेशन.

व्यवहार

संवाद दृश्यता कॉन्फ़िगर करें

जब कोई बूलियन (सही/गलत) प्रकार का चर सही में बदलता है, तो Dialog स्वयं को नियंत्रित करें (या वह सतह जिसके भीतर स्थित है) दृश्यमान बनाएं और उस चर को संवाद की दृश्यता गुण को असाइन करें. संवाद प्रदर्शित होने के बाद, आप रीसेट गुण पर वेरिएबल को अपडेट करके संवाद को छुपा सकते हैं, जो बंद करें आइकन का चयन करने पर चालू हो जाता है.

निम्नलिखित में Power Fx ऐप में किसी अन्य घटक पर क्रिया सूत्र में संवाद खोलने का सूत्र दिखाया गया है (उदाहरण के लिए, OnSelect बटन की संपत्ति):

UpdateContext({ showHideDialog: true })

संवाद के OnCloseSelect गुण में संवाद बंद करने के लिए निम्न Power Fx सूत्र है:

UpdateContext({ showHideDialog: false })

संवाद के Visible गुण को वेरिएबल असाइन करें:

showHideDialog

बटन कॉन्फ़िगर करें कार्रवाइयाँ

संवाद के OnButtonSelect गुण में, कार्रवाई को परिभाषित करने के लिए If() या Switch() पाठ मान पर आधारित Self.SelectedButton.Label स्थिति में कार्रवाई प्रदान करें. कार्रवाई के आधार पर, कार्रवाई पूरी होने के बाद संवाद को बंद करने का भी अर्थ हो सकता है.

    If( Self.SelectedButton.Label = "Send", 
        Notify("Email Sent")
    );
    UpdateContext({ showHideDialog: false })

सीमाएँ

इस कैनवास घटक का उपयोग केवल कैनवास ऐप और कस्टम पृष्ठों में ही किया जा सकता है.