📝 Update Korean docs as upstream

[ci skip]
This commit is contained in:
Plusb Preco 2016-07-13 02:53:26 +09:00
parent 56e679632f
commit 797aef60ee
5 changed files with 123 additions and 31 deletions

View file

@ -264,6 +264,19 @@ app.on('login', (event, webContents, request, authInfo, callback) => {
GPU가 작동하던 중 크래시가 일어났을 때 발생하는 이벤트입니다.
### Event: 'accessibility-support-changed' _macOS_ _Windows_
Returns:
* `event` Event
* `accessibilitySupportEnabled` Boolean - Chrome의 접근성 지원이 활성화되어있으면
`true`를 반환하고 아니라면 `false`를 반환합니다.
Chrome의 접근성 지원이 변경될 때 발생하는 이벤트입니다. 이 이벤트는 스크린 리더와 같은
접근성 기술이 활성화되거나 비활성화될 때 발생합니다.
자세한 내용은 https://www.chromium.org/developers/design-documents/accessibility 를
참고하세요.
## Methods
`app` 객체는 다음과 같은 메서드를 가지고 있습니다:
@ -579,6 +592,33 @@ pkcs12 형식으로된 인증서를 플랫폼 인증서 저장소로 가져옵
이 메서드는 `app``ready` 이벤트가 발생하기 전에만 호출할 수 있습니다.
### `app.setBadgeCount(count)` _Linux_ _macOS_
* `count` Integer
현재 앱에 대해 카운터 뱃지를 설정합니다. count를 `0`으로 설정하면 뱃지를 숨깁니다.
호출이 성공적으로 끝나면 `true`를 반환하고 아닌 경우 `false`를 반환합니다.
macOS에선 독 아이콘에 표시됩니다. Linux에선 Unity 런처에서만 작동합니다.
**참고:** Unity 런처는 이 기능을 작동하기 위해 `.desktop` 파일을 필요로 합니다.
이에 대한 자세한 내용은 [데스크톱 환경 통합][unity-requiremnt]을 참고하세요.
### `app.getBadgeCount()` _Linux_ _macOS_
현재 카운터 뱃지에 표시중인 값을 반환합니다.
### `app.isUnityRunning()` _Linux_
현재 데스크톱 환경이 Unity인지 여부를 반환합니다.
### `app.isAccessibilitySupportEnabled()` _macOS_ _Windows_
`Boolean` 값을 반환하며 Chrome의 접근성 지원이 활성화되어있으면 `true`를 그렇지
않다면 `false`를 반환합니다. 이 API는 사용할 수 있는 스크린 리더와 같은 접근성 기술이
감지되었을 때 `true`를 반환합니다. 자세한 내용은
https://www.chromium.org/developers/design-documents/accessibility 를 참고하세요.
### `app.commandLine.appendSwitch(switch[, value])`
Chrominum의 명령줄에 스위치를 추가합니다. `value`는 추가적인 값을 뜻하며 옵션입니다.
@ -647,32 +687,31 @@ dock 아이콘을 표시합니다.
dock 아이콘의 `image`를 설정합니다.
### `app.launcher.setBadgeCount(count)` _Linux_
* `count` Integer
### `app.getLoginItemSettings()` _macOS_
Unity 런처에서 앱 아이콘 옆에 표시될 숫자를 설정합니다. `0`으로 설정하면 뱃지를
숨깁니다.
앱의 로그인 항목 설정을 객체로 반환합니다.
**참고:** 이 기능은 현재 Ubuntu Unity에서만 사용할 수 있습니다. 다른 환경에서 이
함수를 호출하는 것은 아무런 효과가 없습니다.
* `openAtLogin` Boolean - 앱이 로그인시 열리도록 설정되어있는 경우 `true`를 반환.
* `openAsHidden` Boolean - 앱이 로구인시 숨겨진 채로 열리도록 설정되어있는 경우
`true`를 반환.
* `wasOpenedAtLogin` Boolean - 자동으로 로그인할 때 애플리케이션이 열려있었는지 여부.
* `wasOpenedAsHidden` Boolean - 앱이 숨겨진 로그인 항목처럼 열려있었는지 여부.
이는 앱이 시작시 어떤 윈도우도 열지 않을 것을 표시합니다.
* `restoreState` Boolean - 앱이 이전 세션에서 상태를 복원하여 로그인 항목처럼
열려있었는지 여부. 이는 앱이 마지막으로 종료되었던 때에 열려있었던 윈도우를 복원하는
것을 표시합니다.
**참고:** 이 기능을 사용하려면 `package.json``desktopName` 필드에 `.desktop` 파일 이름을 설정해야 합니다. 기본적으로 패키징된 애플리케이션의 `app.getName().desktop`을 사용합니다.
### `app.setLoginItemSettings(settings)` _macOS_
### `app.launcher.getBadgeCount()` _Linux_
* `settings` Object
* `openAtLogin` Boolean - `true`로 지정하면 로그인시 애플리케이션을 열도록 하며
`false`로 지정시 로그인 항목에서 삭제합니다.
* `openAsHidden` Boolean - `true`로 지정하면 애플리케이션을 숨겨진 채로 열도록
합니다. 기본값은 `false`입니다. 사용자가 시스템 설정에서 이 설정을 변경할 수
있으며 앱이 열렸을 때 현재 값을 확인하려면
`app.getLoginItemStatus().wasOpenedAsHidden`를 확인해야 합니다.
런처 아이콘 옆 배지의 카운터에 표시된 현재 값을 반환합니다.
**참고:** `setBadgeCount`가 Ubuntu Unity에서만 지원하기 때문에, 애플리케이션이 다른
플랫폼에서 돌아가고 있다면 이 메서드는 `0`을 반환합니다.
### `app.launcher.isUnityRunning()` _Linux_
현재 데스크톱 환경이 Unity인지 여부를 반환합니다. Unity가 맞다면 `true`를 반환합니다.
### `app.launcher.isCounterBadgeAvailable()` _Linux_
현재 데스크톱 환경이 애플리케이션 아이콘 카운터 뱃지를 사용할 수 있는지 여부를
반환합니다. 사용할 수 있다면 `true`를 반환합니다.
앱의 로그인 항목 설정을 지정합니다.
[dock-menu]:https://developer.apple.com/library/mac/documentation/Carbon/Conceptual/customizing_docktile/concepts/dockconcepts.html#//apple_ref/doc/uid/TP30000986-CH2-TPXREF103
[tasks]:http://msdn.microsoft.com/en-us/library/windows/desktop/dd378460(v=vs.85).aspx#tasks
@ -681,3 +720,4 @@ Unity 런처에서 앱 아이콘 옆에 표시될 숫자를 설정합니다. `0`
[LSCopyDefaultHandlerForURLScheme]: https://developer.apple.com/library/mac/documentation/Carbon/Reference/LaunchServicesReference/#//apple_ref/c/func/LSCopyDefaultHandlerForURLScheme
[handoff]: https://developer.apple.com/library/ios/documentation/UserExperience/Conceptual/Handoff/HandoffFundamentals/HandoffFundamentals.html
[activity-type]: https://developer.apple.com/library/ios/documentation/Foundation/Reference/NSUserActivity_Class/index.html#//apple_ref/occ/instp/NSUserActivity/activityType
[unity-requiremnt]: ../tutorial/desktop-environment-integration.md#unity-launcher-shortcuts-linux

View file

@ -182,6 +182,9 @@ On Windows it is
기본 값은 `true`입니다.
* `titleBarStyle` String, macOS - 윈도우 타이틀 바 스타일을 지정합니다. 자세한 사항은
아래를 참고하세요.
* `thickFrame` Boolean - Windows에서 테두리 없는 윈도우를 위해 표준 윈도우 프레임을
추가하는 `WS_THICKFRAME` 스타일을 사용합니다. `false`로 지정하면 윈도우의 그림자와
애니메이션을 삭제합니다. 기본값은 `true`입니다.
* `webPreferences` Object - 웹 페이지 기능을 설정합니다. 사용할 수 있는 속성은
아래를 참고하세요.
@ -884,16 +887,7 @@ Windows 메시지 훅을 등록합니다. `callback`은 WndProc에서 메시지
### `win.capturePage([rect, ]callback)`
* `rect` Object (optional) - 캡쳐할 페이지의 영역
* `x` Integer
* `y` Integer
* `width` Integer
* `height` Integer
* `callback` Function
페이지의 스크린샷을 `rect`에 설정한 만큼 캡처합니다. 캡처가 완료되면 `callback`
`callback(image)` 형식으로 호출됩니다. `image`는 [NativeImage](native-image.md)의
인스턴스이며 스크린샷 데이터를 담고있습니다. `rect`를 생략하면 페이지 전체를 캡처합니다.
`webContents.capturePage([rect, ]callback)`와 같습니다.
### `win.loadURL(url[, options])`

View file

@ -648,6 +648,19 @@ webContents.on('found-in-page', (event, result) => {
const requestId = webContents.findInPage('api');
```
### `webContents.capturePage([rect, ]callback)`
* `rect` Object (optional) - 캡쳐할 페이지의 영역
* `x` Integer
* `y` Integer
* `width` Integer
* `height` Integer
* `callback` Function
페이지의 스크린샷을 `rect`에 설정한 만큼 캡처합니다. 캡처가 완료되면 `callback`
`callback(image)` 형식으로 호출됩니다. `image`는 [NativeImage](native-image.md)의
인스턴스이며 스크린샷 데이터를 담고있습니다. `rect`를 생략하면 페이지 전체를 캡처합니다.
### `webContents.hasServiceWorker(callback)`
* `callback` Function
@ -925,6 +938,16 @@ Input `event`를 웹 페이지로 전송합니다.
프레임 프레젠테이션 이벤트들에 대한 구독을 중지합니다.
### `webContents.startDrag(item)`
* `item` object
* `file` String
* `icon` [NativeImage](native-image.md)
현재 진행중인 드래그-드롭에 `item`을 드래그 중인 아이템으로 설정합니다. `file`
드래그될 파일의 절대 경로입니다. 그리고 `icon`은 드래그 도중 커서 밑에 표시될
이미지입니다.
### `webContents.savePage(fullPath, saveType, callback)`
* `fullPath` String - 전체 파일 경로.

View file

@ -458,6 +458,11 @@ Service worker에 대한 개발자 도구를 엽니다.
`webview` 페이지를 PDF 형식으로 인쇄합니다.
`webContents.printToPDF(options, callback)` 메서드와 같습니다.
### `<webview>.capturePage([rect, ]callback)`
`webview`의 페이지의 스냅샷을 캡쳐합니다.
`webContents.printToPDF(options, callback)` 메서드와 같습니다.
### `<webview>.send(channel[, arg1][, arg2][, ...])`
* `channel` String

View file

@ -310,6 +310,36 @@ win.setRepresentedFilename('/etc/passwd');
win.setDocumentEdited(true);
```
## 파일을 윈도우 밖으로 드래그할 수 있도록 만들기
파일을 조작하는 특정 종류의 애플리케이션들에서 파일을 Electron에서 다른 애플리케이션으로
드래그할 수 있는 기능은 중요합니다. 이 기능을 구현하려면 애플리케이션에서
`ondragstart` 이벤트가 발생했을 때 `webContents.startDrag(item)` API를 호출해야
합니다:
웹 페이지에서:
```html
<a href="#" id="drag">item</a>
<script type="text/javascript" charset="utf-8">
document.getElementById('drag').ondragstart = (event) => {
event.preventDefault()
ipcRenderer.send('ondragstart', '/path/to/item')
}
</script>
```
메인 프로세스에서:
```javascript
ipcMain.on('ondragstart', (event, filePath) => {
event.sender.startDrag({
file: filePath,
icon: '/path/to/icon.png'
})
})
```
[addrecentdocument]: ../api/app.md#appaddrecentdocumentpath-os-x-windows
[clearrecentdocuments]: ../api/app.md#appclearrecentdocuments-os-x-windows
[setusertaskstasks]: ../api/app.md#appsetusertaskstasks-windows