UIElement.UseSystemFocusVisuals Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml

Ruft einen Wert ab, der angibt, ob das Steuerelement visuelle Fokusvisuals verwendet, die vom System gezeichnet wurden, oder Fokusvisuals, die in der Steuerelementvorlage definiert sind, oder legt diesen fest.

public:
 property bool UseSystemFocusVisuals { bool get(); void set(bool value); };

bool UseSystemFocusVisuals();

void UseSystemFocusVisuals(bool value);

public bool UseSystemFocusVisuals { get; set; }

var boolean = uIElement.useSystemFocusVisuals;
uIElement.useSystemFocusVisuals = boolean;

Public Property UseSystemFocusVisuals As Boolean

Eigenschaftswert

Boolean

bool

True, wenn das Steuerelement visuelle Fokuselemente verwendet, die vom System gezeichnet wurden. False, wenn das Steuerelement visuelle Fokuselemente verwendet, die in controlTemplate definiert sind.

Der Standardwert ist false (siehe Hinweise).

Beispiele

Dieses Beispiel zeigt eine ControlTemplate , die benutzerdefinierte Fokusvisuals für eine Schaltfläche definiert.

Einige Elemente der Steuerelementvorlage werden nicht angezeigt, um die relevanten Teile übersichtlicher zu machen. Weitere Informationen finden Sie unter XAML-Formatvorlagen.

<Style TargetType="Button">

<!-- Set UseSystemFocusVisuals to false. -->
    <Setter Property="UseSystemFocusVisuals" Value="False"/> 
     ...

    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="Button">
                <Grid>
                    <VisualStateManager.VisualStateGroups>
                        <VisualStateGroup x:Name="CommonStates">
                            <VisualState x:Name="Normal"/>
                            <VisualState x:Name="PointerOver">
                             ...

                            </VisualState>
                        </VisualStateGroup>

<!-- Add VisualStateGroup for FocusStates. -->
                        <VisualStateGroup x:Name="FocusStates">
                            <VisualState x:Name="Focused">
                                <Storyboard>
                                    <DoubleAnimation Storyboard.TargetName="FocusVisualWhite"
                                                     Storyboard.TargetProperty="Opacity"
                                                     To="1"
                                                     Duration="0"/>
                                    <DoubleAnimation Storyboard.TargetName="FocusVisualBlack"
                                                     Storyboard.TargetProperty="Opacity"
                                                     To="1"
                                                     Duration="0"/>
                                </Storyboard>
                            </VisualState>
                            <VisualState x:Name="Unfocused"/>
                            <VisualState x:Name="PointerFocused"/>
                        </VisualStateGroup>

                    </VisualStateManager.VisualStateGroups>
                    <Border x:Name="Border"
                            Background="{TemplateBinding Background}"
                            BorderBrush="{TemplateBinding BorderBrush}"
                            BorderThickness="{TemplateBinding BorderThickness}"
                            Margin="3">
                        <ContentPresenter x:Name="ContentPresenter"
                                          Content="{TemplateBinding Content}"
                                          ContentTransitions="{TemplateBinding ContentTransitions}"
                                          ContentTemplate="{TemplateBinding ContentTemplate}"
                                          Margin="{TemplateBinding Padding}"
                                          HorizontalAlignment="{TemplateBinding HorizontalContentAlignment}"
                                          VerticalAlignment="{TemplateBinding VerticalContentAlignment}" 
                                          AutomationProperties.AccessibilityView="Raw"/>
                    </Border>

<!-- Add elements for focus visuals. -->
                    <Rectangle x:Name="FocusVisualWhite"
                               IsHitTestVisible="False"
                               Stroke="{ThemeResource FocusVisualWhiteStrokeThemeBrush}"
                               StrokeEndLineCap="Square"
                               StrokeDashArray="1,1"
                               Opacity="0"
                               StrokeDashOffset="1.5"/>
                    <Rectangle x:Name="FocusVisualBlack"
                               IsHitTestVisible="False"
                               Stroke="{ThemeResource FocusVisualBlackStrokeThemeBrush}"
                               StrokeEndLineCap="Square"
                               StrokeDashArray="1,1"
                               Opacity="0"
                               StrokeDashOffset="0.5"/>
                </Grid>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

Hinweise

Diese Eigenschaft ist standardmäßig false, sodass eine benutzerdefinierte ControlTemplate , die ihre eigenen Fokusvisuals definiert, wie erwartet funktioniert. Alle XAML-Framework-Steuerelemente legen diese Eigenschaft jedoch in ihren ControlTemplate visuals auf true fest und verwenden visuals vom System gezeichneten Fokus.

Um benutzerdefinierte Fokusvisuals für ein Steuerelement zu definieren, müssen Sie eine benutzerdefinierte ControlTemplate bereitstellen. Gehen Sie in ControlTemplatewie folgt vor:

• Wenn Sie eine Standardmäßige ControlTemplate ändern, stellen Sie sicher, dass Sie die UseSystemFocusVisuals-Eigenschaft auf false festlegen, um die Visuellen Elemente des Systemfokus zu deaktivieren. Wenn diese Einstellung auf false festgelegt ist, werden die Fokuszustände im VisualStateManager aufgerufen.
• Definieren Sie eine VisualStateGroup für FocusStates.
• Definieren Sie in der FocusStates Gruppe einen VisualState-Wert für jede von Focused, Unfocusedund PointerFocused.
• Definieren Sie die Fokusvisuals.