naiveproxy/components/arc/common/clipboard.mojom
2018-08-11 05:35:24 +00:00

68 lines
2.1 KiB
Plaintext

// Copyright 2016 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
// Next MinVersion: 4
module arc.mojom;
// |ClipData| contains one or more |ClipRepresentation| objects. Each
// |ClipRepresentation| has a |mime_type| and a |ClipValue|. |ClipValue| is
// either a |blob| or a |text|.
// Value for |ClipRepresentation|.
// Next ID: 2
union ClipValue {
// For images and other opaque structures.
array<uint8> blob@0;
// For html, text and other text-based representations.
string text@1;
};
// One possible representation of the |ClipData|: |mime_type| + its |value|.
// Next ID: 2
struct ClipRepresentation {
// The mime type.
string mime_type@0;
// And its value.
ClipValue value@1;
};
// The |ClipData| to transfer.
// Next ID: 1
struct ClipData {
// A |ClipData| could have multiple representations.
// Example: an image could be represented by an image/png and a text/html
array<ClipRepresentation> representations@0;
};
// Next method ID: 5
// Deprecated method IDs: 0, 1, 3
interface ClipboardHost {
// Tells the host to update its clipboard content, usually when the user
// initiates a 'copy' action.
[MinVersion=1] SetClipContent@2(ClipData data);
// DEPRECATED: Please use GetClipContent@4 instead. Clean up after Aug 1 2018.
// This version of ClipboardInstance can't handle a ClipData larger than 800K.
[MinVersion=1] GetClipContentDeprecated@3() => (ClipData data);
// Tells the host to return its clipboard content, usually when the user
// initiates a 'paste' action or when the instance needs to re-sync its
// clipboard content with the host.
[MinVersion=3] GetClipContent@4() => (ClipData data);
};
// Next method ID: 4
// Deprecated method IDs: 1
interface ClipboardInstance {
// DEPRECATED: Please use Init@3 instead.
InitDeprecated@0(ClipboardHost host_ptr);
// Establishes full-duplex communication with the host.
[MinVersion=2] Init@3(ClipboardHost host_ptr) => ();
// Tells that the Host clipboard has been updated.
[MinVersion=1] OnHostClipboardUpdated@2();
};