Dreamine.UI.Wpf.Equipment.Popup.DreaminePopupService 클래스 참조

더 자세히 ...

Dreamine.UI.Wpf.Equipment.Popup.DreaminePopupService에 대한 상속 다이어그램 :

Dreamine.UI.Wpf.Equipment.Popup.DreaminePopupService에 대한 협력 다이어그램:

Public 멤버 함수
bool?	ShowBlink (Window? owner, BlinkPopupOptions options)
bool?	ShowBlink (Window? owner, BlinkPopupOptions options, out Window windowRef)
void	CloseAll ()
void	Close (Window window)
void	CloseOwnedBy (Window owner)
Window?	GetActive ()
bool	TryGetOptions (Window window, out BlinkPopupOptions? options)
bool	TryGetOwnerOptions (Window window, out BlinkPopupOptions? ownerOptions)
void	RegisterWindow (Window window, BlinkPopupOptions options)
async Task< bool?>	ShowBlinkAsync (Window? owner, BlinkPopupOptions options, TimeSpan? autoCloseAfter=null, CancellationToken cancellationToken=default)

Private 속성
readonly List< Window >	_opened = new()
readonly Dictionary< Window, BlinkPopupOptions >	_optionsByWindow = new()

상세한 설명

점멸 팝업 창을 표시·추적·종료하고 동기 및 비동기 결과를 제공합니다.

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

멤버 함수 문서화

Close()

void Dreamine.UI.Wpf.Equipment.Popup.DreaminePopupService.Close ( Window window )

inline

지정한 창이 추적 중이고 로드되어 있으면 닫습니다.

매개변수

window

닫을 창입니다. null은 무시됩니다.

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

        {
            if (window == null) return;
            if (_opened.Contains(window) && window.IsLoaded)
                window.Close();
        }

다음을 참조함 : _opened.

CloseAll()

void Dreamine.UI.Wpf.Equipment.Popup.DreaminePopupService.CloseAll ( )

inline

추적 중이며 로드된 모든 팝업 창을 닫고 내부 추적 상태를 비웁니다.

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

        {
            foreach (var w in _opened.ToList())
                if (w.IsLoaded) w.Close();
 
            _opened.Clear();
            _optionsByWindow.Clear();
        }

다음을 참조함 : _opened, _optionsByWindow.

CloseOwnedBy()

void Dreamine.UI.Wpf.Equipment.Popup.DreaminePopupService.CloseOwnedBy ( Window owner )

inline

지정한 소유 창에 속한 모든 로드된 팝업을 닫습니다.

매개변수

owner

자식 팝업을 닫을 소유 창입니다. null은 무시됩니다.

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

        {
            if (owner == null) return;
            var targets = _opened.Where(w => Equals(w.Owner, owner)).ToList();
            foreach (var w in targets)
                if (w.IsLoaded) w.Close();
        }

다음을 참조함 : _opened.

GetActive()

Window? Dreamine.UI.Wpf.Equipment.Popup.DreaminePopupService.GetActive ( )

inline

활성 추적 창을 우선하고 없으면 마지막 표시 창을 반환합니다.

반환값

활성 또는 표시 팝업이며 없으면 null입니다.

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

            => _opened.LastOrDefault(w => w.IsVisible && w.IsActive)
            ?? _opened.LastOrDefault(w => w.IsVisible);

다음을 참조함 : _opened.

다음에 의해서 참조됨 : ShowBlink(), ShowBlinkAsync().

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

RegisterWindow()

void Dreamine.UI.Wpf.Equipment.Popup.DreaminePopupService.RegisterWindow ( Window window, BlinkPopupOptions options )

inline

외부에서 만든 팝업 창과 옵션을 추적 대상으로 등록하고 닫힘 시 자동 제거합니다.

매개변수

window	등록할 팝업 창입니다.
options	창에 연결할 팝업 옵션입니다.

예외

ArgumentNullException

window 가 null일 때 발생합니다.

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

        {
            if (window is null)
                throw new ArgumentNullException(nameof(window));
 
            // 중복 등록 방지
            if (_opened.Contains(window))
                return;
 
            _opened.Add(window);
            _optionsByWindow[window] = options;
 
            window.Closed += (_, __) =>
            {
                _opened.Remove(window);
                _optionsByWindow.Remove(window);
            };
        }

다음을 참조함 : _opened, _optionsByWindow.

ShowBlink() [1/2]

bool? Dreamine.UI.Wpf.Equipment.Popup.DreaminePopupService.ShowBlink ( Window? owner, BlinkPopupOptions options )

inline

점멸 팝업을 표시하고 모달이면 결과를 반환합니다.

매개변수

owner	선택적 소유 창입니다.
options	팝업 표시 옵션입니다.

반환값

모달 결과이며 비모달이면 null입니다.

예외

ArgumentNullException

options 가 null일 때 팝업 생성 중 발생할 수 있습니다.

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

            => ShowBlink(owner, options, out _);

ShowBlink() [2/2]

bool? Dreamine.UI.Wpf.Equipment.Popup.DreaminePopupService.ShowBlink ( Window? owner, BlinkPopupOptions options, out Window windowRef )

inline

점멸 팝업을 표시하고 생성된 창 참조와 모달 결과를 반환합니다.

매개변수

owner	선택적 소유 창입니다.
options	팝업 표시 옵션입니다.
windowRef	생성된 팝업 창입니다.

반환값

모달 결과이며 비모달이면 null입니다.

예외

ArgumentNullException

options 가 null일 때 팝업 생성 중 발생할 수 있습니다.

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

        {
            var win = new DreamineBlinkPopupWindow(options);
 
            // Owner 설정
            if (owner != null)
            {
                win.Owner = owner;
                win.WindowStartupLocation = WindowStartupLocation.CenterOwner;
            }
            else
            {
                var active = GetActive() ?? Application.Current?.MainWindow;
                if (active != null)
                {
                    win.Owner = active;
                    win.WindowStartupLocation = WindowStartupLocation.CenterOwner;
                }
                else
                {
                    win.WindowStartupLocation = WindowStartupLocation.CenterScreen;
                }
            }
 
            // 추적: 창 + 옵션
            _opened.Add(win);
            _optionsByWindow[win] = options;
 
            // 정리: 창 닫힐 때 제거
            win.Closed += (_, __) =>
            {
                _opened.Remove(win);
                _optionsByWindow.Remove(win);
            };
 
            windowRef = win;
 
            // 표시
            if (options.IsModal)
            {
                return win.ShowDialog();
            }
            else
            {
                win.Show();
                return null;
            }
        }

다음을 참조함 : _opened, _optionsByWindow, GetActive().

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

ShowBlinkAsync()

async Task< bool?> Dreamine.UI.Wpf.Equipment.Popup.DreaminePopupService.ShowBlinkAsync ( Window? owner, BlinkPopupOptions options, TimeSpan? autoCloseAfter = null, CancellationToken cancellationToken = default )

inline

UI 디스패처에서 팝업을 비동기로 표시하고 닫힘, 자동 종료 또는 취소 후 결과를 반환합니다.

매개변수

owner	선택적 소유 창입니다.
options	팝업 표시 옵션입니다.
autoCloseAfter	선택적 자동 종료 지연 시간입니다.
cancellationToken	창 닫기를 요청할 취소 토큰입니다.

반환값

확인·취소 결과이며 결과 없이 닫히면 null입니다.

예외

NullReferenceException	options 또는 현재 WPF 애플리케이션이 없을 때 발생할 수 있습니다.
InvalidOperationException	사용할 UI 디스패처가 없을 때 발생합니다.

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

        {
            // 모든 UI 조작은 UI 스레드에서
            var dispatcher = (owner ?? Application.Current?.MainWindow)?.Dispatcher
                             ?? Application.Current!.Dispatcher;
 
            if (dispatcher == null)
                throw new InvalidOperationException("Dispatcher not available.");
 
            var tcs = new TaskCompletionSource<bool?>(TaskCreationOptions.RunContinuationsAsynchronously);
            Window? win = null;
            bool wasOwnerEnabled = false;
 
            await dispatcher.InvokeAsync(() =>
            {
                win = new DreamineBlinkPopupWindow(options);
 
                // Owner 결정
                if (owner != null)
                {
                    win.Owner = owner;
                    win.WindowStartupLocation = WindowStartupLocation.CenterOwner;
                }
                else
                {
                    var active = GetActive() ?? Application.Current?.MainWindow;
                    if (active != null)
                    {
                        win.Owner = active;
                        win.WindowStartupLocation = WindowStartupLocation.CenterOwner;
                    }
                    else
                    {
                        win.WindowStartupLocation = WindowStartupLocation.CenterScreen;
                    }
                }
 
                // 등록
                _opened.Add(win);
                _optionsByWindow[win] = options;
 
                // 닫힘 시 정리 + 결과 완료
                win.Closed += (_, __) =>
                {
                    _opened.Remove(win);
                    _optionsByWindow.Remove(win);
 
                    // 모달 효과 복원
                    if (options.IsModal && win.Owner != null && wasOwnerEnabled)
                        win.Owner.IsEnabled = true;
 
                    // Show()로 열린 경우 DialogResult는 항상 null → PopupResult 사용
                    var result = (win as DreamineBlinkPopupWindow)?.PopupResult
                                 ?? (win as Window)?.DialogResult;
                    _ = tcs.TrySetResult(result);
                };
 
                // 모달 효과: Owner 잠시 비활성화
                if (options.IsModal && win.Owner != null)
                {
                    wasOwnerEnabled = win.Owner.IsEnabled;
                    win.Owner.IsEnabled = false;
                }
 
                // 표시(비동기 모달 시뮬레이션: ShowDialog 대신 Show 사용)
                win.Show();
 
                // 자동 종료 타이머
                if (autoCloseAfter is TimeSpan delay && delay > TimeSpan.Zero)
                {
                    var timer = new DispatcherTimer { Interval = delay };
                    timer.Tick += (s, e) =>
                    {
                        timer.Stop();
                        if (win.IsLoaded) win.Close();
                    };
                    timer.Start();
                }
            });
 
            // 취소 토큰 연동: 취소 시 UI 스레드에서 닫기
            using (cancellationToken.Register(() =>
            {
                if (win != null)
                {
                    _ = dispatcher.InvokeAsync(() =>
                    {
                        if (win.IsLoaded) win.Close();
                    });
                }
            }))
            {
                return await tcs.Task.ConfigureAwait(false);
            }
        }

다음을 참조함 : _opened, _optionsByWindow, GetActive().

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

TryGetOptions()

bool Dreamine.UI.Wpf.Equipment.Popup.DreaminePopupService.TryGetOptions ( Window window, out BlinkPopupOptions? options )

inline

지정한 추적 창에 연결된 팝업 옵션을 가져오려고 시도합니다.

매개변수

window	조회할 창입니다.
options	성공 시 연결된 옵션입니다.

반환값

옵션을 찾았으면 true입니다.

예외

ArgumentNullException

window 가 null일 때 발생합니다.

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

        {
            return _optionsByWindow.TryGetValue(window, out options);
        }

다음을 참조함 : _optionsByWindow.

TryGetOwnerOptions()

bool Dreamine.UI.Wpf.Equipment.Popup.DreaminePopupService.TryGetOwnerOptions ( Window window, out BlinkPopupOptions? ownerOptions )

inline

지정한 창의 소유 창에 연결된 팝업 옵션을 가져오려고 시도합니다.

매개변수

window	소유 창을 검사할 창입니다.
ownerOptions	성공 시 소유 창의 옵션입니다.

반환값

소유 창과 옵션을 찾았으면 true입니다.

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

        {
            ownerOptions = null;
            if (window?.Owner == null) return false;
            return _optionsByWindow.TryGetValue(window.Owner, out ownerOptions);
        }

다음을 참조함 : _optionsByWindow.

멤버 데이터 문서화

_opened

readonly List<Window> Dreamine.UI.Wpf.Equipment.Popup.DreaminePopupService._opened = new()

private

현재 서비스가 추적하는 열린 창 목록입니다.

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

다음에 의해서 참조됨 : Close(), CloseAll(), CloseOwnedBy(), GetActive(), RegisterWindow(), ShowBlink(), ShowBlinkAsync().

_optionsByWindow

readonly Dictionary<Window, BlinkPopupOptions> Dreamine.UI.Wpf.Equipment.Popup.DreaminePopupService._optionsByWindow = new()

private

각 추적 창에 사용된 팝업 옵션을 보관합니다.

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

다음에 의해서 참조됨 : CloseAll(), RegisterWindow(), ShowBlink(), ShowBlinkAsync(), TryGetOptions(), TryGetOwnerOptions().

---

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

• DreaminePopupService.cs