ContextMenu नियंत्रण
कमांड्स इनपुट करने के लिए उपयोग किया जाने वाला नियंत्रण.
नोट
पूर्ण दस्तावेज़ीकरण और स्रोत कोड GitHub कोड घटक रिपॉजिटरी में मिला.
विवरण
एक प्रासंगिक मेनू (ContextMenu
) कमांड की एक सूची है जो चयन, माउस होवर या कीबोर्ड फोकस के संदर्भ पर आधारित है. वे सबसे प्रभावी और अत्यधिक उपयोग की जाने वाली कमांड सतहों में से एक हैं, और विभिन्न स्थानों पर इसका उपयोग किया जा सकता है.
यह कोड घटक कैनवास ऐप और कस्टम पृष्ठों में उपयोग के लिए Fluent UI ContextualMenu घटक के चारों ओर एक आवरण प्रदान करता है जो एक बटन से जुड़ा होता है.
विशेषता
मुख्य गुण
गुण | विवरण |
---|---|
Items |
रेंडर करने के लिए क्रिया आइटम. पहली वस्तु को मूल वस्तु माना जाता है. |
Items
गुण
Name | विवरण |
---|---|
ItemDisplayName |
मेनू आइटम का डिस्प्ले नाम. |
ItemKey |
यह इंगित करने के लिए उपयोग की जाने वाली कुंजी कि कौन सा आइटम चुना गया है, और उप आइटम जोड़ते समय. कुंजियाँ अद्वितीय होनी चाहिए. |
ItemEnabled |
विकल्प अक्षम होने पर गलत पर सेट करें. |
ItemVisible |
यदि विकल्प दिखाई नहीं दे रहा है तो असत्य पर सेट करें. |
ItemChecked |
विकल्प चेक होने पर सही पर सेट करें. |
ItemIconName |
उपयोग करने के लिए Fluent UI आइकन (Fluent UI आइकन देखें) |
ItemIconColor |
आइकन को प्रस्तुत करने के लिए रंग (जैसे नाम, आरजीबी या हेक्स मान). |
ItemIconOnly |
टेक्स्ट लेबल न दिखाएं - केवल आइकन. |
ItemHeader |
आइटम को सेक्शन हेडर के रूप में रेंडर करें. यदि ऐसे आइटम हैं जिनके पास ItemParentKey इस आइटम की कुंजी पर सेट है, तो उन्हें इस खंड के तहत शब्दार्थ समूहीकृत आइटम के रूप में जोड़ा जाता है. |
ItemTopDivider |
खंड के शीर्ष पर एक विभाजक प्रस्तुत करें. |
ItemDivider |
आइटम को सेक्शन डिवाइडर के रूप में रेंडर करें - या अगर आइटम हेडर है (ItemHeader = ट्रू), तो नियंत्रित करता है कि सेक्शन के निचले हिस्से में डिवाइडर रेंडर करना है या नहीं. |
ItemParentKey |
विकल्प को दूसरे विकल्प के चाइल्ड आइटम के रूप में रेंडर करें. |
नोट
ItemIconColor
घटक के थीम मान को ओवरराइड करेगा और अन्य स्थिति रंगों (जैसे, अक्षम) को अनदेखा करेगा।ItemHeader
औरItemDivider
को विभाजक के रूप में प्रस्तुत करने के लिए सत्य पर सेट किया जाना चाहिए। यदि गलत पर सेट किया जाता है, तो यह अन्य मानों की अपेक्षा करता है और खाली हो जाएगा.- सबमेनू आइटमों का
ItemChecked
गुण और व्यवहार जोड़ने से सबमेनू को क्लिक करने पर बंद होने से रोका जा सकेगा।
उदाहरण
Items
के लिए उदाहरण Power Fx फ़ॉर्मूला:
Table(
{
ItemKey: "File",
ItemIconName: "save",
ItemDisplayName: "Save",
ItemOverflow:true
},
{
ItemKey: "Delete",
ItemIconName: "Delete",
ItemDisplayName: "Delete",
ItemOverflow:true
}
)
स्टाइल के गुण
गुण | विवरण |
---|---|
Theme |
Fluent UI थीम डिज़ाइनर (windows.net) का उपयोग करके उत्पन्न JSON स्ट्रिंग को स्वीकार करता है. इसे खाली छोड़ने से Power Apps द्वारा परिभाषित डिफ़ॉल्ट थीम का उपयोग किया जाएगा. इसे खाली छोड़ने से Power Apps द्वारा परिभाषित डिफ़ॉल्ट थीम का उपयोग किया जाएगा. इसे कॉन्फ़िगर करने का तरीका देखने के लिए, थीमिंग देखें. |
Chevron |
रूट बटन पर डाउन शेवरॉन दिखाएं या छुपाएं |
IconColor |
ऑप्शनल. संदर्भ मेनू बटन पर आइकन का रंग. |
HoverIconColor |
ऑप्शनल. संदर्भ मेनू बटन पर होवार किए जाने पर आइकन का रंग. |
IconSize |
ऑप्शनल. पिक्सेल में, संदर्भ मेनू बटन पर आइकन का आकार. |
FontSize |
ऑप्शनल. पिक्सेल में, संदर्भ मेनू बटन पर पाठ का आकार. |
FontColor |
ऑप्शनल. संदर्भ मेनू बटन पर पाठ का रंग. |
HoverFontColor |
ऑप्शनल. संदर्भ मेनू बटन पर होवर किए जाने पर पाठ का रंग. |
FillColor |
ऑप्शनल. संदर्भ मेनू बटन का पृष्ठभूमि का रंग. |
HoverFillColor |
ऑप्शनल. संदर्भ मेनू बटन पर होवर किए जाने पर पृष्ठभूमि का रंग. |
TextAlignment |
बटन के पाठ का पाठ संरेखण. संभावित मान: केंद्र, बाएँ या दाएँ |
AccessibilityLabel |
स्क्रीन पढ़ने वालों का आरिया-लेबल |
इवेंट गुण
गुण | विवरण |
---|---|
InputEvent |
नियंत्रण को भेजने के लिए एक इवेंट. उदा. SetFocus . नीचे देखें. |
व्यवहार
SetFocus के रूप में InputEvent
का समर्थन करता है.
'ऑन सेलेक्ट' व्यवहार को कॉन्फ़िगर करें
नियंत्रण के चयनित ItemKey
को स्विच मान के रूप में संदर्भित करके प्रत्येक आइटम के लिए विशिष्ट क्रियाओं को कॉन्फ़िगर करने के लिए घटक के OnSelect
गुण में स्विच() सूत्र का उपयोग करें.
false
मानों को Power Fx भाषा में उपयुक्त भावों से बदलें.
Switch( Self.Selected.ItemKey,
/* Action for ItemKey 1 */
"File", false,
/* Action for ItemKey 2 */
"Delete", false,
/* Default action */
false
)
नियंत्रण पर फ़ोकस सेट करना
जब एक नया संवाद दिखाया जाता है, और डिफ़ॉल्ट फ़ोकस नियंत्रण पर होना चाहिए, तो एक स्पष्ट सेट फ़ोकस की आवश्यकता होगी.
इनपुट इवेंट में कॉल करने के लिए, आप एक संदर्भ वेरिएबल सेट कर सकते हैं जो इनपुट इवेंट गुण से एक स्ट्रिंग के लिए बाध्य है जो SetFocus
से शुरू होता है और इसके बाद एक यादृच्छिक तत्व होता है ताकि यह सुनिश्चित हो सके कि ऐप इसे परिवर्तन के रूप में पहचानता है.
उदाहरण
UpdateContext({ctxResizableTextareaEvent:"SetFocus" & Text(Rand())}));
संदर्भ चर ctxResizableTextareaEvent
फिर संपत्ति Input Event
संपत्ति के लिए बाध्य होगा.
सीमाएँ
इस कोड घटक का उपयोग केवल कैनवास ऐप और कस्टम पृष्ठों में ही किया जा सकता है.