Interface StandardControl

Interface for a standard control.

Index

Methods

addNotification addOnOutputChange clearNotification getAttribute getControlType getDisabled getLabel getName getOutputs getParent getVisible removeOnOutputChange setDisabled setFocus setLabel setNotification setVisible

Methods

addNotification

addNotification(notification): void
Displays an error or recommendation notification for a control, and lets you specify actions to execute based on the notification.
Parameters
- notification: Xrm.Controls.AddControlNotificationOptions
Returns void
Inherited from StandardControl.addNotification
- Defined in node_modules/@types/xrm/index.d.ts:3340

addOnOutputChange

addOnOutputChange(handler): void
Adds an event handler to the OnOutputChange event.
Parameters
- handler: Xrm.Events.ContextSensitiveHandler
  
  The function to add to the OnOutputChange event.
Returns void
Inherited from StandardControl.addOnOutputChange
- Defined in node_modules/@types/xrm/index.d.ts:3346

clearNotification

clearNotification(uniqueId?): boolean
Clears the notification identified by uniqueId.
Parameters
- Optional uniqueId: string
  
  (Optional) Unique identifier.
Returns boolean
true if it succeeds, false if it fails.

Remarks
If the uniqueId parameter is not used, the current notification shown will be removed.
Inherited from StandardControl.clearNotification
- Defined in node_modules/@types/xrm/index.d.ts:3325

getAttribute

getAttribute<T>(): T
Gets the control's bound attribute.
Type Parameters
- T extends Xrm.Attributes.Attribute<any>
  
  An Attribute type.
Returns T
The attribute.
Inherited from StandardControl.getAttribute
- Defined in node_modules/@types/xrm/index.d.ts:3366
getAttribute(): Xrm.Attributes.Attribute<any>
Gets the control's bound attribute.

Returns Xrm.Attributes.Attribute<any>
The attribute.
Inherited from StandardControl.getAttribute
- Defined in node_modules/@types/xrm/index.d.ts:3372

getControlType

getControlType(): string
Gets the controls type.

Returns string
The control type.

Values returned are:
- standard
- iframe
- lookup
- optionset
- subgrid
- webresource
- notes
- timercontrol
- kbsearch
- quickform (see ui.QuickForm)
- customcontrol: . (A custom control for mobile phone and tablet clients).
- customsubgrid: . (A custom dataset control for mobile phone and tablet clients).
Inherited from StandardControl.getControlType
- Defined in node_modules/@types/xrm/index.d.ts:3262

getDisabled

getDisabled(): boolean
Gets a boolean value, indicating whether the control is disabled.

Returns boolean
true if it is disabled, otherwise false.
Inherited from StandardControl.getDisabled
- Defined in node_modules/@types/xrm/index.d.ts:3062

getLabel

getLabel(): string
Gets the label.

Returns string
The label.
Inherited from StandardControl.getLabel
- Defined in node_modules/@types/xrm/index.d.ts:3045

getName

getName(): string
Gets the name of the control on the form.

Returns string
The name of the control.

Remarks
The name assigned to a control is not determined until the form loads. Changes to the form may change the name assigned to a given control. When you use the control getName method the name of the first control will be the same as the name of the attribute. The second instance of a control for that attribute will be "1". The pattern +N will continue for each additional control added to the form for a specific attribute. When a form displays a business process flow control in the header, additional controls will be added for each attribute that is displayed in the business process flow. These controls have a unique name like the following: header_process_.
Inherited from StandardControl.getName
- Defined in node_modules/@types/xrm/index.d.ts:3278

getOutputs

getOutputs(): {
[index: string]: FieldControlOutput;
}
Returns a dictionary of the output properties of the control.

Returns {
[index: string]: FieldControlOutput;
}
A dictionary for the output parameters from the control. For a PCF control this is of the pattern .fieldControl., e.g. telephone1.fieldControl.isValid
- [index: string]: FieldControlOutput
Inherited from StandardControl.getOutputs
- Defined in node_modules/@types/xrm/index.d.ts:3359

getParent

getParent(): Xrm.Controls.Section
Gets a reference to the Section parent of the control.

Returns Xrm.Controls.Section
The parent Section.
Inherited from StandardControl.getParent
- Defined in node_modules/@types/xrm/index.d.ts:3284

getVisible

getVisible(): boolean
Gets the visibility state.

Returns boolean
true if the tab is visible, otherwise false.
Inherited from StandardControl.getVisible
- Defined in node_modules/@types/xrm/index.d.ts:3100

removeOnOutputChange

removeOnOutputChange(handler): void
Removes an event handler from the OnOutputChange event.
Parameters
- handler: Xrm.Events.ContextSensitiveHandler
  
  The function to remove from the OnOutputChange event.
Returns void
Inherited from StandardControl.removeOnOutputChange
- Defined in node_modules/@types/xrm/index.d.ts:3352

setDisabled

setDisabled(disabled): void
Sets the state of the control to either enabled, or disabled.
Parameters
- disabled: boolean
  
  true to disable, false to enable.
Returns void
Inherited from StandardControl.setDisabled
- Defined in node_modules/@types/xrm/index.d.ts:3073

setFocus

setFocus(): void
Sets focus on the element.

Returns void
Inherited from StandardControl.setFocus
- Defined in node_modules/@types/xrm/index.d.ts:3132

setLabel

setLabel(label): void
Sets the label.
Parameters
- label: string
  
  The label.
Returns void
Inherited from StandardControl.setLabel
- Defined in node_modules/@types/xrm/index.d.ts:3051

setNotification

setNotification(message, uniqueId): boolean
Sets a control-local notification message.
Parameters
- message: string
  
  The message.
- uniqueId: string
  
  Unique identifier.
Returns boolean
true if it succeeds, false if it fails.

Remarks
When this method is used on Microsoft Dynamics CRM for tablets a red "X" icon appears next to the control. Tapping on the icon will display the message.
Inherited from StandardControl.setNotification
- Defined in node_modules/@types/xrm/index.d.ts:3335

setVisible

setVisible(visible): void
Sets the visibility state.
Parameters
- visible: boolean
  
  true to show, false to hide.
Returns void
Inherited from StandardControl.setVisible
- Defined in node_modules/@types/xrm/index.d.ts:3122

Interface StandardControl

See

Deprecated

Hierarchy

Index

Methods

Methods

addNotification

Parameters

notification: Xrm.Controls.AddControlNotificationOptions

Returns void

addOnOutputChange

Parameters

handler: Xrm.Events.ContextSensitiveHandler

Returns void

clearNotification

Parameters

Optional uniqueId: string

Returns boolean

Remarks

getAttribute

Type Parameters

T extends Xrm.Attributes.Attribute<any>

Returns T

Returns Xrm.Attributes.Attribute<any>

getControlType

Returns string

getDisabled

Returns boolean

getLabel

Returns string

getName

Returns string

Remarks

getOutputs

Returns { [index: string]: FieldControlOutput; }

[index: string]: FieldControlOutput

getParent

Returns Xrm.Controls.Section

getVisible

Returns boolean

removeOnOutputChange

Parameters

handler: Xrm.Events.ContextSensitiveHandler

Returns void

setDisabled

Parameters

disabled: boolean

Returns void

setFocus

Returns void

setLabel

Parameters

label: string

Returns void

setNotification

Parameters

message: string

uniqueId: string

Returns boolean

Remarks

setVisible

Parameters

visible: boolean

Returns void

Settings

Member Visibility

Theme

On This Page

`Optional` uniqueId: string

Returns {
[index: string]: FieldControlOutput;
}