From 797aef60eebb4a25196a78bc01d71caca9eea154 Mon Sep 17 00:00:00 2001 From: Plusb Preco Date: Wed, 13 Jul 2016 02:53:26 +0900 Subject: [PATCH] :memo: Update Korean docs as upstream [ci skip] --- docs-translations/ko-KR/api/app.md | 82 ++++++++++++++----- docs-translations/ko-KR/api/browser-window.md | 14 +--- docs-translations/ko-KR/api/web-contents.md | 23 ++++++ docs-translations/ko-KR/api/web-view-tag.md | 5 ++ .../desktop-environment-integration.md | 30 +++++++ 5 files changed, 123 insertions(+), 31 deletions(-) diff --git a/docs-translations/ko-KR/api/app.md b/docs-translations/ko-KR/api/app.md index a521702abc1a..9dcd0db8e3cf 100644 --- a/docs-translations/ko-KR/api/app.md +++ b/docs-translations/ko-KR/api/app.md @@ -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 diff --git a/docs-translations/ko-KR/api/browser-window.md b/docs-translations/ko-KR/api/browser-window.md index 96bd6af04538..be4e8550ca93 100644 --- a/docs-translations/ko-KR/api/browser-window.md +++ b/docs-translations/ko-KR/api/browser-window.md @@ -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])` diff --git a/docs-translations/ko-KR/api/web-contents.md b/docs-translations/ko-KR/api/web-contents.md index 30c90affdd78..8a0796f13696 100644 --- a/docs-translations/ko-KR/api/web-contents.md +++ b/docs-translations/ko-KR/api/web-contents.md @@ -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 - 전체 파일 경로. diff --git a/docs-translations/ko-KR/api/web-view-tag.md b/docs-translations/ko-KR/api/web-view-tag.md index cb77e77d2429..6170556570e3 100644 --- a/docs-translations/ko-KR/api/web-view-tag.md +++ b/docs-translations/ko-KR/api/web-view-tag.md @@ -458,6 +458,11 @@ Service worker에 대한 개발자 도구를 엽니다. `webview` 페이지를 PDF 형식으로 인쇄합니다. `webContents.printToPDF(options, callback)` 메서드와 같습니다. +### `.capturePage([rect, ]callback)` + +`webview`의 페이지의 스냅샷을 캡쳐합니다. +`webContents.printToPDF(options, callback)` 메서드와 같습니다. + ### `.send(channel[, arg1][, arg2][, ...])` * `channel` String diff --git a/docs-translations/ko-KR/tutorial/desktop-environment-integration.md b/docs-translations/ko-KR/tutorial/desktop-environment-integration.md index 4298083e9a33..2f9ac97a493e 100644 --- a/docs-translations/ko-KR/tutorial/desktop-environment-integration.md +++ b/docs-translations/ko-KR/tutorial/desktop-environment-integration.md @@ -310,6 +310,36 @@ win.setRepresentedFilename('/etc/passwd'); win.setDocumentEdited(true); ``` +## 파일을 윈도우 밖으로 드래그할 수 있도록 만들기 + +파일을 조작하는 특정 종류의 애플리케이션들에서 파일을 Electron에서 다른 애플리케이션으로 +드래그할 수 있는 기능은 중요합니다. 이 기능을 구현하려면 애플리케이션에서 +`ondragstart` 이벤트가 발생했을 때 `webContents.startDrag(item)` API를 호출해야 +합니다: + +웹 페이지에서: + +```html +item + +``` + +메인 프로세스에서: + +```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