Document Solutions for PDF
DS.Documents.Pdf Assembly / GrapeCity.Documents.Pdf.Annotations Namespace / WidgetAnnotation Class
Properties Methods

In This Topic
    WidgetAnnotation Class Members
    In This Topic

    The following tables list the members exposed by WidgetAnnotation.

    Public Constructors
     NameDescription
    Public ConstructorWidgetAnnotation ConstructorOverloaded.   
    Top
    Public Properties
     NameDescription
    Public PropertyActivateGets or sets an action to be performed when the annotation is activated.  
    Public PropertyActualJustificationGets the actual justification to be used in displaying the annotation’s text.  
    Public PropertyAppearanceStateGets or sets the annotation’s appearance state, which selects the applicable appearance stream from an appearance sub-dictionary. Note! If you change this property then GcPdf will NOT automatically generates appearance content streams in AppearanceStreams. See PDF specification for more details. (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Public PropertyAppearanceStreamsGets the AppearanceStreams object that allows defining this annotation's appearance streams. (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Public PropertyAssociatedFilesGets the list of embedded files associated with this AnnotationBase. (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Public PropertyBackColorGets or sets the annotation's background color.  
    Public PropertyBorder  
    Public PropertyButtonAppearanceGets the ButtonAppearance object that specifies the look of the widget if it is linked with a push button field.  
    Public PropertyCheckStyleGets or sets the style of check mark that is used if this WidgetAnnotation is linked with a GrapeCity.Documents.Pdf.AcroForms.CheckBoxField or a GrapeCity.Documents.Pdf.AcroForms.RadioButtonField.

    Note that this property works over the ButtonAppearance.Caption property, for example if CheckStyle is CheckStyle.Cross, then ButtonAppearance.Caption will be "8".

    If the value of this property is null, it indicates that ButtonAppearance.Caption contains an unknown value.  
    Public PropertyContentsGets or sets the text to be displayed for the annotation or, if this type of annotation does not display text, an alternate description of the annotation’s contents in human-readable form. In either case, this text is useful when extracting the document’s contents in support of accessibility to users with disabilities or for other purposes. (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Public PropertyDefaultAppearanceGets the DefaultAppearance object that specifies the visual properties (font, font size etc.) used to format the content of this annotation.  
    Public PropertyDocGets the GrapeCity.Documents.Pdf.GcPdfDocument owning this annotation. (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Public PropertyEventsGets the WidgetAnnotation.TriggerEvents object that specifies the events for this annotation.  
    Public PropertyFieldGets the GrapeCity.Documents.Pdf.AcroForms.Field associated with this annotation.  
    Public PropertyFlagsGets or sets the flags specifying various characteristics of the annotation. (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Public PropertyHighlightingGets or sets the annotation’s highlighting mode.  
    Public PropertyJustificationGets or sets the justification to be used in displaying the annotation’s text.

    Note that if this property is not specified (the value is null) then GrapeCity.Documents.Pdf.AcroForms.Field.Justification is used. See PDF specification for details.

     
    Public PropertyLayerGets or sets an object that specifies the layer to which this annotation belongs.

    This can be either an GrapeCity.Documents.Pdf.Layers.OptionalContentGroup or an GrapeCity.Documents.Pdf.Layers.OptionalContentMembership.

    (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Public PropertyLockedGets or sets a value indicating whether the annotation can be deleted or its properties (including position and size) can be modified by the user. However, this flag does not restrict changes to the annotation’s contents, such as the value of a form field. (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Public PropertyLockedContentsGets or sets a value indicating whether the contents of the annotation can be modified by the user. This flag does not restrict deletion of the annotation or changes to other annotation properties, such as position and size. (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Public PropertyModifiedDateGets or sets the date and time when the annotation was modified. (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Public PropertyNameGets or sets the name of the annotation. If WidgetAnnotation is used with GrapeCity.Documents.Pdf.AcroForms.RadioButtonField then Name is used as a value.  
    Public PropertyObjIDGets the PDF object ID. (Inherited from GrapeCity.Documents.Pdf.Wrappers.PdfWrapperBase)
    Public PropertyPageGets or sets the GrapeCity.Documents.Pdf.Page that contains this annotation.

    Note that an annotation may be referenced by several pages. In that case this property returns the first element in the Pages collection.

    When setting this property, the following applies:

    • If the new value is null, this annotation is removed from all pages.
    • Otherwise, this annotation is assigned exclusively to the specified page.

    (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Public PropertyPagesGets the list of pages that reference this annotation. (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Public PropertyPdfDictGets the underlying GrapeCity.Documents.Pdf.Spec.IPdfDict. (Inherited from GrapeCity.Documents.Pdf.Wrappers.PdfDictWrapper)
    Public PropertyPdfObjectGets the underlying GrapeCity.Documents.Pdf.Spec.IPdfObject. (Inherited from GrapeCity.Documents.Pdf.Wrappers.PdfWrapper<IPdfDict>)
    Public PropertyPdfRectGets or sets the rectangle that defines the location and size of the annotation on a page in PDF user space coordinates. The positive X axis extends horizontally to the right, and the positive Y axis extends vertically upward, with the origin usually in the lower left corner of the page. (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Public PropertyRectGets or sets the rectangle that defines the location and size of the annotation on a page. The coordinates of the rectangle are relative to the upper left corner of the page's media box, with the Y (vertical) coordinates increasing from top to bottom.

    Note that if the annotation is associated with more than one page, the media box of the first of those pages is used to calculate the rectangle's location.

    (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Public PropertyRotationAngleGets or sets the angle, in degrees, by which the widget annotation is rotated counterclockwise relative to the page. The value must be a multiple of 90.  
    Public PropertyUserDataGets or sets arbitrary data associated with the current annotation.

    Note that this data is runtime only and is not persisted in the PDF.

    (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Top
    Public Methods
     NameDescription
    Public MethodCreateAppearanceContentStreamCreates an instance of GrapeCity.Documents.Pdf.Graphics.FormXObject that can be used to define the annotation's appearance stream.

    Note that when this method is called, the annotation must already have been added to the document, otherwise an exception will be thrown.

    (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Public MethodDisableAppearanceGenerationDisables generation of appearance steams for this annotation when the document is saved.

    Note that if any property affecting the annotation's appearance (such as Rect) is then changed, the appearance streams will be regenerated. So this method would usually be called after initializing all annotation's properties.

    (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Public MethodGetPdfStreamGets the System.IO.Stream object containing the data of GrapeCity.Documents.Pdf.Spec.PdfStreamObjectBase owned by this wrapper. Note! The stream should be disposed after usage. (Inherited from GrapeCity.Documents.Pdf.Wrappers.PdfWrapperBase)
    Public MethodGetPdfStreamDataGets the data of GrapeCity.Documents.Pdf.Spec.PdfStreamObjectBase owned by this wrapper. (Inherited from GrapeCity.Documents.Pdf.Wrappers.PdfWrapperBase)
    Public MethodGetPdfStreamInfoGets the GrapeCity.Documents.Pdf.Spec.PdfStreamInfo object containing the data of GrapeCity.Documents.Pdf.Spec.PdfStreamObjectBase owned by this wrapper. Note! The stream should be disposed after usage. (Inherited from GrapeCity.Documents.Pdf.Wrappers.PdfWrapperBase)
    Public MethodRemoveAppearanceRemoves all appearance streams associated with the current annotation, and disables generation of appearance steams for this annotation when the document is saved.

    Note that if any property affecting the annotation's appearance (such as Rect) is then changed, the appearance streams will be regenerated. So this method would usually be called after initializing all annotation's properties.

    (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Public MethodResetAppearanceForces regeneration of the annotation's appearance streams next time the document is saved. (Inherited from GrapeCity.Documents.Pdf.Annotations.AnnotationBase)
    Top
    See Also

    Reference

    WidgetAnnotation Class
    GrapeCity.Documents.Pdf.Annotations Namespace