X# Runtime and VO SDK Reference
X# Runtime and SDK Reference
VO Namespace
DataWindow Class
DataWindow Methods
DataWindow.Activate Method
DataWindow.Append Method
DataWindow.ButtonClick Method
DataWindow.Cancel Method
DataWindow.CanvasErase Method
DataWindow.ChangeFont Method
DataWindow.CheckStatus Method
DataWindow.Clear Method
DataWindow.ClearRelations Method
DataWindow.Close Method
DataWindow.Commit Method
DataWindow.ControlFocusChange Method
DataWindow.Copy Method
DataWindow.Cut Method
DataWindow.DeActivate Method
DataWindow.DeactivateAllOLEObjects Method
DataWindow.Delete Method
DataWindow.DeleteValidated Method
DataWindow.Destroy Method
DataWindow.DisableConditionalControls Method
DataWindow.Dispatch Method
DataWindow.Draw Method
DataWindow.EditChange Method
DataWindow.EnableConditionalControls Method
DataWindow.EnableDragDropClient Method
DataWindow.EnableStatusBar Method
DataWindow.EnableToolTips Method
DataWindow.Error Method
DataWindow.Expose Method
DataWindow.FIELDGET Method
DataWindow.FIELDPUT Method
DataWindow.FocusChange Method
DataWindow.GetAllChildren Method
DataWindow.GoBottom Method
DataWindow.GoTo Method
DataWindow.GoTop Method
DataWindow.HelpRequest Method
DataWindow.Hide Method
DataWindow.HorizontalScroll Method
DataWindow.HorizontalSlide Method
DataWindow.HorizontalSpin Method
DataWindow.InsertObject Method
DataWindow.LineTo Method
DataWindow.ListBoxClick Method
DataWindow.ListBoxSelect Method
DataWindow.MouseButtonDown Method
DataWindow.MoveTo Method
DataWindow.Notify Method
DataWindow.OK Method
DataWindow.OLEInPlaceActivate Method
DataWindow.OLEInPlaceDeactivate Method
DataWindow.PaintBoundingBox Method
DataWindow.Paste Method
DataWindow.PasteSpecial Method
DataWindow.PreValidate Method
DataWindow.QueryClose Method
DataWindow.RegisterConditionalControls Method
DataWindow.RePaint Method
DataWindow.RepaintBoundingBox Method
DataWindow.Resize Method
DataWindow.Seek Method
DataWindow.SetAlignStartSize Method
DataWindow.SetRelation Method
DataWindow.SetSelectiveRelation Method
DataWindow.Show Method
DataWindow.Skip Method
DataWindow.SkipNext Method
DataWindow.SkipPrevious Method
DataWindow.StatusOK Method
DataWindow.TextPrint Method
DataWindow.ToolBarHeightChanged Method
DataWindow.Undo Method
DataWindow.UndoAll Method
DataWindow.UpdateActiveObject Method
DataWindow.Use Method
DataWindow.VerticalScroll Method
DataWindow.VerticalSlide Method
DataWindow.VerticalSpin Method
DataWindow.ViewAs Method
DataWindow.ViewForm Method
DataWindow.ViewTable Method
Click or drag to resize

DataWindow.SetSelectiveRelation Method

X#
Set a selective relation from this window to the child window, or actually from the server of this window to the server of the other window. A selective relation is one that limits operations on the child server to those records that match the relation condition.

Namespace:  VO
Assembly:  VOGUIClasses (in VOGUIClasses.dll) Version: 2.21
Syntax
Copy
 VIRTUAL METHOD SetSelectiveRelation(
	oDWChild,
	uRelation,
	cRelation
) AS USUAL CLIPPER
Request Example View Source

Parameters

oDWChild (Optional)
Type: Usual
The window attached to the child server; which must be a data window linked to a server of compatible type. If omitted, all relations for this server are removed (although the recommended way of doing this is the DataWindow:ClearRelations() method).
uRelation (Optional)
Type: Usual
The relation code block for the server, The name or symbol representing the field from this server; a code block is constructed and macro-compiled or the array of field names or symbols representing the relation for the server. The field names are concatenated with plus signs and formed into a code block which is macro-compiled.
cRelation (Optional)
Type: Usual
When the relation is specified as a code block, a string version of the code block can be provided as well; it is returned by the Relation() method.

Return Value

Type: Usual
TRUE if successful; otherwise, FALSE.
Remarks
Tip Tip
This operation may not be supported, depending on whether the servers used supports relations and are of compatible types.
Examples
The API can take these forms:
X#
Copy
1oDWCustomer:SetSelectiveRelation(oDWOrders, {||_FIELD->CustNo},"CustNo")
2oDWCustomer:SetSelectiveRelation(oDWOrders, #CustNo)
3oDWCustomer:SetSelectiveRelation(oDWOrders, {#LastName,#Initial,#FirstName})
See Also