Ghost1372

everything can be handy

Window

HC’s extension of wpf native Window.

1
2
[TemplatePart(Name = ElementNonClientArea, Type = typeof(UIElement))]
public class Window : System.Windows.Window

Attributes

Property Description Default Value Remarks
CloseButtonBackground Close button background color
CloseButtonForeground Close button foreground color
CloseButtonHoverBackground Close button mouse hover background color
CloseButtonHoverForeground Close button mouse hover foreground color
OtherButtonBackground Other Button Background Color
OtherButtonForeground Foreground color of other buttons
OtherButtonHoverBackground Other button mouse hover background color
OtherButtonHoverForeground Other button mouse hover foreground color
NonClientAreaContent NonClientAreaContent
NonClientAreaBackground NonClientAreaBackground NonClientAreaBackground
NonClientAreaForeground Foreground color of non-client area
NonClientAreaHeight NonClientAreaHeight
ShowNonClientArea Whether to display non-client area true
ShowTitle Whether to show the window title true
IsFullScreen Whether the window is in full screen false
SystemBackdropType Apply Mica Material for window false Only Available in Custom Version
ShowCloseButton Show or Hide Close Button true Only Available in Custom Version
ShowMaxButton Show or Hide Max Button true Only Available in Custom Version
ShowMinButton Show or Hide Min Button true Only Available in Custom Version

Case

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<hc:Window x:Class="HandyControlDemo.Window.CommonWindow"
           xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
           xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
           xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
           xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
           xmlns:hc="https://handyorg.github.io/handycontrol"
           mc:Ignorable="d"
           Background="{DynamicResource MainContentBackgroundBrush}"
           WindowStartupLocation="CenterScreen"
           Title="Title" 
           Height="450" 
           Width="800" 
           Icon="/HandyControlDemo;component/Resources/Img/icon.ico">
    <Border Background="{DynamicResource MainContentForegroundDrawingBrush}"/>
</hc:Window>

Window

Mica Material

Mica is an opaque, dynamic material that incorporates theme and desktop wallpaper to paint the background of long-lived windows such as apps and settings. Mica is specifically designed for app performance as it only samples the desktop wallpaper once to create its visualization.

Mica can only be used on Windows 11 and above

1
2
3
4
5
6
7
8
<hc:Window x:Class="HandyControlDemo.MainWindow"
           xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
           xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
           xmlns:hc="https://handyorg.github.io/handycontrol"
           xmlns:local="clr-namespace:WpfApp4"
           SystemBackdropType="Mica">
    <Grid />
</hc:Window>

For synchronization with the Windows theme, set the UsingSystemTheme="True" property in the app.xaml file

1
2
3
4
5
6
<ResourceDictionary>
    <ResourceDictionary.MergedDictionaries>
        <hc:ThemeResources UsingSystemTheme="True" />
        <hc:Theme />
    </ResourceDictionary.MergedDictionaries>
</ResourceDictionary>

In XAML if you set a background brush for the window and the line is AFTER SystemBackdropType=”Mica”, in Windows 11 the Mica effect is applied to the Window but immediately overridden by the background brush, Mica effect goes away.

Some XAML formatter extensions will sort the properties alphabetically. SystemBackdropType is then before Background and the “bug” above occurs.

Mica

Attached Properties

you can use WindowAttach Attached Property for dragging window or any control.

IsDragElement

1
2
3
 <hc:Window WindowAttach:IsDragElement="True" 
...
/>

SystemBackdropType

you can use SystemBackdropType Attached Property for Activating Mica for any window (System.Window.Window or HandyControl.Controls.Window). 

1
2
3
4
5
6
7
8
<hc:Window x:Class="HandyControlDemo.MainWindow"
           xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
           xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
           xmlns:hc="https://handyorg.github.io/handycontrol"
           xmlns:local="clr-namespace:WpfApp4"
           hc:WindowAttach.SystemBackdropType="Mica">
    <Grid />
</hc:Window>

or

1
2
3
4
5
6
7
8
<Window x:Class="HandyControlDemo.MainWindow"
           xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
           xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
           xmlns:hc="https://handyorg.github.io/handycontrol"
           xmlns:local="clr-namespace:WpfApp4"
           hc:WindowAttach.SystemBackdropType="Mica">
    <Grid />
<Window>

Shortcut

you should use GlobalShortcut.KeyBindings

1
2
3
4
<hc:GlobalShortcut.KeyBindings>
      <KeyBinding Modifiers="Control+Alt" Key="E" Command="{Binding GlobalShortcutErrorCmd}"/>
      <KeyBinding Modifiers="Control+Alt" Key="I" Command="{Binding Main.GlobalShortcutInfoCmd, Source={StaticResource Locator}}"/>
  </hc:GlobalShortcut.KeyBindings>

Menu

If you want to use menus in the title bar, you should use NonClientAreaContent property

1
2
3
4
5
6
7
8
9
10
11
<hc:Window.NonClientAreaContent>
  <StackPanel VerticalAlignment="Stretch" Orientation="Horizontal">
        <Button Content="About" Style="{StaticResource ButtonCustom}"/>
        <Button Content="Help" Style="{StaticResource ButtonCustom}"/>
        <Menu>
            <MenuItem Header="Repository">
                <MenuItem Header="GitHub"/>
            </MenuItem>
        </Menu>
   </StackPanel>
</hc:Window.NonClientAreaContent>

NonClientAreaContent

If you want to put objects, you should use it in this way

1
2
3
<hc:Window.NonClientAreaContent>
  <!-- Put your objects here -->
</hc:Window.NonClientAreaContent>
0%