Reference Guide
GdPicture14.WPF Namespace / GdViewer Class / SetRegionBorderWidth Method
A unique region identifier of the specified region. You can obtain this identifier using the GetRegionID method or when creating regions using the AddRegion(String,Double,Double,Double,Double,Color,RegionFillMode) method.
The new border width, in inches, of the specified region.
Example





In This Topic
    SetRegionBorderWidth Method (GdViewer)
    In This Topic
    Sets the border width, in inches, of a highlighted region specified by its unique identifier related to the document currently displayed in the GdViewer control. These regions, if present, determines the currently defined highlighted regions on the displayed document.

    You can determine the border width of the region's rectangle using the GetRegionBorderWidth method.

    Syntax
    'Declaration
     
    
    Public Function SetRegionBorderWidth( _
       ByVal RegionID As Integer, _
       ByVal BorderWidth As Double _
    ) As GdPictureStatus
    public GdPictureStatus SetRegionBorderWidth( 
       int RegionID,
       double BorderWidth
    )
    public function SetRegionBorderWidth( 
        RegionID: Integer;
        BorderWidth: Double
    ): GdPictureStatus; 
    public function SetRegionBorderWidth( 
       RegionID : int,
       BorderWidth : double
    ) : GdPictureStatus;
    public: GdPictureStatus SetRegionBorderWidth( 
       int RegionID,
       double BorderWidth
    ) 
    public:
    GdPictureStatus SetRegionBorderWidth( 
       int RegionID,
       double BorderWidth
    ) 

    Parameters

    RegionID
    A unique region identifier of the specified region. You can obtain this identifier using the GetRegionID method or when creating regions using the AddRegion(String,Double,Double,Double,Double,Color,RegionFillMode) method.
    BorderWidth
    The new border width, in inches, of the specified region.

    Return Value

    A member of the GdPictureStatus enumeration. If the method has been successfully followed, then the return value is GdPictureStatus.OK. We strongly recommend always checking this status first.
    Remarks
    Be aware that if the required region does not exist, the method will fail.

    Just to inform you, that the default border width set by the toolkit is 0.

    Example
    How to set the border width for all defined highlighted regions.
    'We assume that the GdViewer1 control has been properly integrated and your document has been properly displayed as well.
                
    'To successfully follow this example, please use the code snippet attached to the AddRegion method to define highlighted regions
    'or define some highlighted regions using SearchText methods by yourself.
    Dim regID As Integer = 0, regCount As Integer = GdViewer1.RegionCount()
    If regCount > 0 Then
        For j As Integer = 0 To regCount-1
            regID = GdViewer1.GetRegionID(j)
            GdViewer1.SetRegionBorderWidth(regID, GdViewer1.GetRegionBorderWidth(regID) + 2)
            GdViewer1.SetRegionBorderColor(regID, Color.FromArgb(255, 0, 190, 255))
        Next
        'Redrawing regions with the newly defined color.
        GdViewer1.Redraw()
    Else
        MessageBox.Show("No highlighted region found related to this document. Status: " + GdViewer1.GetStat().ToString(), "GdViewer.SetRegionBorderWidth")
    End If
    //We assume that the GdViewer1 control has been properly integrated and your document has been properly displayed as well.
                
    //To successfully follow this example, please use the code snippet attached to the AddRegion method to define highlighted regions
    //or define some highlighted regions using SearchText methods by yourself.
    int regID = 0, regCount = GdViewer1.RegionCount();
    if (regCount > 0)
    {
        for (int j = 1; j <= regCount; j++)
        {
            regID = GdViewer1.GetRegionID(j);
            GdViewer1.SetRegionBorderWidth(regID, GdViewer1.GetRegionBorderWidth(regID) + 2);
            GdViewer1.SetRegionBorderColor(regID, Color.FromArgb(255, 0, 190, 255));
        }
        //Redrawing regions with the newly defined color.
        GdViewer1.Redraw();
    }
    else
        MessageBox.Show("No highlighted region found related to this document. Status: " + GdViewer1.GetStat().ToString(), "GdViewer.SetRegionBorderWidth");
    See Also