Repository navigation
Conductors
dragonfavors edited this page Nov 10, 2026
·
5 revisions
Conductor는 자식 화면을 소유하고 전환·종료·폐기 완료를 기다립니다. ActiveItem과 Items는 읽기 전용입니다.
| 종류 | 전환할 때 |
|---|---|
Conductor<T> |
이전 화면의 종료 허용 여부 확인 → 종료·폐기 → 새 화면 활성화 |
Conductor<T>.Collection.OneActive |
이전 화면을 비활성화해 보관 → 새 화면 활성화 |
Conductor<T>.Collection.AllActive |
등록한 화면들을 함께 활성화 |
Conductor<T>.StackNavigation |
이전 화면을 이력에 보관, GoBackAsync로 복귀 |
부모가 비활성이면 등록·선택만 준비합니다. 부모를 활성화하거나 닫으면 자식의 작업 완료도 기다립니다.
using CommunityToolkit.Mvvm.Input;
using Gyedo;
using System.Threading;
using System.Threading.Tasks;
public class HomeViewModel : Screen { }
public class SettingsViewModel : Screen { }
public partial class ShellViewModel : Conductor<IScreen>
{
protected override Task OnInitialActivatedAsync(CancellationToken token) =>
this.ActivateItemAsync(new HomeViewModel());
[RelayCommand]
private async Task OpenSettingsAsync()
{
bool changed = await this.ActivateItemAsync(new SettingsViewModel());
// false이면 이전 화면이 종료를 거절했습니다.
}
}자식 View는 보통 UserControl로 만들고 <ContentControl g:View.Model="{Binding ActiveItem}" />로 표시합니다. View 연결
위 using과 HomeViewModel·SettingsViewModel을 사용하는 예입니다.
public class TabsViewModel : Conductor<IScreen>.Collection.OneActive
{
protected override async Task OnInitialActivatedAsync(CancellationToken token)
{
var home = new HomeViewModel();
await this.AddItemAsync(home);
await this.AddItemAsync(new SettingsViewModel());
await this.ActivateItemAsync(home);
}
}<TabControl Style="{StaticResource GyedoConductorTabControl}" />기본 스타일은 탭 선택을 비동기 탐색에 연결합니다. 전환 중 선택 UI를 비활성화하고, 실패하면 이전 선택을 복구합니다. ActiveItem에 직접 대입하거나 양방향 바인딩하지 않습니다.
| 작업 | API |
|---|---|
| OneActive에 선택 없이 추가 | await AddItemAsync(item) |
| 추가하고 선택 / AllActive에 추가 | await ActivateItemAsync(item) |
| 비활성화 | await DeactivateItemAsync(item) |
| 종료 확인 후 닫기 |
await CloseItemAsync(item) 또는 자식의 RequestCloseAsync()
|
| OneActive·AllActive 전체 닫기 | await ClearAsync() |
| StackNavigation 뒤로 이동 | await GoBackAsync() |
| StackNavigation 이전 이력만 닫기 | await ClearAsync() |
종료가 거절되면 false를 반환합니다. DisposeChildren은 기본 true이며 종료 완료 후 부모 연결을 해제하고 폐기합니다. DI 소유 VM에는 폐기 책임을 맞추세요.
한 화면은 한 부모가 소유합니다. 다른 부모의 화면을 가져오거나 자식 활성화 훅에서 부모 탐색을 다시 기다리면 예외가 발생합니다.
새 화면 활성화 실패 시 이미 닫은 이전 화면은 복원하지 않습니다. 이전 화면을 보관하는 종류는 가능한 경우 다시 활성화합니다. 실패한 자식도 소유 목록에 남으므로 재시도하거나 닫을 수 있습니다.