1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/security/manager/ssl/public/nsIASN1Sequence.idl Wed Dec 31 06:09:35 2014 +0100
1.3 @@ -0,0 +1,56 @@
1.4 +/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
1.5 + *
1.6 + * This Source Code Form is subject to the terms of the Mozilla Public
1.7 + * License, v. 2.0. If a copy of the MPL was not distributed with this
1.8 + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
1.9 +
1.10 +#include "nsISupports.idl"
1.11 +#include "nsIASN1Object.idl"
1.12 +
1.13 +interface nsIMutableArray;
1.14 +
1.15 +/**
1.16 + * This represents a sequence of ASN.1 objects,
1.17 + * where ASN.1 is "Abstract Syntax Notation number One".
1.18 + *
1.19 + * Overview of how this ASN1 interface is intended to
1.20 + * work.
1.21 + *
1.22 + * First off, the nsIASN1Sequence is any type in ASN1
1.23 + * that consists of sub-elements (ie SEQUENCE, SET)
1.24 + * nsIASN1Printable Items are all the other types that
1.25 + * can be viewed by themselves without interpreting further.
1.26 + * Examples would include INTEGER, UTF-8 STRING, OID.
1.27 + * These are not intended to directly reflect the numberous
1.28 + * types that exist in ASN1, but merely an interface to ease
1.29 + * producing a tree display the ASN1 structure of any DER
1.30 + * object.
1.31 + *
1.32 + * The additional state information carried in this interface
1.33 + * makes it fit for being used as the data structure
1.34 + * when working with visual reprenstation of ASN.1 objects
1.35 + * in a human user interface, like in a tree widget
1.36 + * where open/close state of nodes must be remembered.
1.37 + */
1.38 +[scriptable, uuid(b6b957e6-1dd1-11b2-89d7-e30624f50b00)]
1.39 +interface nsIASN1Sequence : nsIASN1Object {
1.40 +
1.41 + /**
1.42 + * The array of objects stored in the sequence.
1.43 + */
1.44 + attribute nsIMutableArray ASN1Objects;
1.45 +
1.46 + /**
1.47 + * Whether the node at this position in the ASN.1 data structure
1.48 + * sequence contains sub elements understood by the
1.49 + * application.
1.50 + */
1.51 + attribute boolean isValidContainer;
1.52 +
1.53 + /**
1.54 + * Whether the contained objects should be shown or hidden.
1.55 + * A UI implementation can use this flag to store the current
1.56 + * expansion state when shown in a tree widget.
1.57 + */
1.58 + attribute boolean isExpanded;
1.59 +};
