systemPreferences
시스템 설정을 가져옵니다.
프로세스: 메인
const {systemPreferences} = require('electron')
console.log(systemPreferences.isDarkMode())
Events
systemPreferences
객체는 다음 이벤트를 발생시킵니다:
Event: 'accent-color-changed' Windows
Returns:
event
EventnewColor
String - 사용자에 의해 시스템 강조색으로 설정 된 새 RGBA 색상.
Event: 'color-changed' Windows
Returns:
event
Event
Event: 'inverted-color-scheme-changed' Windows
Returns:
event
EventinvertedColorScheme
Boolean - 고대비 테마 같은 반전된 색상 스킴을 사용중이라면true
, 아니면false
.
Methods
systemPreferences.isDarkMode()
macOS
Returns Boolean
- 시스템이 어두운 모드인지 여부.
systemPreferences.isSwipeTrackingFromScrollEventsEnabled()
macOS
Returns Boolean
- 페이지 간의 스와이프가 설정되어 있는지 여부.
systemPreferences.postNotification(event, userInfo)
macOS
event
StringuserInfo
Object
macOS 의 기본 알림으로 event
를 전달합니다. userInfo
는 알림과 함께 전송되는
사용자 정보 딕셔너리를 포함하는 객체입니다.
systemPreferences.postLocalNotification(event, userInfo)
macOS
event
StringuserInfo
Object
macOS 의 기본 알림으로 event
를 전달합니다. userInfo
는 알림과 함께 전송되는
사용자 정보 딕셔너리를 포함하는 객체입니다.
systemPreferences.subscribeNotification(event, callback)
macOS
event
Stringcallback
Functionevent
StringuserInfo
Object
macOS의 기본 알림을 구독하며, 해당하는 event
가 발생하면 callback
이
callback(event, userInfo)
형태로 호출됩니다. userInfo
는 알림과 함께 전송되는
사용자 정보 딕셔너리를 포함하는 객체입니다.
구독자의 id
가 반환되며 event
를 구독 해제할 때 사용할 수 있습니다.
이 API는 후드에서 NSDistributedNotificationCenter
를 구독하며, event
의 예시
값은 다음과 같습니다:
AppleInterfaceThemeChangedNotification
AppleAquaColorVariantChanged
AppleColorPreferencesChangedNotification
AppleShowScrollBarsSettingChanged
systemPreferences.unsubscribeNotification(id)
macOS
id
Integer
id
와 함께 구독자를 제거합니다.
systemPreferences.subscribeLocalNotification(event, callback)
macOS
event
Stringcallback
Functionevent
StringuserInfo
Object
subscribeNotification
와 같습니다. 하지만 로컬 기본값에 대해
NSNotificationCenter
를 사용합니다. 이는 NSUserDefaultsDidChangeNotification
와
같은 이벤트에 대해 필수적입니다.
systemPreferences.unsubscribeLocalNotification(id)
macOS
id
Integer
unsubscribeNotification
와 같지만, NSNotificationCenter
에서 구독자를 제거합니다.
systemPreferences.getUserDefault(key, type)
macOS
key
Stringtype
String -string
,boolean
,integer
,float
,double
,url
,array
,dictionary
값이 될 수 있습니다.
시스템 설정에서 key
에 해당하는 값을 가져옵니다.
macOS에선 API가 NSUserDefaults
를 읽어들입니다. 유명한 key
와 type
은 다음과
같습니다:
AppleInterfaceStyle: string
AppleAquaColorVariant: integer
AppleHighlightColor: string
AppleShowScrollBars: string
NSNavRecentPlaces: array
NSPreferredWebServices: dictionary
NSUserDictionaryReplacementItems: array
systemPreferences.isAeroGlassEnabled()
Windows
이 메서드는 DWM 컴포지션 (Aero Glass)가 활성화 되어있을 때
true
를 반환합니다. 아닌 경우 false
를 반환합니다.
다음은 투명한 윈도우를 만들지, 일반 윈도우를 만들지를 판단하여 윈도우를 생성하는 예시입니다 (투명한 윈도우는 DWM 컴포지션이 비활성화되어있을 시 작동하지 않습니다):
const {BrowserWindow, systemPreferences} = require('electron')
let browserOptions = {width: 1000, height: 800}
// 플랫폼이 지원하는 경우에만 투명 윈도우를 생성.
if (process.platform !== 'win32' || systemPreferences.isAeroGlassEnabled()) {
browserOptions.transparent = true
browserOptions.frame = false
}
// 원도우 생성
let win = new BrowserWindow(browserOptions)
// 페이지 로드.
if (browserOptions.transparent) {
win.loadURL(`file://${__dirname}/index.html`)
} else {
// 투명 윈도우 상태가 아니라면, 기본적인 스타일 사용
win.loadURL(`file://${__dirname}/fallback.html`)
}
systemPreferences.getAccentColor()
Windows
Returns String
- 사용자 현재 시스템 전체 강조 색상 설정의 16진수 형식 RGBA 값.
const color = systemPreferences.getAccentColor() // `"aabbccdd"`
const red = color.substr(0, 2) // "aa"
const green = color.substr(2, 2) // "bb"
const blue = color.substr(4, 2) // "cc"
const alpha = color.substr(6, 2) // "dd"
systemPreferences.getColor(color)
Windows
color
String - 다음 값 중 하나:3d-dark-shadow
- 3차원 요소의 어두운 그림자 색.3d-face
- 3차원 요소와 대화상자 배경의 표면 색.3d-highlight
- 3차원 요소의 가장 밝은 색.3d-light
- 3차원 요소의 밝은 색.3d-shadow
- 3차원 요소의 그림자 색.active-border
- 활성창의 테두리 색.active-caption
- 활성창의 제목줄. 그라데이션 효과가 활성화 되있으면 활성창 제목줄 그라데이션의 좌측 색.active-caption-gradient
- 그라데이션 효과가 활성화 되있으면 활성창 제목줄 그라데이션의 우측 색.app-workspace
- 다중 문서 인터페이스 (MDI) 애플리케이션의 배경색.button-text
- 버튼의 글자색.caption-text
- 제목줄, 크기 상자, 스크롤바 화살표 상자의 글자색.desktop
- 데스크탑 배경 색.disabled-text
- 회색 (비활성) 글자색.highlight
- 컨트롤에서 선택된 항목(들)의 색.highlight-text
- 컨트롤에서 선택된 항목(들)의 글자색.hotlight
- 하이퍼링크 또는 실시간 추적되는 항목의 색.inactive-border
- 비활성창의 테두리 색.inactive-caption
- 비활성창의 제목줄. 그라데이션 효과가 활성화 되있으면 비활성창 제목줄 그라데이션의 좌측 색.inactive-caption-gradient
- 그라데이션 효과가 활성화 되있으면 비활성창 제목줄 그라데이션의 좌측 색.inactive-caption-text
- 비활성 제목줄의 글자색.info-background
- 툴팁 컨트롤의 배경색.info-text
- 툴팁 컨트롤의 글자색.menu
- 메뉴 배경색.menu-highlight
- 평면 메뉴일때 메뉴 항목 강조 색.menubar
- 평면 메뉴일때 메뉴 막대의 배경색.menu-text
- 메뉴의 글자.scrollbar
- 스크롤바 회색 영역.window
- 창의 배경.window-frame
- 창 테두리.window-text
- 창의 글자.
Returns String
- 16진수 RGB 형식 (#ABCDEF
) 의 시스템 색상 설정.
자세한 내용은 윈도우 문서를 보세요.
systemPreferences.isInvertedColorScheme()
Windows
Returns Boolean
- 고대비 테마 같은 반전된 색상 스킴이 활성화 되있다면 true
,
아니면 false
.