electron/docs-translations/ko-KR/api/system-preferences.md

86 lines
2.8 KiB
Markdown
Raw Normal View History

# systemPreferences
> 시스템 설정을 가져옵니다.
## Methods
### `systemPreferences.isDarkMode()` _OS X_
이 메서드는 시스템이 어두운 모드 상태인 경우 `true`를 반환하고 아닐 경우 `false`
반환합니다.
### `systemPreferences.subscribeNotification(event, callback)` _OS X_
* `event` String
* `callback` Function
OS X의 네이티브 알림을 구독하며, 해당하는 `event`가 발생하면 `callback`
`callback(event, userInfo)` 형태로 호출됩니다. `userInfo`는 알림과 함께 전송되는
사용자 정보 딕셔너리를 포함하는 객체입니다.
구독자의 `id`가 반환되며 `event`를 구독 해제할 때 사용할 수 있습니다.
이 API는 후드에서 `NSDistributedNotificationCenter`를 구독하며, `event`의 예시
값은 다음과 같습니다:
* `AppleInterfaceThemeChangedNotification`
* `AppleAquaColorVariantChanged`
* `AppleColorPreferencesChangedNotification`
* `AppleShowScrollBarsSettingChanged`
### `systemPreferences.unsubscribeNotification(id)` _OS X_
* `id` Integer
`id`와 함께 구독자를 제거합니다.
### `systemPreferences.getUserDefault(key, type)` _OS X_
* `key` String
* `type` String - `string`, `boolean`, `integer`, `float`, `double`, `url`,
`array`, `dictionary` 값이 될 수 있습니다.
시스템 설정에서 `key`에 해당하는 값을 가져옵니다.
OS X에선 API가 `NSUserDefaults`를 읽어들입니다. 유명한 `key``type`은 다음과
같습니다:
* `AppleInterfaceStyle: string`
* `AppleAquaColorVariant: integer`
* `AppleHighlightColor: string`
* `AppleShowScrollBars: string`
* `NSNavRecentPlaces: array`
* `NSPreferredWebServices: dictionary`
* `NSUserDictionaryReplacementItems: array`
### `systemPreferences.isAeroGlassEnabled()` _Windows_
이 메서드는 [DWM 컴포지션][dwm-composition] (Aero Glass)가 활성화 되어있을 때
`true`를 반환합니다. 아닌 경우 `false`를 반환합니다.
다음은 투명한 윈도우를 만들지, 일반 윈도우를 만들지를 판단하여 윈도우를 생성하는
예시입니다 (투명한 윈도우는 DWM 컴포지션이 비활성화되어있을 시 작동하지 않습니다):
```javascript
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');
}
```
[dwm-composition]:https://msdn.microsoft.com/en-us/library/windows/desktop/aa969540.aspx