نظرة عامة على الإطار المنبثق

Popup عنصر تحكم يوفر طريقة لعرض المحتويات في إطار منفصل تنتقل عبر إطار التطبيق الحالي النسبي المعينة للعنصر أو شاشة إحداثي. يقدم هذا الموضوع على Popup السيطره وتوفر معلومات حول استخدام الخاص به.

يشتمل هذا الموضوع على الأقسام التالية.

  • ما هو العنصر المنبثق؟
  • إنشاء منبثق
  • عناصر التحكم التي تنفذ على منبثق
  • قائمة منبثقة ومظهره
  • تعريف موضع المنبثق
  • شجرة Visual "و" منبثقة
  • موضوعات ذات صلة

ما هو العنصر المنبثق؟

Popup يعرض عنصر التحكم المحتوى في نسبة إطار منفصل للعنصر أو نقطة على الشاشة. عندما تكون خاصية Popup IsOpen ، على الرغم من ذلك، يتم تعيين true إلى :

ملاحظةملاحظة

Popup يقوم تلقائياً بالفتح عندما يتحرك مؤشر الماوس فوق الكائن الأصل.إذا كنت تريد Popup إلى فتحه تلقائياً ، استخدم ToolTip أو ToolTipServiceclass.لمزيد من المعلومات، راجع نظرة عامة على ToolTip.

إنشاء منبثق

يظهر المثال التالي عنصر تحكم Popup التابع لعنصر التحكم Button . لأن Button يمكن أن يكون تابع واحد فقط ، يضع هذا المثال النص Button و Popup يتحكم في StackPanel. المحتوى Popup يظهر في TextBlock التحكم ، الذي يعرض به النص في إطار منفصل تنتقل عبر إطار التطبيق بالقرب ذات الصلة Button التحكم.

<Button HorizontalAlignment="Left" Click="DisplayPopup" 
        Width="150" Margin="20,10,0,0">
  <StackPanel>
    <TextBlock>Display Your Popup Text</TextBlock>
    <Popup Name="myPopup">
      <TextBlock Name="myPopupText" 
                 Background="LightBlue" 
                 Foreground="Blue">
        Popup Text
      </TextBlock>
    </Popup>
  </StackPanel>
</Button>
<Button Name="ButtonForPopup" HorizontalAlignment="Left" 
        Click="CreatePopup"  
        Width="150" Margin="20,10,0,0">
  <StackPanel Name="aStackPanel">
    <TextBlock>Create Popup</TextBlock>
  </StackPanel>
</Button>

عناصر التحكم التي تنفذ على منبثق

يمكنك إنشاء Popup عناصر التحكم في عناصر التحكم الأخرى. تطبيق عناصر التحكم التالية Popup التحكم لاستخدامات معينة:

قائمة منبثقة ومظهره

Popup تحكم يوفر وظائف من تخصيص سلوك والارتباطات تظهر. على سبيل المثال، يمكنك تعيين فتح و غلق سلوك الحركة ، اللاشفافية تأثيرات الصورة النقطية و Popup وحجم الموضع.

فتح وإغلاق سلوك

Popup يعرض عنصر التحكم المحتوى عند IsOpen خاصيه تعيين إلى true. افتراضياً، Popup يظل مفتوحاً حتى IsOpen خاصيه تعيين إلى false. ومع ذلك، يمكنك تغيير السلوك الافتراضي بواسطة تعيين StaysOpen خاصيه إلى false. عند تعيين هذه الخاصيه إلى false ، تظهر Popup يحتوي إطار المحتوى التقاط الماوس. Popup يفقد التقاط الماوس و إغلاق النوافذ عند حدوث حدث خارج ماوس Popup نافذه.

Opened و Closed الأحداث التي يتم تشغيل الحدث عند Popup نافذه المحتوى كان مفتوحاً أو مغلقاً.

الرسومات المتحركة

Popupعنصر تحكم على دعم مضمن للحركات التي تقترن عادة بالسلوكيات مثل تضاؤل-في والشرائح-بوصة يمكنك تشغيل هذه الحركات بواسطة تعيين PopupAnimationخاصية إلى PopupAnimationالقيمة التعداد. لعمل رسوم متحركة Popup بشكل صحيح, يجب على المثال تعيين خاصية AllowsTransparency إلى true .

يمكنك أيضاً تطبيق الحركات مثل Storyboard ل Popup عنصر التحكم.

اللاشفافية وتأثيرات الصور النقطيه

Opacity خاصيه للحصول Popup عنصر التحكم له أي تأثير على المحتوى الخاص به. بشكل افتراضى ، Popup هو إطار محتوى كامد. لإنشاء شفاف Popup ، المعينة AllowsTransparency خاصيه إلى true.

المحتوى Popup لا ترث تأثيرات الصورة النقطية مثل DropShadowBitmapEffect ، مباشرة تعيين على Popup التحكم أو على أي عنصر آخر في الإطار الأصل. تأثيرات الصورة النقطية التى تظهر على المحتوى Popup ، يجب عليك تعيين تأثير صورة نقطية مباشرة على المحتوى الخاص به. على سبيل المثال، إذا التابعة Popup هو StackPanel ، تعيين تأثير الصورة النقطية على StackPanel.

حجم قائمة منبثقة

افتراضياً، Popup محدداً تلقائياً إلى به محتوى. عند حدوث تغيير الحجم التلقائي قد تكون بعض تأثيرات الصورة النقطية مخفيه لأن حجم الافتراضي ناحية الشاشة الذي تم تعريفه من أجل Popup المحتوى لا توفر مساحة كافية تأثيرات الصورة النقطية إلى العرض.

Popup المحتوى يمكن أيضاً أن يتم حجب عند تعيينRenderTransform على المحتوى . في هذا السيناريو، قد يكون مخفياً بعض المحتوى إذا كان المحتوى Popup تمتد خارج ناحية الأصلي محولة Popup. إذا كان تأثير صورة نقطية أو التحويل يتطلب مساحة إضافية, يمكنك تعريف حول Popup المحتوى لتوفير المزيد من المنطقة التي تتحكم .

تعريف موضع المنبثق

يمكنك وضع منبثقة بواسطة إعداد في PlacementTarget ، PlacementRectangle ، Placement ، HorizontalOffset ، و VerticalOffsetProperty خصائص. لمزيد من المعلومات، راجع سلوك وضع المنبثق. عند Popup يتم عرضه على الشاشة، فإنه غير موضع نفسه إذا كان يتم تغيير موضع موقعه الأصل.

تخصيص موضع العنصر المنبثق

يمكنك تخصيص الموضع Popup عنصر التحكم بواسطة تحديد مجموعة الإحداثيات التي تكون نسبة إلى PlacementTarget حيث تريد Popup ظهور.

لتخصيص موضع تعيين Placement الخاصية إلى Custom. قم بتعريف المفوض CustomPopupPlacementCallback الذى يقوم بإرجاع مجموعة من نقاط الموضع المحتملة ومحور الأساس (بترتيب التفضيل) لل Popup. نقطة يُظهر جزء أكبر من Popup يتم تحديده تلقائياً. على سبيل المثال ، راجع كيفية القيام بما يلي: تحديد موضع مخصص للمنبثق.

شجرة Visual "و" منبثقة

Popup لا يحتوي عنصر التحكم الخاص به شجرة المرئية ; بدلاً من إرجاع حجم 0 (صفر) عند MeasureOverride أسلوب Popup يسمى. ومع ذلك، عند تعيين IsOpen خاصية Popup إلى true ، إطار جديد مع إنشاء شجرة المرئية الخاصة به. اطار جديد يحتوي على Child محتوى Popup. عرض وارتفاع من اطار الجديد لا يمكن أن تكون أكبر من ٧٥ في المائة عرض أو ارتفاع الشاشة.

Popup يحتفظ عنصر التحكم مرجع به Child المحتوى كـ التابعة المنطقية. عند إنشاء إطار جديد المحتوى Popup تصبح تابعة مرئية من الإطار تابع المنطقية وتبقى Popup. وعلى العكس، Popup يبقى أصل المنطقي الخاص به Child المحتوى.

راجع أيضًا:

المرجع

Popup

PopupPrimaryAxis

PlacementMode

CustomPopupPlacement

CustomPopupPlacementCallback

ToolTip

ToolTipService

موارد أخرى

المواضيع الإجرائية للمنبثق

مواضيع الإجرائية لتعريف الأدوات