C# 클래스 XMLViewsTests.MockEnv

This is similar to AddProp, but used where it is necessary to follow a path of properties to get to the desired object/property. The first tag in prgtag indicates an atomic object property of the current open object, the next an atomic object property of the one obtained from the first property, and so on until the last indicates the property that is represented by the string. This last tag (and the corresponding object) is what gets passed to UpdateProp(). If any of the attrs along the path is null, nothing gets added. DisplayVariant is used to display the property (which must be basic).

Note

The view looks up the value of the indicated property on the current open object and displays it as a decimal string. The property must be an integer property.

The view looks up the value of the indicated property in the current open object and passes it to the view constructor's DisplayPicture method. If nMax is greater than nMin, automatic cycling is performed: clicking on one of the picutes will not make a selection, but will merely increment the specified property (and rotate from nMax to nMin).

Display a list of items using laziness. Typically, this is used to implement DisplayVec, either of the complete property contents, or a filtered subset. Nothing is added to the display immediately, but at some point the views code will call the IVwViewConstructor.EstimateHeight method to find out how high one or more items are. At that time or later, it may call your IVwViewConstructor.LoadData method, followed by the IVwViewConstructor.Display method, for one or more items in the list, as needed. Note: this method has not been tested and I suspect the implementation is incomplete.

Display a vector property using laziness. Nothing is added to the display immediately, but at some point the views code will call the IVwViewConstructor.EstimateHeight method to find out how high one or more items are. At that time or later, it may call your IVwViewConstructor.LoadData method, followed by the IVwViewConstructor.Display method, for one or more items in the property, as needed. Note: the current flow object MUST be a Div (or the root).

Display another object, not one of your own properties. Calls IVwViewConstructor.Display, passing the HVO and frag specified here, on the view constructor specified here. Consider using NoteDependency if this part of the display should change when certain propertiese.g., those you used to find the objectchange.

Display an (atomic) object prop. Calls IVwViewConstructor.Display for the object that is the value of the (atomic) object property. Passes 0 as the HVO of the Display method if the property is empty.

Display a vector property. Calls IVwViewConstructor.DisplayVec, passing the current HVO, the tag specified here, and the frag specied here, to the view constructor specified here.

Display a vector property. Calls IVwViewConstructor.Display for each item in the vector, passing the HVO of each item (obtained by passing the HVO and tag to ISilDataAccess.get_VecItem) and the frag specied here, to the view constructor specified here (usually the caller of the method).

Insert a picture, optionally limiting the height and width. Mark it as if it came from the property tag, though we don't actually read data from there (the caller can pass any value that might be useful later to identify something about the picture the user clicked). If the tag argument is not useful, pass ktagNotAnAttr. It is planned that a positive dxmpHeight is a maximum height, negative is an exact height, and 0 means don't specify height (use natural height or determine from width and aspect ratio). Similarly for width. Currently only max height is implemented. Always pass zero for width.

Insert a picture along with the specified ws alternative of the caption. Mark it as if it came from the property tag, though we don't actually read data from there (the caller can pass any value that might be useful later to identify something about the picture the user clicked). If the tag argument is not useful, pass ktagNotAnAttr. It is planned that a positive dxmpHeight is a maximum height, negative is an exact height, and 0 means don't specify height (use natural height or determine from width and aspect ratio). Similarly for width. Currently only max height is implemented. Always pass zero for width.

:> Generic basic property displays, managed by the VC. Display a property, with the client handling the process of formatting it as a string. (Calls IVwViewConstructor.DisplayVariant, and the resulting string is inserted into the display.) If the user edits the data, then when focus leaves the display of the property, the system calls its IViewConstructor.UpdateProp method. That method is responsible to make an appropriate change to the underlying data, or veto it with an appropriate error message. The variant is obtained by calling ISilDataAccess.get_Prop. Current implementations of ISilDataAcess can only provide variants for 4byte and 8byte integers and simple string (ITsString, nonalternation) properties. This could fairly easily be extended if needed. This may eventually also be used for string alts. The Alternation object will get passed as an IUnknown variant. If pvwvc is not prepared to receive an UpdateProp call when the string is edited, be sure to disable editing of this property.

Display a vector property in reverse order. Calls IVwViewConstructor.Display for each item in the vector, passing the HVO of each item (obtained by passing the HVO and tag to ISilDataAccess.get_VecItem) and the frag specied here, to the view constructor specified here (usually the caller of the method).

Add the special little grey box used to separate items in Data Entry lists.

Insert a simple rectangular box with the specified color, height, and width.

Add literal text that is not a property and not editable.

Add all the alternatives present in the indicated property of the current object, in a default format labelled by writing system tag markers. If the current flow object is a paragraph, the items are separated with a space. If the current flow object is a pile (Div or InnerPile), each alternative (with identifying tag) is a row. ENHANCE JohnT: what controls the order of the encodings? As found? Alphabetical by enc? Numeric by enc? Need to resolve this before implementing.

Note

:> ENHANCE JohnT: we should have individual methods and default formats :> for more of the basic types. :> String alternations. Add a single, isolated alternative (of the indicated property of the open object).

Display the indicated multialternative string property of the current object, showing the alternaties specified by the given list of encodings, with ws tags. An ws appears (as an empty string) even if the corresponding alternative is absent. If the current flow object is a paragraph, the items are separated with a space. If the current flow object is a pile (Div or InnerPile), each alternative (with identifying tag) is a row.

Note

:> Inserting basic object property displays into the view. The view looks up the value of the indicated property on the current open object and displays it. The property must be a (non alternation) string property.

Add an SilTime property, formatted according to the default user locale. The flags argument is currently interpreted as by ::GetDateFormat, but we may decide to restrict the full range of these options to achieve easier portability. Passing DATE_SHORTDATE is safe.

Add a Unicode string property, as if it were a string in the specified WS.

Add a display region whose contents are controlled by the client, which must implement IVwEmbeddedWindow. The mechanism is designed to allow either an embedded window (which gets moves as the view is laid out) or just a region of the larger window which the client draws into. ENHANCE JohnT: can this be implemented reliably? What if the root box is displayed in two places, so we can't just move the embedded Window? (Could we say that it appears in the primary split? Which one is primary?)

End a group of paragraphs sharing properties.

End a pile of paras embedded in another para, for interlinear.

End a paragraph (of any type).

End a group of subpara objects sharing properties

End a table.

End a body section of a table.

End a cell in a table.

End the footer section of a table.

End the header section of a table.

End a header cell in a table.

End a row in a table.

Get the object currently being displayed. (This is the object whose properties will be used by the various Add methods.) Compare OpenObject.

Called while a paragraph is open, this controls how the view will behave if no content is added to the paragraph before it is closed. Currently the argument must be 1; the only reason to have the argument at all is in the interests of forward compatibility if we think of more behaviors. The default behavior is that the paragraph behaves as if it contained a readonly empty string. The behavior when this method is called (with argument 1) is to make the empty paragraph as nearly as possible invisible.

Get info about outer objects, inside whose display the display of the current object is embedded. The outermost object is returned at level 0. Whatever property of that object the next object is embedded in is returned in ptag. The index of the nextlevel object in that property (if it is a vector property) is returned in pihvo; if not a vector property, that value is always zero. The Level argument may range from 0 to EmbeddingLevel() 1. Level 0 is one of the toplevel objects passed to SetRootObjects.

Current flow object is a paragraph. (But being in a span it will still be true.)

This is like MakeColumns, except that a "group" of columns ends after the last one whose width is specified using this method. Groups are significant for some options regarding drawing rules between cells; see the vwrule parameter of OpenTable.

Specify the width of columns in a table. Should be called after OpenTable and before OpenTableBody or OpenTableHeader. Each call sets the width of a specified number of columns. This should be called enough times (in combination with MakeColumnGroup) to account for all the columns in the table.

Inform the view of special dependencies. The current flow object (and anything else that is part of the same object in the same higher level property) needs to be regenerated if any of the listed properties changes.

Inform the view of special dependencies. The current flow object (and anything else that is part of the same object in the same higher level property) needs to be regenerated if there is a change (from the time where this method is called) in whether it is true that ptssVal is equal to the specified property. It is a multilingual string property if ws is nonzero, otherwise a plain string. Note that this can be VERY much more efficient than using NoteDependency for such conditions, which will regenerate every time the property changes.

Start a paragraph that is intended to be a line in a concordance display. A key word is identified, typically the item being concorded on, and its position is indicated. Typically, the keyword is bold, and gets aligned with a specified position, dmpAlign. Alignment will be left, center, or right, according to the alignment of the paragraph as a whole. (Nonleft alignment is not yet implemented.)

:> Delimit layout flow objects Start a group of paragraphs sharing properties.

Start a pile of paras embedded in another para, for interlinear.

Start a paragraph that supports certain kinds of onethefly text substitution. Currently the only type supported is an embedded object character with text property ktptObjData's first character set to kodtNameGuidHot. The system finds a name for the specified object using IVwViewConstructor.GetStrForGuid, and displays that.

Start a paragraph that supports both tagging and mapping.

Start a paragraph that supports overrides

Start a normal paragraph.

Start a group of subpara objects sharing properties

:> ENHANCE JohnT: VwLength is used only in three places now. Would it be better to :> just have an int plus a FwTextPropVar? Start a table.

Start a body section of a table. There may be multiple body sections; each defines a "group" of rows. (Groups are significant for some options regarding drawing rules between cells; see the vwrule parameter of OpenTable).

Start a cell in a table.

Start the footer section of a table. Note that this is specified before the body, so that (eventually) we can repeat it at the bottom of each page in a long table, which requires us to know what it is even before we have all the information about the body.

Start the header section of a table. This is like a body section except that (eventually) in a long printout it will be repeated at the start of each new page.

Start a header cell in a table. Params as in OpenCell.

Start a row in a table.

Start a paragraph that supports display of tagging, if an overlay is installed in the root box.

Setting a Unicode character that indicates a boundary (e.g. for a paragraph or section).

:> More informative routines to help with fancy layouts. Gives the height and width required to lay out the given string, using current display properties plus those produced by pttp (which may be null). In other words, this is the amount of space that would be occupied if one currently called putref_Props(pttp); AddString(ptss); (assuming infinite available width). EberhardB: This used to be [propget] and named without get_. However, this results in a TLBIMP warning because we don't specify a [retval], so I renamed it.

Specify an integer style property to be applied to the next flow object opened. Ignored if a close flow object operation precedes the next open. Adding anything basic (such as a string or int object property, string literal, string alternation, or string generated using AddProp/DisplayVariant) means the property applies as if to a span containing just that text.

Specify a string style property to be applied to the next flow object opened. Ignored if a close flow object operation precedes the next open. Adding anything basic (such as a string or int object property, string literal, string alternation, or string generated using AddProp/DisplayVariant) means the property applies as if to a span containing just that text.