TextBoxBase.SelectionLength 속성
텍스트 상자에서 선택한 문자 수를 가져오거나 설정합니다.
네임스페이스: System.Windows.Forms
어셈블리: System.Windows.Forms(system.windows.forms.dll)
구문
‘선언
Public Overridable Property SelectionLength As Integer
‘사용 방법
Dim instance As TextBoxBase
Dim value As Integer
value = instance.SelectionLength
instance.SelectionLength = value
public virtual int SelectionLength { get; set; }
public:
virtual property int SelectionLength {
int get ();
void set (int value);
}
/** @property */
public int get_SelectionLength ()
/** @property */
public void set_SelectionLength (int value)
public function get SelectionLength () : int
public function set SelectionLength (value : int)
속성 값
텍스트 상자에서 선택한 문자 수입니다.
예외
| 예외 형식 | 조건 |
|---|---|
할당된 값이 0보다 작은 경우 |
설명
이 속성을 사용하면 선택한 텍스트에 대해 동작을 수행하기 전에 TextBox 컨트롤에서 문자가 선택되어 있는지 여부를 확인할 수 있습니다. SelectionLength 속성 값이 컨트롤의 텍스트 내에 있는 문자 수보다 큰 값으로 설정되면 SelectionLength 속성 값은 컨트롤 내의 전체 텍스트 길이에서 SelectionStart 속성 값을 뺀 값으로 설정됩니다(SelectionStart 속성에 값이 지정되어 있는 경우).
참고
SelectionStart를 캐럿을 이동하려는 텍스트 상자 내의 위치로 설정하고 SelectionLength 속성을 0 값으로 설정하여 텍스트 상자 내에서 캐럿을 프로그래밍 방식으로 이동할 수 있습니다. 캐럿을 이동하기 위해서는 텍스트 상자에 포커스가 있어야 합니다.
예제
다음 코드 예제에서는 파생 클래스인 TextBox를 사용합니다. 이 클래스에서는 잘라내기, 복사, 붙여넣기 및 실행 취소 작업을 수행하는 MenuItem 개체의 Click 이벤트 처리기가 제공됩니다. 이 예제를 실행하려면 textBox1이라는 TextBox 컨트롤을 만들어야 합니다.
Private Sub Menu_Copy(sender As System.Object, e As System.EventArgs)
' Ensure that text is selected in the text box.
If textBox1.SelectionLength > 0 Then
' Copy the selected text to the Clipboard.
textBox1.Copy()
End If
End Sub
Private Sub Menu_Cut(sender As System.Object, e As System.EventArgs)
' Ensure that text is currently selected in the text box.
If textBox1.SelectedText <> "" Then
' Cut the selected text in the control and paste it into the Clipboard.
textBox1.Cut()
End If
End Sub
Private Sub Menu_Paste(sender As System.Object, e As System.EventArgs)
' Determine if there is any text in the Clipboard to paste into the text box.
If Clipboard.GetDataObject().GetDataPresent(DataFormats.Text) = True Then
' Determine if any text is selected in the text box.
If textBox1.SelectionLength > 0 Then
' Ask user if they want to paste over currently selected text.
If MessageBox.Show("Do you want to paste over current selection?", _
"Cut Example", MessageBoxButtons.YesNo) = DialogResult.No Then
' Move selection to the point after the current selection and paste.
textBox1.SelectionStart = textBox1.SelectionStart + _
textBox1.SelectionLength
End If
End If
' Paste current text in Clipboard into text box.
textBox1.Paste()
End If
End Sub
Private Sub Menu_Undo(sender As System.Object, e As System.EventArgs)
' Determine if last operation can be undone in text box.
If textBox1.CanUndo = True Then
' Undo the last operation.
textBox1.Undo()
' Clear the undo buffer to prevent last action from being redone.
textBox1.ClearUndo()
End If
End Sub
private void Menu_Copy(System.Object sender, System.EventArgs e)
{
// Ensure that text is selected in the text box.
if(textBox1.SelectionLength > 0)
// Copy the selected text to the Clipboard.
textBox1.Copy();
}
private void Menu_Cut(System.Object sender, System.EventArgs e)
{
// Ensure that text is currently selected in the text box.
if(textBox1.SelectedText != "")
// Cut the selected text in the control and paste it into the Clipboard.
textBox1.Cut();
}
private void Menu_Paste(System.Object sender, System.EventArgs e)
{
// Determine if there is any text in the Clipboard to paste into the text box.
if(Clipboard.GetDataObject().GetDataPresent(DataFormats.Text) == true)
{
// Determine if any text is selected in the text box.
if(textBox1.SelectionLength > 0)
{
// Ask user if they want to paste over currently selected text.
if(MessageBox.Show("Do you want to paste over current selection?", "Cut Example", MessageBoxButtons.YesNo) == DialogResult.No)
// Move selection to the point after the current selection and paste.
textBox1.SelectionStart = textBox1.SelectionStart + textBox1.SelectionLength;
}
// Paste current text in Clipboard into text box.
textBox1.Paste();
}
}
private void Menu_Undo(System.Object sender, System.EventArgs e)
{
// Determine if last operation can be undone in text box.
if(textBox1.CanUndo == true)
{
// Undo the last operation.
textBox1.Undo();
// Clear the undo buffer to prevent last action from being redone.
textBox1.ClearUndo();
}
}
private:
void Menu_Copy( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Ensure that text is selected in the text box.
if ( textBox1->SelectionLength > 0 )
{
// Copy the selected text to the Clipboard.
textBox1->Copy();
}
}
void Menu_Cut( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Ensure that text is currently selected in the text box.
if ( !textBox1->SelectedText->Equals( "" ) )
{
// Cut the selected text in the control and paste it into the Clipboard.
textBox1->Cut();
}
}
void Menu_Paste( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Determine if there is any text in the Clipboard to paste into the text box.
if ( Clipboard::GetDataObject()->GetDataPresent( DataFormats::Text ) == true )
{
// Determine if any text is selected in the text box.
if ( textBox1->SelectionLength > 0 )
{
// Ask user if they want to paste over currently selected text.
if ( MessageBox::Show( "Do you want to paste over current selection?",
"Cut Example", MessageBoxButtons::YesNo ) == ::DialogResult::No )
{
// Move selection to the point after the current selection and paste.
textBox1->SelectionStart = textBox1->SelectionStart + textBox1->SelectionLength;
}
}
// Paste current text in Clipboard into text box.
textBox1->Paste();
}
}
void Menu_Undo( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Determine if last operation can be undone in text box.
if ( textBox1->CanUndo == true )
{
// Undo the last operation.
textBox1->Undo();
// Clear the undo buffer to prevent last action from being redone.
textBox1->ClearUndo();
}
}
private void Menu_Copy(Object sender, System.EventArgs e)
{
// Ensure that text is selected in the text box.
if (textBox1.get_SelectionLength() > 0) {
// Copy the selected text to the Clipboard.
textBox1.Copy();
}
} //Menu_Copy
private void Menu_Cut(Object sender, System.EventArgs e)
{
// Ensure that text is currently selected in the text box.
if (!(textBox1.get_SelectedText().Equals(""))) {
// Cut the selected text in the control and paste it
//into the Clipboard.
textBox1.Cut();
}
} //Menu_Cut
private void Menu_Paste(Object sender, System.EventArgs e)
{
// Determine if there is any text in the Clipboard to paste
// into the text box.
if(Clipboard.GetDataObject().GetDataPresent(DataFormats.Text) == true) {
// Determine if any text is selected in the text box.
if (textBox1.get_SelectionLength() > 0) {
// Ask user if they want to paste over currently selected text.
if (MessageBox.Show("Do you want to paste over current"
+ "selection?","Cut Example",
MessageBoxButtons.YesNo).Equals(get_DialogResult().No)) {
// Move selection to the point after the current
// selection and paste.
textBox1.set_SelectionStart(textBox1.get_SelectionStart()
+ textBox1.get_SelectionLength());
}
}
// Paste current text in Clipboard into text box.
textBox1.Paste();
}
} //Menu_Paste
private void Menu_Undo(Object sender, System.EventArgs e)
{
// Determine if last operation can be undone in text box.
if (textBox1.get_CanUndo() == true) {
// Undo the last operation.
textBox1.Undo();
// Clear the undo buffer to prevent last action from being redone.
textBox1.ClearUndo();
}
} //Menu_Undo
플랫폼
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.
버전 정보
.NET Framework
2.0, 1.1, 1.0에서 지원
.NET Compact Framework
2.0, 1.0에서 지원
참고 항목
참조
TextBoxBase 클래스
TextBoxBase 멤버
System.Windows.Forms 네임스페이스
SelectionStart
TextBoxBase.SelectedText 속성