xref: /aoo41x/main/oovbaapi/ooo/vba/excel/SheetObject.idl (revision 6fbb7301)

/**************************************************************
 *
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 *
 *************************************************************/



#ifndef __ooo_vba_excel_SheetObject_idl__
#define __ooo_vba_excel_SheetObject_idl__

#include <ooo/vba/excel/XCharacters.idl>

//=============================================================================

/*  Note: This file collects all compatibility interfaces for drawing objects
    and drawing controls embedded in sheets. All these symbols are deprecated
    in VBA and kept for compatibility with old VBA scripts. */

//=============================================================================

module ooo {  module vba { module excel {

//=============================================================================

/** Base interface for graphic objects and drawing controls in a single sheet.

    <p>The objects supporting this interface are now deprecated in VBA in
    favour of the Shapes and OLEObjects collections, but are kept for
    compatibility with old VBA scripts. All form control objects do NOT belong
    to ActiveX form controls but to the old-style drawing controls.</p>
 */
interface XSheetObject : ooo::vba::XHelperInterface
{
    /** Left coordinate of the drawing object, in points. */
    [attribute] double Left;

    /** Top coordinate of the drawing object, in points. */
    [attribute] double Top;

    /** Width of the drawing object, in points. */
    [attribute] double Width;

    /** Height of the drawing object, in points. */
    [attribute] double Height;

    /** The name of the drawing object, used as collection key. */
    [attribute] string Name;

    /** Name of a macro that will be executed when the drawing object is clicked. */
    [attribute] string OnAction;

    /** Anchor mode of the object (fixed or variable position and size). Must
        be a value from <type>ooo::vba::excel::XlPlacement</type>. */
    [attribute] long Placement;

    /** True = print object, false = skip object on printing. */
    [attribute] boolean PrintObject;
};

//=============================================================================

/** Additional attributes for all drawing controls (this interface does not
    belong to ActiveX form controls).
 */
interface XControlObject : com::sun::star::uno::XInterface
{
    [attribute] boolean AutoSize;
};

//=============================================================================

/** Additional attributes for a push button drawing control (this interface
    does not belong to ActiveX form controls).
 */
interface XButton : com::sun::star::uno::XInterface
{
    /** Visible caption of the button. */
    [attribute] string Caption;

    /** Font settings for the entire caption text. */
    [attribute] XFont Font;

    /** Horizontal alignment of the caption. */
    [attribute] long HorizontalAlignment;

    /** Vertical alignment of the caption. */
    [attribute] long VerticalAlignment;

    /** Orientation (rotation) of the text. Must be a value from
        <type>ooo::vba::excel::XlOrientation</type>. */
    [attribute] long Orientation;

    /** Access to text and text formatting of the button caption. */
    XCharacters Characters( [in] any Start, [in] any Length );
};

//=============================================================================

/** Represents a drawing button control in a spreadsheet. */
service Button
{
    interface XSheetObject;
    interface XControlObject;
    interface XButton;
};

//=============================================================================

}; }; };

#endif