TextChangedEventArgs.Changes 속성

정의

발생한 변경 내용에 대한 정보가 들어 있는 개체의 컬렉션을 가져옵니다.

public:
 property System::Collections::Generic::ICollection<System::Windows::Controls::TextChange ^> ^ Changes { System::Collections::Generic::ICollection<System::Windows::Controls::TextChange ^> ^ get(); };
public System.Collections.Generic.ICollection<System.Windows.Controls.TextChange> Changes { get; }
member this.Changes : System.Collections.Generic.ICollection<System.Windows.Controls.TextChange>
Public ReadOnly Property Changes As ICollection(Of TextChange)

속성 값

발생한 변경 내용에 대한 정보가 들어 있는 개체의 컬렉션입니다.

설명

하나의 TextChange 컨트롤에 연속적인 각 변경 내용에 대 한 개체입니다. 한 번 중 둘 이상의 연속 된 변경이 발생할 수 있습니다는 TextChanged 변경 내용을 기본 문서 구조를 변경 해야 하는 경우에 이벤트입니다.

예를 들어 있다고 가정를 RichTextBox 문자열을 포함 "This is some text." 구조의 합니다 RichTextBox.Document<Paragraph><Run>This is some text.</Run></Paragraph>합니다. 하는 경우 사용자 굵게 표시 된 단어 "is some", 기본 구조의 FlowDocument 변경 <Paragraph><Run>This </Run><Run FontWeight="Bold">is some</Run><Run> text.</Run></Paragraph>합니다. 실제로 네 가지 변경 사항은 사용자의 작업의 결과로 발생 한 가지 있습니다.

  1. 합니다 <Run> 기호를 제거 했다가 다시 추가 이라는 단어 앞 This합니다.

  2. 기호 </Run><Run> 단어 뒤에 추가 됩니다 This합니다.

  3. 기호 </Run><Run> 단어 뒤에 추가 됩니다 some합니다.

  4. 합니다 </Run> 기호는 제거 되 고 단어 뒤에 다시 추가 Text합니다.

일반적으로 다음 항상 true가 됩니다.

  • 변경이 올바른 상태가 되 고 문서에서 발생 합니다.

  • 컨트롤에서 변경이 발생 하는 위치와 관련 된 컬렉션 연속적으로 정렬 되어 있습니다. 예를 들어를 TextChange 위치 2에서의 변경 내용을 나타내는 개체가 하기 전에 TextChange 10 위치의 변경 내용을 나타내는 개체입니다.

  • TextChange 개체 겹치는 영역을 나타내지 않습니다. 값 Offset 값을 더한 AddedLength 하나의 TextChange 개체는 항상 값 보다 작거나 Offset 다음의 TextChange 컬렉션의 개체입니다. 마찬가지로 값 Offset 값을 더한 RemovedLength 하나의 TextChange 개체는 항상 값 보다 작거나 Offset 다음의 TextChange 컬렉션의 개체입니다.

  • 컬렉션도 있는 경우 아무것도 변경 되지 발생 한 모든 변경 사항이 반영 합니다. 앞의 예제에서 첫 번째 또는 네 번째 변경 결과 아무것도 변경에서 각 제거 된 후 뿐 이므로 다시 추가 합니다 <Run></Run> 기호를 각각. 하지만 실제로 제거 되 고 추가 컬렉션에 포함 된 기호입니다.

경우는 TextChanged 속성 변경으로 인해 이벤트가 Changes 빈 컬렉션입니다. 앞의 예제에서 경우 사용자 굵게 표시 된 전체 문자열을를 FontWeight 의 속성을 Run 로 설정 된 Bold, 아무것도 추가 되거나 따라서 문서에서 제거 되지만 Changes 비어.

Changes .NET Framework 버전 3.5에서에서 도입 되었습니다. 자세한 내용은 버전 및 종속성을 참조하세요.

적용 대상