WPF アプリケーションへのグラス フレームの拡張
更新 : 2007 年 11 月
ここでは、Windows Vista のグラス フレームを Windows Presentation Foundation (WPF) アプリケーションのクライアント領域に拡張する方法について説明します。
メモ : |
---|
この例は、グラス対応の Desktop Window Manager (DWM) を実行している Windows Vista コンピュータでのみ機能します。Windows Vista Home Basic は、透明なグラス効果をサポートしていません。その他の Windows Vista で通常は透明なグラス効果でレンダリングされる領域は、不透明にレンダリングされます。 |
使用例
Internet Explorer 7 のアドレス バーに拡張されたグラス フレームを次の図に示します。
アドレス バーの背後にグラス フレームが拡張された Internet Explorer
グラス フレームを WPF アプリケーションで拡張するには、アンマネージ API へのアクセスが必要です。フレームをクライアント領域に拡張するために必要な 2 つの API に対してプラットフォーム呼び出し (pinvoke) を実行する方法を次のコード例に示します。これらの API は、それぞれ NonClientRegionAPI と呼ばれるクラスで宣言されます。
[StructLayout(LayoutKind.Sequential)]
public struct MARGINS
{
public int cxLeftWidth; // width of left border that retains its size
public int cxRightWidth; // width of right border that retains its size
public int cyTopHeight; // height of top border that retains its size
public int cyBottomHeight; // height of bottom border that retains its size
};
[DllImport("DwmApi.dll")]
public static extern int DwmExtendFrameIntoClientArea(
IntPtr hwnd,
ref MARGINS pMarInset);
DwmExtendFrameIntoClientArea は、フレームをクライアント領域に拡張する DWM 関数です。この関数では、ウィンドウ ハンドルと MARGINS 構造体という、2 つのパラメータを使用します。MARGINS は、フレームをクライアント領域に拡張する追加量を DWM に指示するために使用されます。
DwmExtendFrameIntoClientArea 関数を使用するには、ウィンドウ ハンドルを取得する必要があります。WPF では、ウィンドウ ハンドルは HwndSource の Handle プロパティから取得できます。次の例では、ウィンドウの Loaded イベントでフレームがクライアント領域に拡張されます。
void OnLoaded(object sender, RoutedEventArgs e)
{
try
{
// Obtain the window handle for WPF application
IntPtr mainWindowPtr = new WindowInteropHelper(this).Handle;
HwndSource mainWindowSrc = HwndSource.FromHwnd(mainWindowPtr);
mainWindowSrc.CompositionTarget.BackgroundColor = Color.FromArgb(0, 0, 0, 0);
// Get System Dpi
System.Drawing.Graphics desktop = System.Drawing.Graphics.FromHwnd(mainWindowPtr);
float DesktopDpiX = desktop.DpiX;
float DesktopDpiY = desktop.DpiY;
// Set Margins
NonClientRegionAPI.MARGINS margins = new NonClientRegionAPI.MARGINS();
// Extend glass frame into client area
// Note that the default desktop Dpi is 96dpi. The margins are
// adjusted for the system Dpi.
margins.cxLeftWidth = Convert.ToInt32(5 * (DesktopDpiX / 96));
margins.cxRightWidth = Convert.ToInt32(5 * (DesktopDpiX / 96));
margins.cyTopHeight = Convert.ToInt32(((int)topBar.ActualHeight + 5) * (DesktopDpiX / 96));
margins.cyBottomHeight = Convert.ToInt32(5 * (DesktopDpiX / 96));
int hr = NonClientRegionAPI.DwmExtendFrameIntoClientArea(mainWindowSrc.Handle, ref margins);
//
if (hr < 0)
{
//DwmExtendFrameIntoClientArea Failed
}
}
// If not Vista, paint background white.
catch (DllNotFoundException)
{
Application.Current.MainWindow.Background = Brushes.White;
}
}
フレームがクライアント領域に拡張される簡単なウィンドウを次の例に示します。フレームは、2 つの TextBox オブジェクトを含む一番上の境界の背後に拡張されます。
<Window x:Class="SDKSample.Window1"
xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
Title="Extended Glass in WPF" Height="300" Width="400"
Loaded="OnLoaded" Background="Transparent"
>
<Grid ShowGridLines="True">
<DockPanel Name="mainDock">
<!-- The border is used to compute the rendered height with margins.
topBar contents will be displayed on the extended glass frame.-->
<Border Name="topBar" DockPanel.Dock="Top" >
<Grid Name="grid">
<Grid.ColumnDefinitions>
<ColumnDefinition MinWidth="100" Width="*"/>
<ColumnDefinition Width="Auto"/>
</Grid.ColumnDefinitions>
<TextBox Grid.Column="0" MinWidth="100" Margin="0,0,10,5">Path</TextBox>
<TextBox Grid.Column="1" MinWidth="75" Margin="0,0,0,5">Search</TextBox>
</Grid>
</Border>
<Grid DockPanel.Dock="Top" >
<Grid.ColumnDefinitions>
<ColumnDefinition/>
</Grid.ColumnDefinitions>
<TextBox Grid.Column="0" AcceptsReturn="True"/>
</Grid>
</DockPanel>
</Grid>
</Window>
WPF アプリケーションに拡張されたグラス フレームを次の図に示します。
■訳文不要■WPF アプリケーションの拡張されたグラス フレーム
参照
参照
Desktop Window Manager Overview