RichTextBox.ZoomFactor プロパティ

.NET Framework クラス ライブラリ リファレンス

RichTextBox.ZoomFactor プロパティ

RichTextBox の現在のズーム レベルを取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Property ZoomFactor As
 Single

Visual Basic (使用法)

Dim instance As RichTextBox
Dim value As Single

value = instance.ZoomFactor

instance.ZoomFactor = value

C#

[LocalizableAttribute(true)] 
public float ZoomFactor { get;
 set; }

C++

[LocalizableAttribute(true)] 
public:
property float ZoomFactor {
    float get ();
    void set (float value);
}

J#

/** @property */
public float get_ZoomFactor ()

/** @property */
public void set_ZoomFactor (float
 value)

JScript

public function get ZoomFactor
 () : float

public function set ZoomFactor
 (value : float)

プロパティ値
コントロールの内容をズームする倍率。

例外

例外の種類	条件
ArgumentException	指定したズームの倍率が許容範囲外でした。

解説

このプロパティの有効値は、1/64 から 64.0 までの範囲の値です。値 1.0 は、コントロールにズームを適用しないことを示します。このズーム機能は、ドキュメントで TrueType フォントが使用されている場合に最適に動作します。コントロールのドキュメント内で TrueType 以外のフォントが使用されている場合、ZoomFactor プロパティは、近似整数値を使用します。このプロパティを使用すると、ユーザーが RichTextBox コントロールのドキュメント内で小さくて読みにくい部分を拡大したり、より多くのドキュメントを画面上に表示するためにビューを縮小できるようになります。

使用例

テキストが拡大表示され、コントロールのテキスト内の単語がダブルクリックされたときに単語が自動的に選択され、コントロールのクライアント領域の右側に余白がある RichTextBox を作成する方法を次のコード例に示します。RichTextBox コントロールの幅が小さい場合にこのコードを使用すると、テキストが見かけ上 1 行に 1 文字だけ表示される RichTextBox が作成されます。この垂直表示位置の場合、単語の任意の部分をクリックすると、テキストが縦書きで表示されていることにかかわらず、単語のすべての文字が選択されます。この例では、richTextBox1 という名前の RichTextBox コントロールがフォームに配置されている必要があります。

Visual Basic

Private Sub ZoomMyRichTextBox()
    ' Enable users to select entire word when double clicked.
    richTextBox1.AutoWordSelection = True
    ' Clear contents of control.
    richTextBox1.Clear()
    ' Set the right margin to restrict horizontal text.
    richTextBox1.RightMargin = 2
    ' Set the text for the control.
    richTextBox1.SelectedText = "Alpha Bravo Charlie Delta Echo
 Foxtrot"
    ' Zoom by 2 points.
    richTextBox1.ZoomFactor = 2.0F
End Sub

C#

private void ZoomMyRichTextBox()
{
    // Enable users to select entire word when double clicked.
    richTextBox1.AutoWordSelection = true;
    // Clear contents of control.
    richTextBox1.Clear();
    // Set the right margin to restrict horizontal text.
    richTextBox1.RightMargin = 2;
    // Set the text for the control.
    richTextBox1.SelectedText = "Alpha Bravo Charlie Delta Echo Foxtrot";
    // Zoom by 2 points.
    richTextBox1.ZoomFactor = 2.0f;
}

C++

private:
   void ZoomMyRichTextBox()
   {
      // Enable users to select entire word when double clicked.
      richTextBox1->AutoWordSelection = true;

      // Clear contents of control.
      richTextBox1->Clear();

      // Set the right margin to restrict horizontal text.
      richTextBox1->RightMargin = 2;

      // Set the text for the control.
      richTextBox1->SelectedText = "Alpha Bravo Charlie Delta Echo Foxtrot";

      // Zoom by 2 points.
      richTextBox1->ZoomFactor = 2.0f;
   }

J#

private void ZoomMyRichTextBox()
{
    // Enable users to select entire word when double clicked.
    richTextBox1.set_AutoWordSelection(true);
    // Clear contents of control.
    richTextBox1.Clear();
    // Set the right margin to restrict horizontal text.
    richTextBox1.set_RightMargin(2);
    // Set the text for the control.
    richTextBox1.set_SelectedText("Alpha Bravo Charlie Delta Echo Foxtrot");
    // Zoom by 2 points.
    richTextBox1.set_ZoomFactor(2);
} //ZoomMyRichTextBox

プラットフォーム

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

参照

関連項目
RichTextBox クラス
RichTextBox メンバ
System.Windows.Forms 名前空間