Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 9 additions & 10 deletions Xamarin-iOS/SfCheckBox/Event.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,20 @@
---
layout: post
title: Event in SfCheckBox for Xamarin.iOS platform
description: Learn how to customize the basic features of SfCheckBox
platform: Xamarin.iOS
title: Event in Syncfusion® SfCheckBox for Xamarin.iOS
description: Learn how to handle and customize events in SfCheckBox including state change, click, and validation event handling
platform: xamarin.ios
control: SfCheckBox
documentation: ug
keywords: button, SfCheckBox, CheckBox

---

# Event
# Events

## StateChanged event
Occurs when the value(state) of the `IsChecked` property is changed by either touching the check box or setting the value to the `IsChecked` property using C# code. The event arguments are of type `StateChangedEventArgs` and expose the following property:
The `StateChanged` event occurs when the value (state) of the `IsChecked` property is changed by either touching the checkbox or setting the value to the `IsChecked` property using C# code. The event arguments are of type `StateChangedEventArgs` and expose the following property:

* `IsChecked`: The new value(state) of the `IsChecked` property.
* `IsChecked`: The new value (state) of the `IsChecked` property.

{% tabs %}
{% highlight c# %}
Expand Down Expand Up @@ -42,8 +42,7 @@ private void CheckBox_StateChanged(object sender, StateChangedEventArgs e)
{% endhighlight %}
{% endtabs %}

![](Images/Event1.png)
![](Images/Event2.png)
![](Images/Event3.png)

![StateChanged event - Unchecked state](Images/Event1.png)
![StateChanged event - Checked state](Images/Event2.png)
![StateChanged event - Indeterminate state](Images/Event3.png)
This demo can be downloaded from this [link](http://files2.syncfusion.com/Xamarin.iOS/Samples/CheckBox_Event.zip).
37 changes: 19 additions & 18 deletions Xamarin-iOS/SfCheckBox/Getting-Started.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,11 @@ keywords: button, SfCheckBox, CheckBox

---

# Getting Started Xamarin.iOS Checkbox (SfCheckbox)
This section explains the steps required to configure the `SfCheckBox` control in a real-time scenario and provides a walk-through on some of the customization features available in `SfCheckBox` control.
# Getting Started with Xamarin.iOS CheckBox (SfCheckBox)
This section explains the steps required to configure the `SfCheckBox` control in a real-time scenario and provides a walk-through on some of the customization features available in the `SfCheckBox` control.

## Add SfCheckBox reference
Syncfusion® Xamarin components are available in [nuget.org](https://www.nuget.org/). To add checkbox to your project, open the NuGet package manager in Visual Studio, and search for "[syncfusion.xamarin.buttons.ios](https://www.nuget.org/packages/Syncfusion.Xamarin.Buttons.IOS)", and then install it.
Syncfusion® Xamarin components are available in [nuget.org](https://www.nuget.org/). To add CheckBox to your project, open the NuGet package manager in Visual Studio, and search for "[syncfusion.xamarin.buttons.ios](https://www.nuget.org/packages/Syncfusion.Xamarin.Buttons.IOS)", and then install it.

![Xamarin.iOS CheckBox NuGet](Images/nuget.png)

Expand All @@ -22,15 +22,15 @@ N>Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial s
## Create a Simple SfCheckBox
The `SfCheckBox` control is configured entirely in C# code. The following steps explain how to create a `SfCheckBox` and configure its elements:

### Add namespace for referred assemblies
### Add namespace for referenced assemblies

{% tabs %}
{% highlight c# %}
using Syncfusion.iOS.Buttons;
{% endhighlight %}
{% endtabs %}

### Refer SfCheckBox control with declared suffix name for Namespace
### Reference SfCheckBox control with declared suffix name for Namespace

{% tabs %}
{% highlight c# %}
Expand Down Expand Up @@ -66,7 +66,7 @@ namespace CheckBox_Sample
{% endtabs %}

## Setting caption
The check box caption can be defined using the `SetTitle` method of `SfCheckBox`. This caption normally describes the meaning of the check box and it displays next to check box.
The CheckBox caption can be defined using the `SetTitle` method of `SfCheckBox`. This caption normally describes the meaning of the CheckBox and displays next to the CheckBox.

{% tabs %}
{% highlight c# %}
Expand All @@ -78,7 +78,8 @@ checkBox.SetTitle("CheckBox",UIControlState.Normal);

![Xamarin.iOS CheckBox caption text](Images/Caption.png)

## Change the check box state
## Change the CheckBox state

The three visual states of `SfCheckBox` are:

* Checked
Expand All @@ -87,7 +88,7 @@ The three visual states of `SfCheckBox` are:

![Xamarin.iOS CheckBox visual states](Images/States.png)

You can change the state of the check box using the `IsChecked` property of `SfCheckBox`. In checked state, a tick mark is added to the visualization of check box.
You can change the state of the CheckBox using the `IsChecked` property of `SfCheckBox`. In the checked state, a tick mark is added to the visualization of the CheckBox.

<table>
<tr>
Expand All @@ -103,7 +104,7 @@ You can change the state of the check box using the `IsChecked` property of `SfC
</tr>
<tr>
<td>
checked
Checked
</td>
<td>
IsChecked
Expand All @@ -114,7 +115,7 @@ true
</tr>
<tr>
<td>
unchecked
Unchecked
</td>
<td>
IsChecked
Expand All @@ -125,7 +126,7 @@ false
</tr>
<tr>
<td>
indeterminate
Indeterminate
</td>
<td>
IsChecked
Expand All @@ -136,9 +137,9 @@ null
</tr>
</table>

N>For the check box, to report the indeterminate state, set the `IsThreeState` property to true.
N>For the CheckBox to report the indeterminate state, set the `IsThreeState` property to true.

Check box can be used as a single or as a group. A single check box mostly used for a binary yes/no choice, such as "Remember me?", login scenario, or a terms of service agreement.
CheckBox can be used as a single control or as a group. A single CheckBox is mostly used for a binary yes/no choice, such as "Remember me?", login scenario, or a terms of service agreement.

{% tabs %}
{% highlight c# %}
Expand All @@ -150,7 +151,7 @@ checkBox.IsChecked = true;

![Xamarin.iOS CheckBox tri-state](Images/Agree.png)

Multiple check boxes can be used as a group for multi-select scenarios in which a user chooses one or more items from the group of choices that are not mutually exclusive.
Multiple CheckBoxes can be used as a group for multi-select scenarios in which a user chooses one or more items from the group of choices that are not mutually exclusive.

{% tabs %}
{% highlight c# %}
Expand All @@ -174,11 +175,11 @@ onion.IsChecked = true;

## Indeterminate

The `SfCheckBox` allows an indeterminate state in addition to the checked and unchecked state. The indeterminate state of the check box is enabled by setting the `IsThreeState` property of the control to `True`.
The `SfCheckBox` allows an indeterminate state in addition to the checked and unchecked states. The indeterminate state of the CheckBox is enabled by setting the `IsThreeState` property of the control to `true`.

N>When the `IsThreeState` property is set to `False` and `IsChecked` property is set to `null`, then the check box will be in unchecked state.
N>When the `IsThreeState` property is set to `false` and the `IsChecked` property is set to `null`, then the CheckBox will be in the unchecked state.

The indeterminate state is used when a group of sub-choices has both checked and unchecked states. In the following example, the "Select all" checkbox has the `IsThreeState` property set to `true`. The "Select all" checkbox is checked if all child elements are checked, unchecked if all the child elements are unchecked, and indeterminate otherwise.
The indeterminate state is used when a group of sub-choices has both checked and unchecked states. In the following example, the "Select all" CheckBox has the `IsThreeState` property set to `true`. The "Select all" CheckBox is checked if all child elements are checked, unchecked if all the child elements are unchecked, and indeterminate otherwise.

{% tabs %}
{% highlight c# %}
Expand Down Expand Up @@ -242,6 +243,6 @@ private void CheckBox_StateChanged(object sender, StateChangedEventArgs e)
{% endhighlight %}
{% endtabs %}

![Xamarin.iOS CheckBox intermediate state](Images/Inter1.png) ![](Images/Inter2.png)
![Xamarin.iOS CheckBox intermediate state](Images/Inter1.png) ![Xamarin.iOS CheckBox intermediate state](Images/Inter2.png)

This demo can be downloaded from this [link](https://github.com/SyncfusionExamples/GettingStarted-Sample-CheckBox-Xamarin.iOS/).
16 changes: 8 additions & 8 deletions Xamarin-iOS/SfCheckBox/Overview.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,21 @@
---
layout: post
title: Overview in SfCheckBox for Xamarin.iOS platform
description: Learn how to customize the basic features of SfCheckBox
platform: Xamarin.iOS
title: Overview in Syncfusion® SfCheckBox for Xamarin.iOS
description: Learn how to customize the basic features of SfCheckBox including styling, states, and interactive behaviors
platform: xamarin.ios
control: SfCheckBox
documentation: ug
keywords: button, SfCheckBox, CheckBox

---

# Overview
The check box is a selection control that allows users to select one or more options from a set. The three states of check box are checked, unchecked and indeterminate.
The CheckBox is a selection control that allows users to select one or more options from a set. The three states of CheckBox are checked, unchecked, and indeterminate.

## Key features
## Key features

* Supports three states.
* Allow users to select and clear the control by tapping.
* Supports check box color, shape and label text customization.
* Allows users to select and clear the control by tapping.
* Supports CheckBox color, shape, and label text customization.

![](Images/CheckBox_Overview.png)
![SfCheckBox overview for Xamarin.iOS](Images/CheckBox_Overview.png)
19 changes: 10 additions & 9 deletions Xamarin-iOS/SfCheckBox/Visual-Customization.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ keywords: button, SfCheckBox, CheckBox
# Visual Customization

## Customizing shape
The check box shape can be customized using the `CornerRadius` property. This property specifies the uniform radius value for every corner of the check box.
The CheckBox shape can be customized using the `CornerRadius` property. This property specifies the uniform radius value for every corner of the CheckBox.

{% tabs %}
{% highlight c# %}
Expand All @@ -23,10 +23,11 @@ checkBox.CornerRadius = 5.0f;
{% endhighlight %}
{% endtabs %}

![Checkbox CornerRadius](Images/Radius.png)
![CheckBox CornerRadius](Images/Radius.png)

## Customizing state color
The default state colors can be customized using the `CheckedColor` and `UncheckedColor `properties. The checked/indeterminate state color is updated to the `CheckedColor` property value when the state is changed to the checked/indeterminate.The unchecked state color is updated to the `UncheckedColor` property value when the state is changed to unchecked.
The default state colors can be customized using the `CheckedColor` and `UncheckedColor` properties. The checked/indeterminate state color is updated to the `CheckedColor` property value when the state is changed to checked/indeterminate. The unchecked state color is updated to the `UncheckedColor` property value when the state is changed to unchecked.

{% tabs %}
{% highlight c# %}
SfCheckBox check = new SfCheckBox();
Expand All @@ -44,10 +45,10 @@ indeterminate.CheckedColor = UIColor.Purple;
{% endhighlight %}
{% endtabs %}

![CheckedColor and UncheckedColor in Checkbox](Images/StateColor.png)
![CheckedColor and UncheckedColor in CheckBox](Images/StateColor.png)

## BorderWidth
The tick box border thickness of the checkbox control can be customized with the `BorderWidth` property.
The tick box border thickness of the CheckBox control can be customized with the `BorderWidth` property.

{% tabs %}
{% highlight c# %}
Expand All @@ -69,14 +70,14 @@ check3.UncheckedColor = UIColor.Blue;
{% endhighlight %}
{% endtabs %}

![Checkbox BorderWidth](Images/BorderWidth.png)
![CheckBox BorderWidth](Images/BorderWidth.png)

## Setting caption text appearance
You can customize the display text appearance of the `SfCheckBox` control using the following properties:

* `SetTitleColor`: Changes the color of the text.
* `HorizontalAlignment`: Changes the horizontal alignment of the caption text.
* `Font`:Changes the font family of the text and sets font attributes(bold/italic/none) of the text and also sets font size of the caption text.
* `Font`: Changes the font family of the text and sets font attributes (bold/italic/none) of the text and also sets font size of the caption text.

{% tabs %}
{% highlight c# %}
Expand All @@ -92,6 +93,6 @@ caption.Font = UIFont.FromDescriptor(fontDescriptor.CreateWithTraits(UIFontDescr
{% endhighlight %}
{% endtabs %}

![Checkbox TextAppearance](Images/CaptionAppearance.png)
![CheckBox TextAppearance](Images/CaptionAppearance.png)

This demo can be downloaded from this [link](http://files2.syncfusion.com/Xamarin.iOS/Samples/CheckBox_VisualCustomization.zip ).
This demo can be downloaded from this [link](http://files2.syncfusion.com/Xamarin.iOS/Samples/CheckBox_VisualCustomization.zip).
32 changes: 16 additions & 16 deletions Xamarin-iOS/SfRangeSlider/Getting-Started.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,29 @@
---
layout: post
title: Getting started with Syncfusion® RangeSlider control for Xamarin.iOS
description: This section provides the details about initial users on Syncfusion® rangeSlider control for Xamarin.iOS platform
title: Getting Started with Syncfusion® RangeSlider control for Xamarin.iOS
description: This section provides details for initial users on Syncfusion® RangeSlider control for Xamarin.iOS platform
platform: xamarin.ios
control: RangeSlider
documentation: ug
---

# Getting Started with RangeSlider

This section explains you the steps to configure a RangeSlider  control in a real-time scenario and also provides a walk-through on some of the customization features available in RangeSlider control.
This section explains the steps to configure a RangeSlider control in a real-time scenario and also provides a walk-through on some of the customization features available in the RangeSlider control.

## Referencing Essential Studio<sup>®</sup> Components in Your Solution

After installing Essential Studio<sup>®</sup> for Xamarin, you can find all the required assemblies in the installation folders, typically:

{Syncfusion Installed location}\Essential Studio {version number}\lib

You have to add the following assembly reference to the iOS unified project
You have to add the following assembly reference to the iOS unified project:

iOS-unified\Syncfusion.SfRangeSlider.iOS.dll

### And and Configure the RangeSlider
## Add and Configure the RangeSlider

* Adding reference to RangeSlider.
### Adding Reference to RangeSlider

{% tabs %}

Expand All @@ -35,7 +35,7 @@ iOS-unified\Syncfusion.SfRangeSlider.iOS.dll

{% endtabs %}

* Create an instance of SfRangeSlider
### Create an Instance of SfRangeSlider

{% tabs %}

Expand All @@ -48,9 +48,9 @@ iOS-unified\Syncfusion.SfRangeSlider.iOS.dll

{% endtabs %}

### Add Values and Scale
## Add Values and Scale

You can set the minimum value for the slider by using the `setMinimum()` and `setMaximum()` properties in the RangeSlider. It can be Numerical values.
You can set the minimum and maximum values for the slider by using the `Minimum` and `Maximum` properties in the RangeSlider. These can be numerical values.

{% tabs %}

Expand All @@ -68,11 +68,11 @@ You can set the minimum value for the slider by using the `setMinimum()` and `se

{% endtabs %}

N> Likewise, `RangeStart` and `RangeEnd` can be set that denote the start range and end range values while dual thumb is used. The `ShowRange` property is used to switch between a single thumb and double thumb. The `Orientation` property sets the type of orientation.
> **Note:** The `RangeStart` and `RangeEnd` properties denote the start range and end range values when dual thumb is used. The `ShowRange` property is used to switch between a single thumb and double thumb. The `Orientation` property sets the type of orientation.

### Add Ticks and Labels for RangeSlider
## Add Ticks and Labels for RangeSlider

The ticks can be set by setting the `TickFrequency` and `TickPlacement`. Likewise, value labels can be set by setting the `ShowValueLabel` property to true. The position of label can be varied by the `LabelPlacement` property.
The ticks can be set by configuring the `TickFrequency` and `TickPlacement` properties. Likewise, value labels can be displayed by setting the `ShowValueLabel` property to `true`. The position of the label can be varied using the `ValuePlacement` property.

{% tabs %}

Expand All @@ -87,11 +87,11 @@ The ticks can be set by setting the `TickFrequency` and `TickPlacement`. Likewis

{% endtabs %}

N> The TickFrequency determines the interval between the ticks.
> **Note:** The `TickFrequency` property determines the interval between the ticks.

### Add Snapping Type for RangeSlider
## Add Snapping Type for RangeSlider

The movement of the thumb can be varied in different ways. This is achieved by setting the SnapsTo property.
The movement of the thumb can be configured in different ways. This is achieved by setting the `SnapsTo` property.

{% tabs %}

Expand All @@ -104,7 +104,7 @@ The movement of the thumb can be varied in different ways. This is achieved by s

{% endtabs %}

### Configure the properties for RangeSlider
## Configure the Properties for RangeSlider

{% tabs %}

Expand Down
Loading