NoMatchAction
Field Name
STD_NUM
Description
Detail the behavior of the NoMatchAction property through the STD_NUM field.
Details
NoMatchAction is a property of the PRIM_PKLT component and serves to allow developers to define the behavior for a picklist when a field is set to a value that is not part of its defined picklist. The below examples show the different behaviors for the values of this property.
Field Source ( Behavior with NoMatchAction =Blanks )
Begin_Com Role(*EXTENDS #PRIM_OBJT)
Begin_Com Role(*Visual #PRIM_EVEF) Name(#VisualEdit) Height(19) Usepicklist(False) Width(262)
End_Com
Begin_Com Role(*Visual #PRIM_EVSE) Name(#VisualSpinEdit) Defaultvisual(True) Height(19) Usepicklist(False) Width(262)
End_Com
Begin_Com Role(*picklist) Name(#Picklist) Nomatchaction(Blanks)
Define_Com Class(#PRIM_PKIT) Name(#Item_1) Caption('Item 1') Default(True) Parent(#Picklist) Value(1)
Define_Com Class(#PRIM_PKIT) Name(#Item_2) Caption('Item 2') Parent(#Picklist) Value(2)
Define_Com Class(#PRIM_PKIT) Name(#Item_3) Caption('Item 3') Parent(#Picklist) Value(3)
Define_Com Class(#PRIM_PKIT) Name(#Item_4) Caption('Item 4') Parent(#Picklist) Value(4)
Define_Com Class(#PRIM_PKIT) Name(#Item_5) Caption('Item 5') Parent(#Picklist) Value(5)
End_Com
End_Com
Form Source ( Behavior with NoMatchAction =Blanks )
Function Options(*DIRECT)
Begin_Com Role(*EXTENDS #PRIM_FORM) Clientheight(108) Clientwidth(492) Height(135) Left(357) Top(148)
Define_Com Class(#STD_NUM.Visual) Name(#STD_NUM) Displayposition(1) Left(96) Parent(#COM_OWNER) Tabposition(1) Top(32) Usepicklist(True)
Define_Com Class(#PRIM_PHBN) Name(#PHBN_1) Caption('Set Invalid Value') Displayposition(2) Left(248) Parent(#COM_OWNER) Tabposition(2) Top(72) Width(114)
Evtroutine Handling(#PHBN_1.Click)
* As UsePicklist=TRUE the only allowable values for the STD_NUM field are the values defined in the picklist.
* The value 1234 is not in the Picklist for STD_NUM so 1234 is an invalid value. The NoMatchAction setting will
* then take presedence
Change Field(#STD_NUM) To(1234)
Endroutine
End_Com
Appearance ( Behavior with NoMatchAction =Blanks )
Field Source ( Behavior with NoMatchAction =ShowValue )
Begin_Com Role(*EXTENDS #PRIM_OBJT)
Begin_Com Role(*Visual #PRIM_EVEF) Name(#VisualEdit) Height(19) Usepicklist(False) Width(262)
End_Com
Begin_Com Role(*Visual #PRIM_EVSE) Name(#VisualSpinEdit) Defaultvisual(True) Height(19) Usepicklist(False) Width(262)
End_Com
Begin_Com Role(*picklist) Name(#Picklist) Nomatchaction(ShowValue)
Define_Com Class(#PRIM_PKIT) Name(#Item_1) Caption('Item 1') Default(True) Parent(#Picklist) Value(1)
Define_Com Class(#PRIM_PKIT) Name(#Item_2) Caption('Item 2') Parent(#Picklist) Value(2)
Define_Com Class(#PRIM_PKIT) Name(#Item_3) Caption('Item 3') Parent(#Picklist) Value(3)
Define_Com Class(#PRIM_PKIT) Name(#Item_4) Caption('Item 4') Parent(#Picklist) Value(4)
Define_Com Class(#PRIM_PKIT) Name(#Item_5) Caption('Item 5') Parent(#Picklist) Value(5)
End_Com
End_Com
Form Source ( Behavior with NoMatchAction =ShowValue )
Function Options(*DIRECT)
Begin_Com Role(*EXTENDS #PRIM_FORM) Clientheight(108) Clientwidth(492) Height(135) Left(357) Top(148)
Define_Com Class(#STD_NUM.Visual) Name(#STD_NUM) Displayposition(1) Left(96) Parent(#COM_OWNER) Tabposition(1) Top(32) Usepicklist(True)
Define_Com Class(#PRIM_PHBN) Name(#PHBN_1) Caption('Set Invalid Value') Displayposition(2) Left(248) Parent(#COM_OWNER) Tabposition(2) Top(72) Width(114)
Evtroutine Handling(#PHBN_1.Click)
* As UsePicklist=TRUE the only allowable values for the STD_NUM field are the values defined in the picklist.
* The value 1234 is not in the Picklist for STD_NUM so 1234 is an invalid value. The NoMatchAction setting will
* then take presedence
Change Field(#STD_NUM) To(1234)
Endroutine
End_Com
Appearance ( Behavior with NoMatchAction =ShowValue )
Field Source ( Behavior with NoMatchAction =DefaultItem )
Begin_Com Role(*EXTENDS #PRIM_OBJT)
Begin_Com Role(*Visual #PRIM_EVEF) Name(#VisualEdit) Height(19) Usepicklist(False) Width(262)
End_Com
Begin_Com Role(*Visual #PRIM_EVSE) Name(#VisualSpinEdit) Defaultvisual(True) Height(19) Usepicklist(False) Width(262)
End_Com
Begin_Com Role(*picklist) Name(#Picklist)
Define_Com Class(#PRIM_PKIT) Name(#Item_1) Caption('Item 1') Default(True) Parent(#Picklist) Value(1)
Define_Com Class(#PRIM_PKIT) Name(#Item_2) Caption('Item 2') Parent(#Picklist) Value(2)
Define_Com Class(#PRIM_PKIT) Name(#Item_3) Caption('Item 3') Parent(#Picklist) Value(3)
Define_Com Class(#PRIM_PKIT) Name(#Item_4) Caption('Item 4') Parent(#Picklist) Value(4)
Define_Com Class(#PRIM_PKIT) Name(#Item_5) Caption('Item 5') Parent(#Picklist) Value(5)
End_Com
End_Com
Form Source ( Behavior with NoMatchAction = DefaultItem)
Function Options(*DIRECT)
Begin_Com Role(*EXTENDS #PRIM_FORM) Clientheight(108) Clientwidth(492) Height(135) Left(357) Top(148)
Define_Com Class(#STD_NUM.Visual) Name(#STD_NUM) Displayposition(1) Left(96) Parent(#COM_OWNER) Tabposition(1) Top(32) Usepicklist(True)
Define_Com Class(#PRIM_PHBN) Name(#PHBN_1) Caption('Set Invalid Value') Displayposition(2) Left(248) Parent(#COM_OWNER) Tabposition(2) Top(72) Width(114)
Evtroutine Handling(#PHBN_1.Click)
* As UsePicklist=TRUE the only allowable values for the STD_NUM field are the values defined in the picklist.
* The value 1234 is not in the Picklist for STD_NUM so 1234 is an invalid value. The NoMatchAction setting will
* then take presedence
Change Field(#STD_NUM) To(1234)
Endroutine
End_Com
Appearance ( Behavior with NoMatchAction = DefaultItem)
Note: The NoMatchAction property only has meaning when UsePicklist=TRUE.