PenInputPanel.Refresh 메서드
업데이트: 2007년 11월
사용되지 않습니다. Tablet PC 입력 패널을 기준으로 PenInputPanel 속성을 업데이트 및 복원하고, 펜 입력 패널을 자동으로 배치하고, 사용자 인터페이스를 기본 패널로 설정합니다. PenInputPanel은 Microsoft.Ink.TextInput으로 대체되었습니다.
네임스페이스: Microsoft.Ink
어셈블리: Microsoft.Ink(Microsoft.Ink.dll)
구문
‘선언
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted := True)> _
Public Sub Refresh
‘사용 방법
Dim instance As PenInputPanel
instance.Refresh()
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true)]
public void Refresh()
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction::Demand, Unrestricted = true)]
public:
void Refresh()
/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
/** @attribute SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true) */
public void Refresh()
public function Refresh()
설명
Refresh 메서드는 기본 패널을 복원합니다. 예를 들어 DefaultPanel 속성이 Keyboard로 설정되고 CurrentPanel 속성이 Handwriting으로 설정되면 Refresh 메서드는 펜 입력 패널을 Keyboard로 설정합니다. DefaultPanel 속성이 Default로 설정되면 Refresh 메서드는 펜 입력 패널을 변경하지 않습니다.
Refresh 메서드는 자신이 연결된 컨트롤을 기준으로 펜 입력 패널을 자동으로 배치합니다.
Refresh 메서드는 Tablet PC 입력 패널 설정을 사용하여 펜 입력 패널을 업데이트합니다. 예를 들어 PenInputPanel 개체를 변경한 다음 Refresh를 호출하여 설정을 입력 패널에서 복사한 설정으로 복원할 수 있습니다.
PenInputPanel 개체는 입력 패널에서 설정이 변경될 때마다 자동으로 업데이트됩니다.
펜 입력 패널에 포커스가 없을 때 Refresh 메서드를 호출하면 오류가 생성됩니다.
참고
일반적으로는 Refresh를 호출하지 않아도 됩니다. 해당 기능은 펜 입력 패널 활성화 중에 표시되기 때문입니다. 그러나 AutoShow 속성이 false로 설정되는 경우에는 펜 입력 패널 활성화를 해제할 수 있습니다. 이 경우에는 Refresh 메서드를 사용하여 PenInputPanel 개체를 새로 고칩니다.
참고
Microsoft® Windows® XP Tablet PC Edition 2005부터 Refresh 메서드는 더 이상 사용되지 않으며 아무런 작업도 수행하지 않습니다.
.gif "보안 정보") 보안 정보: |
|---|
부분 신뢰 환경에서 사용하는 경우 이 메서드에 SecurityPermissionFlag.AllFlags 권한 및 PenInputPanel에서 요구하는 권한이 필요합니다. 자세한 내용은 Security and Trust를 참조하십시오. |
예제
이 C# 예제에서는 PenInputPanel 개체인 thePenInputPanel을 InkEdit 컨트롤인 theInkEdit에 연결합니다. 그런 다음 VisibleChanged 이벤트 처리기인 VisibleChanged_Event를 PenInputPanel의 폼에 추가합니다. 이벤트 처리기에서 PenInputPanel 개체가 표시된 경우 Refresh 메서드를 호출하여 해당 설정을 입력 패널의 설정으로 복원합니다.
[C#]
//...
// Delcare the PenInputPanel object
PenInputPanel thePenInputPanel;
public Form1()
{
// Required for Windows Form Designer support
InitializeComponent();
// Create and attach the new PenInputPanel to an InkEdit control.
thePenInputPanel = new PenInputPanel(theInkEdit);
// Add a PenInputPanelVisibleChanged event handler
thePenInputPanel.VisibleChanged +=
new PenInputPanelVisibleChangedEventHandler(VisibleChanged_Event);
}
//...
public void VisibleChanged_Event(object sender,
PenInputPanelVisibleChangedEventArgs e)
{
// Make sure the object that generated
// the event is a PenInputPanel object
if (sender is PenInputPanel)
{
PenInputPanel theSenderPanel = (PenInputPanel)sender;
// If the panel has become visible...
if (e.NewVisibility)
{
// Restore the pen input panel settings
// from the global Input Panel
theSenderPanel.Refresh();
}
}
}
이 Microsoft Visual Basic .NET 예제에서는 PenInputPanel 개체인 thePenInputPanel을 InkEdit 컨트롤인 theInkEdit에 연결합니다. 그런 다음 VisibleChanged 이벤트 처리기인 VisibleChanged_Event를 PenInputPanel의 폼에 추가합니다. 이벤트 처리기에서 PenInputPanel 개체가 표시된 경우 Refresh 메서드를 호출하여 해당 설정을 입력 패널의 설정으로 복원합니다.
[Visual Basic]
'...
' Declare the PenInputPanel object
Dim thePenInputPanel As PenInputPanel
Public Sub New()
MyBase.New()
'This call is required by the Windows Form Designer.
InitializeComponent()
' Create and attach the new PenInputPanel to an InkEdit control.
thePenInputPanel = New PenInputPanel(theInkEdit)
' Add a PenInputPanelVisibleChanged event handler
AddHandler thePenInputPanel.VisibleChanged, _
AddressOf VisibleChanged_Event
End Sub 'New
'...
Public Sub VisibleChanged_Event(sender As Object, e As _
PenInputPanelVisibleChangedEventArgs)
' Make sure the object that generated
' the event is a PenInputPanel object
If TypeOf sender Is PenInputPanel Then
Dim theSenderPanel As PenInputPanel = CType(sender, PenInputPanel)
' If the panel has become visible...
If e.NewVisibility Then
' Restore the pen input panel settings
' from the global Input Panel
theSenderPanel.Refresh()
End If
End If
End Sub 'VisibleChanged_Event
플랫폼
Windows Vista
.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.
버전 정보
.NET Framework
3.0에서 지원