ArcGIS Pro 3.3 API Reference Guide
ArcGIS.Desktop.Framework.Contracts Namespace / EditBox Class
Members

In This Topic
    EditBox Class
    In This Topic
    Represents a control that can be used to display and edit strings, doubles, or integers. This is an abstract class.
    Syntax
    public abstract class EditBox : PlugIn, System.ComponentModel.INotifyPropertyChanged  
    Public MustInherit Class EditBox 
       Inherits PlugIn
       Implements System.ComponentModel.INotifyPropertyChanged 
    Remarks

    All ribbon control elements share several attributes. The loadOnClick attribute determines when the control should be created by the framework. By default, controls appear enabled, but are not actually instantiated until they are clicked. This simple just-in-time (JIT) strategy improves resource utilization and startup time by deferring the instantiation of controls until they are initiated by the end user. Note that non-visible controls are never loaded until they become visible (or are executed programmatically), regardless of the value assigned to loadOnClick.

    Tooltips are defined using the tooltip sub-element and may span as many lines as necessary. The image attribute is used to supply an image that will appear next to the tip text. Command tooltips also support a disabledText element, this string is additional displayed when the command is disabled.

    Most controls support multiple sizes in the ribbon. For example, a button can render small (small icon only), medium (small icon with text), and large (large icon over text). Use the smallImage and largeImage attributes to specify unique images for the different sizes. Images don’t have to be graphics, you can also use XAML. You can also use overlayLargeImage and overlaySmallImage to draw a graphic or XAML overtop of the corresponding images. If the image should flip when running right-to-left, e.g. arrow buttons, set the flipImageRTL attribute to true.

    The disableIfBusy element is used to signal that the control should be disabled whenever the primary worker thread is busy. This prevents work from queuing up. This element is true by default. Controls that always need to be enabled such as the close application button should set this to false.

    All control declarations support a condition attribute allowing the assignment of a condition. If the specified condition isn’t met, the control will be automatically disabled by the framework. In addition, controls remain unloaded until their is met. If no condition is specified, the control is assumed to be always relevant.

    EditBoxes can present strings, doubles, or integers; use the format attribute to specify the type. With the double format, you can additionally use the format attribute to specify how the double should be formatted. For example, use 'C' to present a currency or F4 for a double with 4 decimals.

    Declaring EditBoxes in DAML:

                <editBox id="acme_filterEditBox" 
                         caption="Filter Text:" 
                         className="FilterDomainsEditBox" 
                         disableIfBusy="false" 
                         sizeString="1234567890123456789012" 
                         condition="esri_mapping_domainsPane">
                  <tooltip heading="">Type filter text.
                    <disabledText></disabledText>
                  </tooltip>
                </editBox>
                

    DAML attributes
    id Required identifier.
    caption The heading.
    extendedCaption A more descriptive title.
    sizeString The control sizes to accommodate the sizeString.
    dataType The type of data the edit box hosts: string, double, or integer.
    editHint The text to display when the edit box is empty for string data type.
    format The double format string, e.g. 'C' for currency and F4 for 4 decimals. Default is F2.
    smallImage Image (16x16) used when button is small and middle size.
    categoryRefID Adds control to a specific component category.
    condition Automatically disable the button if the condition is not satisfied.
    disableIfBusy Automatically disable the button if the application is busy. Default true.
    helpContextID The help topic to show.
    className Required class identifier. Optionally include namespace if not in default namespace.
    assembly Assembly name if not in the default assembly.
    publicKeyToken The necessary public key token if the assembly is strongly named.
    version The version of the dll if the assembly is strongly named.

    DAML Child Elements
    tooltip Description of the control.
    content Optional custom XML data when registered in a component category.
    Inheritance Hierarchy

    System.Object
       ArcGIS.Desktop.Framework.Contracts.PropertyChangedBase
          ArcGIS.Desktop.Framework.Contracts.PlugIn
             ArcGIS.Desktop.Framework.Contracts.EditBox

    Requirements

    Target Platforms: Windows 11, Windows 10

    ArcGIS Pro version: 3 or higher.
    See Also