UIElement.Focusable Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Windows
Bütünleştirilmiş Kod:
PresentationCore.dll

Öğesinin odağı alıp alamayacağını gösteren bir değer alır veya ayarlar. Bu bir bağımlılık özelliğidir.

public:
 property bool Focusable { bool get(); void set(bool value); };
public bool Focusable { get; set; }
member this.Focusable : bool with get, set
Public Property Focusable As Boolean

Özellik Değeri

Boolean

Öğenin odaklanabilir olup olmadığını true; aksi takdirde false. Varsayılan değer false.

Uygulamalar

Focusable

Örnekler

Aşağıdaki örnek kod, belirli bir özel denetim için şablon içindeki öğelerden birinde Focusablefalse ayarlayan bir denetim şablonunu gösterir.

<Window.Resources>
  <Style x:Key="TextBoxNoScrollViewer" TargetType="{x:Type TextBoxBase}">
    <Setter Property="Template">
      <Setter.Value>
        <ControlTemplate TargetType="{x:Type TextBoxBase}">
          <Border 
            CornerRadius="2" 
            Background="{TemplateBinding Background}" 
            BorderThickness="{TemplateBinding BorderThickness}" 
            BorderBrush="{TemplateBinding BorderBrush}"  
          >
            <!-- 
            The control template for a TextBox or RichTextBox must
            include an element tagged as the content host.  An element is 
            tagged as the content host element when it has the special name
            PART_ContentHost.  The content host element must be a ScrollViewer,
            or an element that derives from Decorator.  
            -->
            <AdornerDecorator 
              x:Name="PART_ContentHost"
              Focusable="False" 
            />
          </Border>
        </ControlTemplate>
      </Setter.Value>
    </Setter>
  </Style>
</Window.Resources>

Açıklamalar

Yalnızca odaklanmış öğe klavye girişi alır.

Focusable, gerçekte bir bağımlılık özelliği için Microsoft .NET özellik erişimcisidir. Bu belirli bağımlılık özelliği, özellikle denetimlerde türetilmiş öğe sınıflarında belirgin "varsayılan" değeri farklı ayarlanmıştır. Bu genellikle iki yoldan biriyle gerçekleşir:

  • Bağımlılık özelliği belirli bir türetilmiş sınıf tarafından devralınır, ancak bu türetilmiş sınıf bağımlılık özelliğinin meta verilerini geçersiz kılar ve özellik varsayılan değerini değiştirir.

  • Bağımlılık özelliği değerini farklı şekilde ayarlayan bir öğeye stil veya şablon uygulanır.

Örneğin, bir Button denetimi için Focusable görünen "varsayılan" değeri, ButtonFocusable doğrudan UIElement'den ortak dil çalışma zamanı (CLR) özelliği olarak devralsa bile trueolur. Bunun nedeni, Focusable bağımlılık özelliği için uygulanan meta veri değerinin, sınıf hiyerarşisindeki Button ile UIElement arasında yer alan Control temel sınıfının statik oluşturucusunda geçersiz kılınmış olmasıdır.

Control veya türetilmiş sınıfları tarafından devralındığında, Control bu özelliğin varsayılan değerini trueolacak şekilde yeniden tanımlar.

Label (Control türetilmiş bir sınıf) tarafından devralındığında, varsayılan değer falseolacak şekilde yeniden tanımlanır.

Bağımlılık Özelliği Bilgileri
Tanımlayıcı alanı FocusableProperty
meta veri özellikleri true olarak ayarlandı Hiç kimse

Devralanlara Notlar

doğrudan UIElement türetilirken (Control'den farklı olarak), öğenizin odaklanabilir olmasını isteyip istemediğinizi düşünün, çünkü varsayılan olarak öğe odaklanılabilir olmayacaktır. Öğenizin odaklanabilir olmasını istiyorsanız, türünüzün statik oluşturucusunun içindeki bu özelliğin meta verilerini aşağıdaki gibi geçersiz kılın:

FocusableProperty.OverrideMetadata(typeof(myElement), new UIPropertyMetadata(true));

FocusableProperty.OverrideMetadata(GetType(myElement), New UIPropertyMetadata(True))

burada myElement, meta veri değerini geçersiz kıldığınız türün sınıf adı olmalıdır.

Şunlara uygulanır

Ayrıca bkz.