/////////////////////////////////////////////////////////////////////////////// 
// Copyright (C) 2002-2025, Open Design Alliance (the "Alliance"). 
// All rights reserved. 
// 
// This software and its documentation and related materials are owned by 
// the Alliance. The software may only be incorporated into application 
// programs owned by members of the Alliance, subject to a signed 
// Membership Agreement and Supplemental Software License Agreement with the
// Alliance. The structure and organization of this software are the valuable  
// trade secrets of the Alliance and its suppliers. The software is also 
// protected by copyright law and international treaty provisions. Application  
// programs incorporating this software must include the following statement 
// with their copyright notices:
//   
//   This application incorporates Open Design Alliance software pursuant to a license 
//   agreement with Open Design Alliance.
//   Open Design Alliance Copyright (C) 2002-2025 by Open Design Alliance. 
//   All rights reserved.
//
// By use of this software, its documentation or related materials, you 
// acknowledge and accept the above terms.
///////////////////////////////////////////////////////////////////////////////

#ifndef _BCF_3_0_USERS_H
#define _BCF_3_0_USERS_H

#include "BcfCommon.h"
#include "OdArray.h"

#include "BcfElement.h"

/** \details
Contains declarations related to working with BCF files content.
*/
namespace OdBcf {

  class OdBcfValidationContext;

}

/** \details
  Contains declarations related to working with data of the BCF format version 3.0.
*/
namespace OdBcf_3_0 {

  class OdBcfSession;

  /** \details 
    A class that implements functionality to store and manage information about users.
  */
  class BCF_3_0_EXPORT OdBcfUsers : public OdBcf::OdBcfElement
  {
  public:

    //DOM-IGNORE-BEGIN
    ODRX_DECLARE_MEMBERS(OdBcfUsers);
    //DOM-IGNORE-END

    /** \details
      Creates a new users object.
      \param user [in] An array of string objects.
      \returns A smart pointer to the created <exref target="../tifc_api_cpp/OdBcf_3_0__OdBcfUsers.html">OdBcfUsers</exref> instance.
    */
    static OdSmartPtr<OdBcfUsers> createObject(const OdArray<OdString> &user);

    /** \details
      Reads XML data into ODA data structures.
      \param pParent [in] A pointer to the parent element of the data structure.
      \returns eOk if data is successfully read; otherwise, the method returns an appropriate error code.
    */
    virtual OdResult inFields(TiXmlElement *pParent) ODRX_OVERRIDE;

    /** \details
      Writes data into XML structures.
      \param pParent [in] A pointer to the parent element of the data structure.
      \returns eOk if data is successfully written; otherwise, the method returns an appropriate error code.
    */
    virtual OdResult outFields(TiXmlElement *pParent) const ODRX_OVERRIDE;

    /** \details
      Retrieves the array of users, which are included in the users object.
      \returns An array of string objects included in the users object.
      \remarks 
      The array of users returned by the method can't be modified in the calling subroutine.
    */
    const OdArray<OdString>& getUser() const;

    /** \details
      Checks whether the array of users, which are included in the users object is not initialized.
      \returns true if the array of users is not initialized; otherwise, the method returns false.
    */
    bool isUserUnset() const;

    //DOM-IGNORE-BEGIN
  protected:
    OdArray<OdString> m_user;

    /** \details
      Retrieves the array of users, which are included in the users object.
      \returns An array of string objects included in the users object.
      \remarks
      The array of users returned by the method can be modified in the calling subroutine.
    */
    OdArray<OdString>& getUser();

    /** \details
      Checks whether the users instance has all required fields initialized.
      \param context [in/out] A raw pointer to the validation context to store results in.
      \returns true if all required fields are initialized; otherwise the method returns false.
    */
    virtual bool validateData(OdBcf::OdBcfValidationContext *context) const ODRX_OVERRIDE;

    friend OdBcfSession;
    //DOM-IGNORE-END
  };

  /** \details 
    A data type that represents a smart pointer to an <exref target="../tifc_api_cpp/OdBcf_3_0__OdBcfUsers.html">OdBcfUsers</exref> object.
  */
  typedef OdSmartPtr<OdBcfUsers> OdBcfUsersPtr;

} //namespace OdBcf_3_0

#endif // _BCF_3_0_USERS_H