Dreamine.UI.Wpf.Controls.ViewRegion.PopupWindowManager 클래스 참조

더 자세히 ...

Public 멤버 함수
void	SetPopupSize (string name, double width, double height)
void	CreatePopup (string name, LoadedViewInfo loadedViewInfo, double? popupWidth=null, double? popupHeight=null, bool centerOnScreen=false)
void	Clear ()
void	Show (string name)
void	HideAllExcept (string name)
void	CloseAll ()

속성
double	Width = 800 [get, set]
double	Height = 600 [get, set]
static PopupWindowManager	Instance = new() [get]
IReadOnlyDictionary< string, Window >	Windows [get]

정적 Private 멤버 함수
static void	SetPopupPosition (Window popup, Window? owner)

Private 속성
readonly Dictionary< string, Window >	_popupWindows = new()

상세한 설명

View와 ViewModel을 별도 테두리 없는 최상위 Window로 감싸 등록·표시·숨김 처리합니다.

PopupWindowManager.cs 파일의 18 번째 라인에서 정의되었습니다.

멤버 함수 문서화

Clear()

void Dreamine.UI.Wpf.Controls.ViewRegion.PopupWindowManager.Clear ( )

inline

현재 표시 중인 등록 팝업을 닫고 내부 목록을 비웁니다.

PopupWindowManager.cs 파일의 427 번째 라인에서 정의되었습니다.

        {
            foreach (var popup in _popupWindows.Values)
            {
                if (popup.IsVisible)
                    popup.Close();
            }
 
            _popupWindows.Clear();
        }

다음을 참조함 : _popupWindows.

CloseAll()

void Dreamine.UI.Wpf.Controls.ViewRegion.PopupWindowManager.CloseAll ( )

inline

등록된 모든 팝업 창을 닫고 내부 사전에서 제거합니다.

PopupWindowManager.cs 파일의 514 번째 라인에서 정의되었습니다.

        {
            foreach (var popup in _popupWindows.Values)
                popup.Close();
 
            _popupWindows.Clear();
        }

다음을 참조함 : _popupWindows.

CreatePopup()

void Dreamine.UI.Wpf.Controls.ViewRegion.PopupWindowManager.CreatePopup ( string name, LoadedViewInfo loadedViewInfo, double? popupWidth = null, double? popupHeight = null, bool centerOnScreen = false )

inline

로드된 View 정보를 독립 팝업 창으로 만들고 수명 주기와 위치 처리기를 연결한 뒤 등록합니다.

매개변수

name	팝업의 고유 등록 이름입니다.
loadedViewInfo	표시할 View 정보를 포함한 값입니다.
popupWidth	선택적 너비이며 생략하면 Width입니다.
popupHeight	선택적 높이이며 생략하면 Height입니다.
centerOnScreen	소유자 대신 화면 중앙에 배치하려면 true입니다.

예외

InvalidOperationException	표시 가능한 View가 없거나 창 상태가 팝업 표시를 허용하지 않으면 발생할 수 있습니다.
NullReferenceException	현재 WPF 애플리케이션이 없으면 Dispatcher 접근 중 발생할 수 있습니다.
ArgumentNullException	name 이 null인 상태에서 등록하면 발생합니다.

PopupWindowManager.cs 파일의 195 번째 라인에서 정의되었습니다.

        {
            FrameworkElement view = loadedViewInfo.View
                ?? loadedViewInfo.FrameworkView
                ?? throw new InvalidOperationException($"Popup view '{name}' could not be created.");
 
            object? viewModel = view.DataContext;
 
            if (!Application.Current.Dispatcher.CheckAccess())
            {
                Application.Current.Dispatcher.Invoke(() => CreatePopup(name, loadedViewInfo, popupWidth, popupHeight, centerOnScreen));
                return;
            }
 
            var owner = Application.Current?.MainWindow;
 
            Window popup;
 
            view.Measure(new Size(double.PositiveInfinity, double.PositiveInfinity));
            var desired = view.DesiredSize;
 
            if (loadedViewInfo.View == null)
            {
                popup = new Window
                {
                    Title = "",
                    Content = view,
                    DataContext = viewModel,
                    WindowStartupLocation = WindowStartupLocation.CenterScreen,
                    WindowStyle = WindowStyle.None,
                    ResizeMode = ResizeMode.NoResize,
                    Background = Brushes.White,
                    Width = desired.Width,
                    Height = desired.Height,
                    ShowInTaskbar = false,
                    Topmost = true,
                };
            }
            else
            {
                popup = new Window
                {
                    Title = "",
                    Content = view,
                    DataContext = viewModel,
                    WindowStartupLocation = WindowStartupLocation.CenterOwner,
                    WindowStyle = WindowStyle.None,
                    ResizeMode = ResizeMode.NoResize,
                    // AllowsTransparency=true는 Background가 완전 불투명(White)이라 시각적으로
                    // 필요 없고, 레이어드 윈도우(WS_EX_LAYERED)로 만들어져 일부 환경(원격 데스크톱/
                    // 가상 머신/특정 GPU 드라이버)에서 마우스 입력이 전달되지 않는 문제를 유발할 수
                    // 있어 제거했다.
                    ShowActivated = true,
                    Background = Brushes.White,
                    Width = desired.Width,
                    Height = desired.Height,
                    ShowInTaskbar = false,
                    Topmost = true
                };
            }
 
            // 크기 조정
            popup.Width = popupWidth ?? Width;
            popup.Height = popupHeight ?? Height;
 
            // centerOnScreen 플래그를 Tag에 저장해 이후 핸들러에서 참조
            popup.Tag = centerOnScreen;
 
            // 최초 Owner + 위치 설정 (여기서만 Owner를 건드림)
            if (owner != null && owner.IsLoaded && owner.IsVisible)
            {
                try
                {
                    popup.Owner = owner;
                }
                catch (Exception ex)
                {
                    Debug.WriteLine($"[Popup] Owner 설정 실패({name}): {ex.Message}");
                }
 
                SetPopupPosition(popup, owner);
            }
            else
            {
                popup.WindowStartupLocation = WindowStartupLocation.CenterScreen;
            }
 
            // Owner가 나중에 보이게 되는 경우를 위한 보정
            if (owner != null && !owner.IsVisible)
            {
#pragma warning disable CS1587 // Doxygen documents local functions; the C# compiler does not attach XML docs to them.
                void OnOwnerReady(object? s, EventArgs e)
                {
                    owner!.ContentRendered -= OnOwnerReady;
 
                    if (!popup.IsVisible)
                        return;
 
                    if (!owner.IsLoaded)
                        return;
 
                    try
                    {
                        popup.Owner = owner;
                    }
                    catch (Exception ex)
                    {
                        Debug.WriteLine($"[Popup] ContentRendered Owner 설정 실패({name}): {ex.Message}");
                    }
 
                    SetPopupPosition(popup, owner);
                }
#pragma warning restore CS1587
 
                owner.ContentRendered += OnOwnerReady;
                popup.Closed += (_, _) => owner!.ContentRendered -= OnOwnerReady;
            }
 
            popup.Loaded += (s, e) => popup.Hide();
            popup.Show();
            ViewSwitcher.NotifyShown(name);
 
            // 위치만 조정 (Owner는 다시 세팅하지 않음)
            popup.IsVisibleChanged += (_, __) =>
            {
                if (!popup.IsVisible)
                    return;
 
                SetPopupPosition(popup, owner);
            };
 
            // 앱 종료 중이면 그냥 닫고, 평소엔 Hide 재사용
            popup.Closing += (s, e) =>
            {
                ViewSwitcher.NotifyHidden(name);
 
                // Owner가 이미 죽었거나, 애플리케이션이 종료 진행 중이면 그냥 닫게 둠
                var app = Application.Current;
                bool ownerDead = owner == null || !owner.IsLoaded;
                bool appShuttingDown = app is { ShutdownMode: ShutdownMode.OnExplicitShutdown } && app.MainWindow == null;
 
                if (ownerDead || appShuttingDown)
                {
                    // e.Cancel = false → 실제로 닫힘
                    return;
                }
 
                // 정상 동작 중에는 닫지 않고 숨김
                SetPopupPosition(popup, owner);
                popup.Hide();
                e.Cancel = true;
            };
 
            _popupWindows[name] = popup;
        }

다음을 참조함 : _popupWindows, CreatePopup(), Height, Dreamine.UI.Wpf.Controls.ViewRegion.ViewSwitcher.NotifyHidden(), Dreamine.UI.Wpf.Controls.ViewRegion.ViewSwitcher.NotifyShown(), SetPopupPosition(), Width.

다음에 의해서 참조됨 : CreatePopup().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

HideAllExcept()

void Dreamine.UI.Wpf.Controls.ViewRegion.PopupWindowManager.HideAllExcept ( string name )

inline

지정한 이름을 제외한 표시 중인 모든 팝업 창을 숨깁니다.

매개변수

name	표시 상태를 유지할 팝업 이름입니다.

PopupWindowManager.cs 파일의 497 번째 라인에서 정의되었습니다.

        {
            foreach (var kv in _popupWindows)
            {
                if (kv.Key != name && kv.Value.IsVisible)
                    kv.Value.Hide();
            }
        }

다음을 참조함 : _popupWindows.

SetPopupPosition()

void Dreamine.UI.Wpf.Controls.ViewRegion.PopupWindowManager.SetPopupPosition ( Window popup, Window? owner )

inlinestaticprivate

팝업을 화면 또는 표시 중인 소유자 창의 중앙에 배치합니다.

매개변수

popup	위치를 조정할 팝업입니다.
owner	선택적 소유자 창입니다.

PopupWindowManager.cs 파일의 401 번째 라인에서 정의되었습니다.

        {
            bool centerOnScreen = popup.Tag is true;
 
            if (centerOnScreen)
            {
                var screenWidth = SystemParameters.PrimaryScreenWidth;
                var screenHeight = SystemParameters.PrimaryScreenHeight;
                popup.Left = (screenWidth - popup.Width) / 2;
                popup.Top = (screenHeight - popup.Height) / 2;
            }
            else if (owner != null && owner.IsLoaded && owner.IsVisible)
            {
                popup.Left = owner.Left + (owner.Width - popup.Width) / 2;
                popup.Top = owner.Top + (owner.Height - popup.Height) / 2;
            }
        }

다음에 의해서 참조됨 : CreatePopup().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

SetPopupSize()

void Dreamine.UI.Wpf.Controls.ViewRegion.PopupWindowManager.SetPopupSize ( string name, double width, double height )

inline

등록된 팝업 창의 너비와 높이를 변경합니다.

매개변수

name	팝업 등록 이름입니다.
width	새 너비입니다.
height	새 높이입니다.

예외

KeyNotFoundException	name 에 해당하는 팝업이 없으면 발생합니다.
ArgumentException	너비 또는 높이가 WPF 창 크기로 유효하지 않으면 발생할 수 있습니다.

PopupWindowManager.cs 파일의 107 번째 라인에서 정의되었습니다.

        {
            _popupWindows[name].Width = width;
            _popupWindows[name].Height = height;
        }

다음을 참조함 : _popupWindows.

Show()

void Dreamine.UI.Wpf.Controls.ViewRegion.PopupWindowManager.Show ( string name )

inline

지정한 이름의 팝업을 표시하고 활성화합니다.

매개변수

name	표시할 팝업 이름입니다.

예외

ArgumentNullException	name 이 null이면 발생합니다.
InvalidOperationException	창을 표시하거나 활성화할 수 없는 상태이면 발생할 수 있습니다.

PopupWindowManager.cs 파일의 470 번째 라인에서 정의되었습니다.

        {
            if (_popupWindows.TryGetValue(name, out var popup))
            {
                if (!popup.IsVisible)
                    popup.Show();
 
                popup.Activate();
            }
        }

다음을 참조함 : _popupWindows.

멤버 데이터 문서화

_popupWindows

readonly Dictionary<string, Window> Dreamine.UI.Wpf.Controls.ViewRegion.PopupWindowManager._popupWindows = new()

private

이름별 등록된 팝업 창 저장소입니다.

PopupWindowManager.cs 파일의 57 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : Clear(), CloseAll(), CreatePopup(), HideAllExcept(), SetPopupSize(), Show().

속성 문서화

Height

double Dreamine.UI.Wpf.Controls.ViewRegion.PopupWindowManager.Height = 600

getset

새 팝업의 기본 높이를 가져오거나 설정합니다.

PopupWindowManager.cs 파일의 38 번째 라인에서 정의되었습니다.

{ get; set; } = 600;

다음에 의해서 참조됨 : CreatePopup().

Instance

PopupWindowManager Dreamine.UI.Wpf.Controls.ViewRegion.PopupWindowManager.Instance = new()

staticget

공유 팝업 창 관리자 인스턴스를 가져옵니다.

PopupWindowManager.cs 파일의 48 번째 라인에서 정의되었습니다.

{ get; } = new();

Width

double Dreamine.UI.Wpf.Controls.ViewRegion.PopupWindowManager.Width = 800

getset

새 팝업의 기본 너비를 가져오거나 설정합니다.

PopupWindowManager.cs 파일의 28 번째 라인에서 정의되었습니다.

{ get; set; } = 800;

다음에 의해서 참조됨 : CreatePopup().

Windows

IReadOnlyDictionary<string, Window> Dreamine.UI.Wpf.Controls.ViewRegion.PopupWindowManager.Windows

get

현재 등록된 이름별 팝업 창을 읽기 전용 인터페이스로 가져옵니다.

PopupWindowManager.cs 파일의 121 번째 라인에서 정의되었습니다.

---

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

• PopupWindowManager.cs