[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
  [Expand]Map Control
   [Expand]Product Information
    Product Structure
    Getting Started
   [Expand]Spreadsheet Document
    Supported Formats
   [Expand]Cell Basics
    Defined Names
    Data Binding
    Data Validation
   [Expand]Data Presentation
    Data Grouping
   [Expand]Pivot Tables
   [Expand]Charts and Graphics
   [Expand]Mail Merge
    Operation Restrictions
    Find and Replace
   [Collapse]Visual Elements
     Name Box
     Pop-Up Menus
      Format Cells Dialog
      Paste Special Dialog
      Edit Hyperlink Dialog
      Symbol Dialog
      Create Table Dialog
      Change Chart Type Dialog
      Find and Replace Dialog
      Encrypt Document Dialog
      Password Dialog
      Protect Workbook Dialog
      Protect Sheet Dialog
      User Permissions Dialog
      Insert Function Dialog
      Function Arguments Dialog
      Name Manager
      New Name Dialog
      Create Names from Selection Dialog
      Subtotal Dialog
      Data Validation Dialog
      Properties Dialog
      Page Setup Dialog
      Header and Footer Dialog
      Create PivotTable Dialog
      Move PivotTable Dialog
      Change PivotTable Data Source Dialog
      PivotTable Field List
      PivotTable Field Settings Dialog
      PivotTable Value Field Settings Dialog
      PivotTable Sort Dialog
      Insert Calculated Field Dialog
      Insert Calculated Item Dialog
      PivotTable Solve Order Dialog
      PivotTable Options Dialog
      New Formatting Rule Dialog
      Conditional Formatting Rules Manager
   [Expand]Keyboard Shortcuts
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Properties Dialog

The Properties dialog allows end-users to view and edit document properties. Document properties are metadata that is stored with the document and contains basic information about a workbook: its title, author, file size, date of creation etc.

The Properies dialog includes the following tabs.

  • General

    Provides general information about a workbook such as the file name, location, size, dates when the document was created or last modified. This tab is blank until an end-user saves a document, after that, the general properties are automatically set by the system and cannot be changed.

  • Summary

    Provides summary information about a document such as title, subject, author, company name, comments, etc. This information can be used later for identifying the document content. To specify one of the summary properties, an end-user should type the required text in the corresponding property field, as shown in the image at the beginning of the article.

  • Statistics

    Contains the automatically updated properties such as dates when the document was created, last modified, accessed or printed. In addition, this tab also displays the name of the user who last saved the document.

  • Custom

    This tab allows end-users to specify additional information about a workbook. To add a custom property, an end-user can select the required name from the list of suggested names, or type a new name in the Name field. In the Type drop-down list, a user can select the data type of the created property, and specify its value in the Value field.

    Checking the Link to content box enables the Source drop-down menu. In this menu, end-users can select the name of the cell or cell range to which the custom property should be linked. The linked custom property is marked with the icon. If the custom property is linked to the named cell range, it gets the value of the range's upper-left cell.

    Clicking the Add button at the top-right corner of the dialog adds the specified property to the collection of custom properties.

To provide end-users with the capability to invoke the Properties dialog, add the Info Ribbon page group to the SpreadsheetControl. For an example on how to create a Ribbon UI, refer to the Getting Started topic.

To edit standard and custom document properties in code, use the IWorkbook.DocumentProperties property. For an example, refer to the How to: Specify Document Properties article.

Is this topic helpful?​​​​​​​