зеркало из https://github.com/electron/electron.git
Родитель
56e679632f
Коммит
797aef60ee
|
@ -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
|
||||
|
|
|
@ -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])`
|
||||
|
||||
|
|
|
@ -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 - 전체 파일 경로.
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
Загрузка…
Ссылка в новой задаче