MiscFramingView.rtf

This is MiscFramingView.rtf in view mode; [Download] [Up]

MiscFramingView

Inherits From: MiscTargetActionView : View : Responder : Object

Declared In: misckit/MiscFramingView.h

Class Description

The MiscFramingView is somewhat like a Box in that it suppies a frame around it's content view. The similarity pretty much stops there. It is more like a picture frame that automatically centers, justifies and resizes whatever content view it is given. A MiscFramingView can only have one subview, and that is the content view. This makes a MiscFramingView somewhat like a window except that it can sit inside of a window or another view. The content view itself may of course have as many subviews as desired.

The content view may be justified to any corner or to the center of the screen; it can be left at its original (actual) size; returned to the original size after scaling has been done; or scaled so that either the content views largest or smallest dimension exactly fits the view size.

Also note that since MiscFramingViews are a subclass of the MiscTargetActionView, they can be used in a target-action mode triggered by key strokes and mouse events (see MiscTargetActionView).

The following example shows how simple the MiscFramingView is to use. In most cases you won't even need to do any of the set methods. In this case, aView will be left at it's current size and will be justified to the upper left corner of the frame. Any space not covered by aView will show up in dark gray. A line boundary is then drawn around the frame.

[frameView setResizing: MISC_FV_NOFIT];
[frameview setOutline: MISC_FV_OUTLINE]; [frameview setBackgroundGray: NX_DKGRAY]; [frameview setJustification: MISC_FV_UL];

[frameView setContentView: aView];
[frameView display];

Instance Variables

float backgroundGray;
int justification;
int resizing;
int outline;
id contentView;
float outlineWidth;

backgroundGray Background greyscale value.
justification Type of justification in use.
resizing Type of resizing in use.
outline Type of outline in use .
contentView The content view of the MiscFramingView.
outlineWidth Width of lines in the outline, if applicable.

Method Types

Initialization - initFrame:
- free
Displaying - drawSelf::

Controlling the frame and content - setContentView:
- contentView
- backgroundGray
- setBackgroundGray:
- outline
- setOutline:
- justification;
- setJustification:
- resizing;
- setResizing:

Disabled View methods - addSubview:
- addSubview: :relativeTo:
- replaceSubview:with:

Modified View Methods - rotateTo:
- sizeTo:width :
- descendantFrameChanged:

Archiving - awake
- read:
- write:

Instance Methods

addSubview:
- addSubview:aView

The standard View class ability to add subviews is suppresed in the MiscFramingView. They have only one subview and that is set with the �setContentView: method. Returns self.

See also: - addSubview:relativeTo:, - setContentView:, - replaceSubview:with:

addSubview::relativeTo:
- addSubview:aView :(int)place relativeTo:otherView

The standard View class ability to add subviews is suppresed in the MiscFramingView. They have only one subview and that is set with the �setContentView: method. Returns self.

See also: - addSubview:, - setContentView:, - replaceSubview:with:

awake:
- awake

Executed when an object completes unarchiving. Returns self.