본문으로 건너뛰기

isFullScreen

Description

데스크탑 앱 창이 현재 전체화면(full-screen) 모드인지 여부를 반환합니다.

앱 시작 시 창 관리자에서 초기 상태를 읽어 캐시하고, 이후 onWindowEnterFullScreen / onWindowLeaveFullScreen 이벤트가 발생할 때마다 값을 갱신합니다.

Parameters

없음

Returns

타입설명
bool현재 전체화면 모드이면 true, 아니면 false

Notes

  • macOS / Windows 데스크탑 전용 기능입니다. 모바일에서는 항상 false 를 반환합니다.
  • 전체화면 상태 변화는 __fullscreenChanged 메시지 이벤트로도 수신할 수 있습니다.
  • 전체화면 전환은 $app.toggleMaximize() 로 제어합니다.

Example

// 현재 전체화면 여부 확인
if ($app.isFullScreen()) {
console.log("전체화면 모드입니다.");
} else {
console.log("일반 창 모드입니다.");
}

// 전체화면 상태 변경 이벤트 수신
$vm.onMessage = function(name, data) {
if (name === "__fullscreenChanged") {
console.log("전체화면:", data.isFullScreen);
}
};
  • $app.toggleMaximize() — 전체화면 ↔ 일반 창 전환
  • $app.isUnfolded() — 폴더블 기기 펼침 상태 확인