WP SET VIEW PROPERTIES

4D v20 R7


WP SET VIEW PROPERTIES ( {* ;} wpArea ; wpViewProps )

引数	型	説明
*	演算子	指定時: wpAreaはフォームオブジェクト名(文字列) 省略時: wpAreaはオブジェクトフィールドまたは変数(ドキュメント)
wpArea	文字, オブジェクト	フォームオブジェクト名(* 指定時)または4D Write Pro オブジェクト変数またはフィールド(* 省略時)
wpViewProps	オブジェクト	編集するビュープロパティ

説明

WP SET VIEW PROPERTIES コマンドを使用すると、wpArea 引数で指定した4D Write Pro エリアの、一つまたは複数のビュープロパティを動的に設定することができます。

任意の * 引数を渡した場合、wpArea 引数でフォームオブジェクト名(文字列)で指定します。省略時にはwpArea 引数で4D Write Pro ドキュメント(オブジェクト変数またはフィールド)を指定します。このコマンドはwpArea で指定したエリアがフォームオブジェクトまたはフォームページに割り当てられている(つまりフォーム内に表示されている)場合にのみ使用できます。4D Write Pro ドキュメントが複数のフォームオブジェクトに表示されている場合、どのビューを設定するのか定義するには * 引数を使用する必要があります。

wpViewProps 引数には、それぞれのプロパティが4D Write Pro エリア内で編集したいビュープロパティを格納しているオブジェクトを渡します。wpViewProps 引数に含まれていないビュープロパティは以前の値をそのまま保持します。以下の定数を使用することができます:

定数	値	コメント
wk display formula as symbol	displayFormulaAsSymbol	フォーミュラ参照を記号として表します。これはフォーミュラが参照として表示されている場合にのみ動作します(wk visible references 参照)。取り得る値: True/False
wk formula highlight	formulaHighlight	フォーミュラハイライトのビューモード。取りうる値: wk references (デフォルト): 参照として表示されているフォーミュラがハイライトされます wk values: 値として表示されているフォーミュラがハイライトされます wk always: 表示モードに関わらず、フォーミュラは常にハイライトされます wk never: 表示モードに関わらず、フォーミュラはハイライトされませんハイライトされるフォーミュラのカラーはwk formula highlight color で設定することができます。
wk formula highlight color	formulaHighlightColor	ハイライトされたフォーミュラのカラー(wk formula highlight 参照)。取りうる値: CSS カラー文字列("#010101" または "#FFFFFF" またh "red") 4D カラー倍長整数値
wk page view mode	pageMode	スクリーン上のフォームエリアに4D Write Pro ドキュメントを表示するモードです。取りうる値(文字列): "draft": 基本的なドキュメントプロパティだけの下書きモード "page": もっとも完全なビューモードで、ページのアウトライン、向き、マージン、改ページ、ヘッダー、フッターなどが表示されます。 "embedded": 埋め込みエリアに適したビューモード
wk resolution	dpi	4D Write Pro エリアのコンテンツの画面解像度。取りうる値: wk auto (0) 1より大きい数字
wk spell enable	spellEnabled	スペルチェックを有効化します。取りうる値:True/False
wk visible background and anchored elements	visibleBackground	背景画像/背景色、アンカーされた画像またはテキストボックス(ディスプレイ用では、ページビューモードまたは埋め込みビューモードでのみ表示されるエフェクト)を表示または書き出しをします。取り得る値: True/False
wk visible empty images	visibleEmptyImages	読み込めない、あるいは計算できない画像(空の画像またはサポートされていないフォーマットの画像)に対してデフォルトの黒い四角形を表示または書き出しします。取り得る値: True/False 値がFalse の場合、たとえ画像に境界線、幅、高さ、背景などが設定されてあっても空の画像要素は全く表示されないという点に注意して下さい。これはインライン画像のページレイアウトに影響する可能性があります。
wk visible footers	visibleFooters	フッターを表示または書き出しします(表示用においてはページビューモードでのみ表示されるエフェクトです)。取りうる値: True/False
wk visible headers	visibleHeaders	ヘッダーを表示または書き出しします(表示用においてはページビューモードでのみ表示されるエフェクトです)。取りうる値: True/False
wk visible hidden characters	visibleHiddenChars	非表示文字を表示します。取りうる値: True/False
wk visible horizontal ruler	visibleHorizontalRuler	垂直ルーラーを表示します。取りうる値: True/False
wk visible HTML WYSIWYG	htmlWYSIWIGEnabled	HTML WYSISYG ビューを有効化します。取りうる値: True/False
wk visible page frames	visiblePageFrames	ページフレームを表示します(ページビューモードでのみ表示されるエフェクトです)。取りうる値: True/False
wk visible references	visibleReferences	ドキュメントに挿入されている4D 式を参照として表示または書き出しします。取りうる値: True/False
wk visible table borders	visibleTableBorders	表組に境界線が定義されていない場合に、内部的/外部的な境界線を破線として表示します(表示用のプロパティのみ、破線の境界線は印刷も書き出しもされません)。取り得る値: True / False デフォルト値 = False
wk visible vertical ruler	visibleVerticalRuler	垂直ルーラーを表示します(ページビューモードでのみ表示されるエフェクトです)。取りうる値: True/False
wk zoom	zoom	4D Write Pro エリアのコンテンツを表示するズーム倍率。取りうる値: 1より大きい数値

どのプロパティもいつでも編集可能ですが、一部のプロパティはそれに対応している4D Write Pro 表示モードが使用されている時のみ考慮されます。そのため、ビュープロパティが変更されたとしても、カレントの表示モードでは視覚的には何も変化がない場合も有り得ます。

注: ビュープロパティについてのより詳細な情報については、4D Write Pro エリアを定義するのページを参照してください。

このコマンドを使用してwpArea 引数で指定したエリアに対してビュープロパティを設定した場合、フォームエリアが他の呼び出しで変更されない限りは指定したフォームエリアに適用され続けます。ただしプロパティの編集はドキュメントまたはフォームには保存されません。

例題

4D Write Pro エリアの一部のビュープロパティを設定したい場合を考えます:

 C_OBJECT($viewProps)

 $viewProps:=New object

 

 $viewProps[wk page view mode]:="page"

  // または $viewProps.pageMode="page"

 

 $viewProps[wk visible horizontal ruler]:=True

  // または $viewProps.visibleHorizontalRuler:=True

 

 $viewProps[wk visible vertical ruler]:=True

  // または $viewProps.visibleVerticalRuler:=True

 

 WP SET VIEW PROPERTIES(*;"4DWPArea";$viewProps)

参照

WP Get view properties